{"id":16315897,"url":"https://github.com/sid-kap/housing-data","last_synced_at":"2025-08-24T08:21:42.338Z","repository":{"id":39069649,"uuid":"315832194","full_name":"sid-kap/housing-data","owner":"sid-kap","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-10T03:09:29.000Z","size":2376,"stargazers_count":16,"open_issues_count":4,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-04-10T04:56:00.219Z","etag":null,"topics":["apartments","census","construction","housing","yimby"],"latest_commit_sha":null,"homepage":"http://housingdata.app","language":"Python","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/sid-kap.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}},"created_at":"2020-11-25T04:51:25.000Z","updated_at":"2024-04-15T03:59:55.885Z","dependencies_parsed_at":"2024-02-12T02:37:36.460Z","dependency_job_id":"7a12849a-774a-4171-a1df-ef844e5a9ba2","html_url":"https://github.com/sid-kap/housing-data","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sid-kap%2Fhousing-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sid-kap%2Fhousing-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sid-kap%2Fhousing-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sid-kap%2Fhousing-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sid-kap","download_url":"https://codeload.github.com/sid-kap/housing-data/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245022506,"owners_count":20548549,"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":["apartments","census","construction","housing","yimby"],"created_at":"2024-10-10T21:58:38.164Z","updated_at":"2025-03-22T21:31:31.293Z","avatar_url":"https://github.com/sid-kap.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# housing-data\n\n[housingdata](https://housingdata.app) is a webapp that displays trends in housing contruction in US and Canada cities, counties, metro areas and states/provinces from 1980 to present.\n\nThe data comes from the US Census's monthly [Building Permits Survey](https://www.census.gov/construction/bps/index.html) (data publicly available) and Statistics Canada's [Building Permits](https://www23.statcan.gc.ca/imdb/p2SV.pl?Function=getSurvey\u0026SDDS=2802) survey (not publicly available at the city level, I had to purchase it).\n\n## Code structure\n\nThe raw data is stored as a combination of fixed-width, CSV, and Excel files at [https://github.com/sid-kap/housing-data-data](https://github.com/sid-kap/housing-data-data). I try to update the raw data files in that repo when BPS releases new data every month.\n\nThe raw data is converted to JSON files usable by the web front-end by python/pandas code that lives in `python/`. That code runs in every Vercel deploy, which runs after new commits in `main`. The JSON files are hosted as static assets by Vercel.\n\nThe front-end is written in React/Next.js and hosted by Vercel.\n\n## Getting Started\n\nYou should have `yarn` and `poetry` installed on your machine.\n\n```sh\n# Clone the raw data repo to ../housing-data-data\npushd ..\ngit clone https://github.com/sid-kap/housing-data-data\npopd\n\n# Set up the python venv\npushd python\npoetry install\npopd\n\n# Run python code to build the static JSON files in ./public\n./build_data_local.sh\n\n# Run the local Next.js development server at http://localhost:3000\nyarn dev\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsid-kap%2Fhousing-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsid-kap%2Fhousing-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsid-kap%2Fhousing-data/lists"}