{"id":19370575,"url":"https://github.com/evidence-dev/sf311","last_synced_at":"2025-04-23T15:32:33.545Z","repository":{"id":259325336,"uuid":"861891806","full_name":"evidence-dev/sf311","owner":"evidence-dev","description":"Workshop for Small Data SF - build an interactive data app using SF 311 data","archived":false,"fork":false,"pushed_at":"2024-11-07T19:29:57.000Z","size":3857,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T17:11:18.222Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://sf311.evidence.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evidence-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-23T17:22:55.000Z","updated_at":"2024-12-07T13:06:45.000Z","dependencies_parsed_at":"2024-10-24T12:19:46.835Z","dependency_job_id":"7a4e9fde-a507-4bb2-adb7-6b546df5153c","html_url":"https://github.com/evidence-dev/sf311","commit_stats":null,"previous_names":["evidence-dev/sf311"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evidence-dev%2Fsf311","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evidence-dev%2Fsf311/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evidence-dev%2Fsf311/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evidence-dev%2Fsf311/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evidence-dev","download_url":"https://codeload.github.com/evidence-dev/sf311/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250460657,"owners_count":21434271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T08:16:00.201Z","updated_at":"2025-04-23T15:32:32.759Z","avatar_url":"https://github.com/evidence-dev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SF 311 Data App Template\n\n**This is the finished project. Please go to https://github.com/evidence-dev/sf311_starter to get the starter template.**\n\nThis is a template repo for building an interactive data app with [Evidence](https://evidence.dev) using SF 311 data. This project is part of a workshop at [Small Data SF 2024](https://www.smalldatasf.com/2024/).\n\nPlease read this full readme before starting.\n\n## Getting Started\n\nWe recommend using VS Code and installing the Evidence extension.\n\nYou can get started by clicking the \"Use this template\" button at the top right of the page and creating a new repository. **Make sure you check the box to include all branches.**\n\nYou will see some banners in Github prompting you to open a PR for the other branches - ignore these.\n\nOnce you have the repo cloned locally, check out the `pages/index.md` file for instructions on what to build next.\n\n## Template Contents\n\nThis template repo includes a DuckDB dataset containing 100k SF 311 records, as well as all required connection setup in Evidence. You don't need to do anything to connect the data source to the Evidence project.\n\n## Important Note: geoJSON File\n\nWe have hosted a geoJSON file for mapping SF neighborhoods. You will need the URL for this file when creating an AreaMap:\nhttps://evd-geojson.b-cdn.net/sf_hoods.geojson\n\n## Sections\n\nWe've broken up the proejct into 6 sections:\n\n1. Build a basic summary page\n2. Build a simple categories page\n3. Add interactivity to your summary page\n4. Build a neighborhood explorer page\n5. Create neighborhood templated page\n6. Dynamic content generation - volume spikes\n\nAt the end of the project, you'll have a fast, fully interactive data app that looks great on desktop, laptop, or mobile devices.\n\n## Branches\n\nYou should get started on the `main` branch of this repo.\n\nWe have created progress branches - one branch per section - which include the completed content for that section. \n\nAt any time if you get stuck and need to jump ahead to catch up, you can check out one of those branches. Branches are named `section-1` through `section-6`.\n\nYou will need to either commit or discard your changes when switching branches, and then can switch like so:\n\n```\ngit checkout section-1\n```\n\n## Resources\n\n- Docs: https://docs.evidence.dev\n- Finished Project Repo: https://github.com/hughess/sf311\n- Deployed Finished Project: https://sf311.evidence.app/\n\n## Using Codespaces\n\nIf you are using this template in Codespaces, click the `Start Evidence` button in the bottom status bar. This will install dependencies and open a preview of your project in your browser - you should get a popup prompting you to open in browser.\n\nOr you can use the following commands to get started:\n\n```bash\nnpm install\nnpm run sources\nnpm run dev -- --host 0.0.0.0\n```\n\nSee [the CLI docs](https://docs.evidence.dev/cli/) for more command information.\n\n**Note:** Codespaces is much faster on the Desktop app. After the Codespace has booted, select the hamburger menu → Open in VS Code Desktop.\n\n\n## Learning More\n\n- [Docs](https://docs.evidence.dev/)\n- [Github](https://github.com/evidence-dev/evidence)\n- [Slack Community](https://slack.evidence.dev/)\n- [Evidence Home Page](https://www.evidence.dev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevidence-dev%2Fsf311","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevidence-dev%2Fsf311","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevidence-dev%2Fsf311/lists"}