Interactive map of free services for residents in need — shelters, food banks, SNAP/EBT retailers, and federally-qualified health centers. Currently covers Georgia, with easy expansion to any US state.
Live site: https://sky640q.github.io/getcivly/
| Color | Category | Source |
|---|---|---|
| Blue | Shelters | OpenStreetMap |
| Orange | Food Banks & Pantries | OpenStreetMap |
| Green | SNAP / EBT Retailers | USDA FNS |
| Red | Free Health Clinics | HRSA |
Open config/states.json and set "enabled": true for the state you want:
"FL": {
"enabled": true,
...
}Then trigger Actions → Refresh Resource Data → Run workflow. That's it — data is fetched automatically from all three universal sources (SNAP, HRSA, OSM) for the new state, written to data/FL/, and the map updates.
States already pre-configured (just flip enabled): GA, FL, TX, NC, SC, AL, TN.
Controls which states are active and their geographic settings.
All universal API endpoints and field mappings in one place. If an API URL changes, update it here — no need to touch the fetch script.
{
"snap": { "url": "...", "stateField": "State", ... },
"clinics": { "url": "...", "stateField": "Site State Abbreviation", ... },
"osm": { "baseUrl": "https://download.geofabrik.de", "overpassEndpoints": [...], ... }
}If a state has its own API (e.g. a state food bank locator), add it to extraSources:
"extraSources": [
{
"category": "food",
"type": "geojson_url",
"url": "https://state-api.gov/food-banks.geojson",
"attribution": "State Dept of Agriculture"
}
]Supported type values: geojson_url (more can be added in fetch-data.mjs).
# 1. Clone the repo
git clone https://github.com/Sky640q/getcivly.git
cd getcivly
# 2. Serve the site
python -m http.server 8080Open http://localhost:8080. Each state's data/{STATE}/ folder has sample entries so the map works immediately.
The workflow in .github/workflows/refresh-data.yml runs every Monday at 03:00 UTC.
Trigger it manually: Actions tab → Refresh Resource Data → Run workflow
# Requires osmium-tool: sudo apt-get install osmium-tool
node scripts/fetch-data.mjsosmium-tool is optional — without it the script falls back to the Overpass API automatically.
- Open https://overpass-turbo.eu
- Paste
exports/queries/shelters.overpassql→ Run → Export GeoJSON → save asexports/shelters.geojson - Repeat for
food-banks.overpassql - Run:
node scripts/normalize.mjs
├── index.html
├── css/style.css
├── js/app.js # Leaflet map, loads data/manifest.json
├── config/
│ ├── states.json # Enable/disable states, set bboxes
│ └── sources.json # Universal API URLs and field mappings
├── data/
│ ├── manifest.json # Generated — lists enabled states + timestamp
│ ├── GA/
│ │ ├── shelters.json
│ │ ├── food-banks.json
│ │ ├── clinics.json
│ │ └── snap.json
│ └── {STATE}/ # One folder per enabled state
├── exports/
│ ├── queries/ # Overpass Turbo .overpassql files
│ └── *.geojson # Manual exports (gitignored)
├── scripts/
│ ├── fetch-data.mjs # Automated fetcher (reads config/)
│ └── normalize.mjs # Converts manual Overpass exports
└── .github/workflows/
└── refresh-data.yml # Weekly cron, free for public repos
- OpenStreetMap via Geofabrik (primary) or Overpass Turbo (fallback)
- HRSA Health Center Program — federally qualified health centers. data.hrsa.gov
- USDA FNS SNAP Retailer Locator — authorized SNAP/EBT retailers. services1.arcgis.com
MIT. Data belongs to respective sources (OSM © ODbL, HRSA public domain, USDA public domain).