BlockAid user guide
BlockAid helps a city keep storm drains, fire hydrants and priority sidewalks clear before and during severe weather. Residents adopt and check on assets near them; Public Works staff see what needs a crew.
Every city has its own space at /c/<city-address>, for example /c/maple-heights-demo.
Try the demo city
Open Try the demo city on the home page. No account is needed. Use the Demo switch in the header to move between Resident View and Public Works Admin. Changes you make in the demo city are visible to everyone else trying it.
For residents
Find an asset
- Open your city's map.
- Use the filter buttons at the top: All, Storm Drains, Fire Hydrants, Sidewalks, Unadopted Only, Needs Crew.
- Tap a marker to open its details. Marker colors mean:
| Color | Meaning |
|---|---|
| Gray | Nobody has adopted it yet |
| Blue | Adopted, needs a check |
| Green | Cleared |
| Red, pulsing | Waiting on a City Crew |
The letters on each marker show the type: SD storm drain, FH fire hydrant, PS priority sidewalk.
Adopt an asset
- Sign in with your email (we send a one-tap link — no password).
- Tap a gray marker, then Adopt This Asset.
- Give it a nickname if you like.
- Read and accept the safety waiver. You only accept it once.
Mark it cleared
Tap Mark Cleared, optionally pick what you removed (leaves, trash, ice/snow) and add a photo. You can also do this in one tap from My Assets.
Flag it for the City Crew
Tap Flag for City Crew when something is beyond what a volunteer should handle. Pick a reason — Clogged Grate, Standing Water, Damaged Infrastructure or Downed Wire/Hazard — add a short note and a photo if you can safely take one.
You don't have to adopt an asset or sign in to clear it or flag it.
Stay safe
- Clear debris only from the curb or sidewalk.
- Wear bright or reflective clothing.
- Never step into traffic or moving or deep water.
- Stay at least 30 feet from downed wires. If anyone is in danger, call 911.
Storm alerts
When Public Works starts Storm Mode, a banner appears at the top of the map with instructions and a Citywide readiness bar: the share of adopted storm drains that are cleared.
For Public Works staff
Start your city
- Go to Start a city and sign in with your work email.
- Enter the city name, an optional state or region, and the web address you want (
/c/riverton). - Search for your city to center the map, pick the right result, then Create city.
You are now the city's first admin. Share your city's web address with residents.
Add your infrastructure
BlockAid places every asset on the map from its geographic coordinates. You load them from a spreadsheet file (CSV).
Where the data comes from
Most cities already keep layers for storm drains or catch basins, fire hydrants and sidewalk snow routes in their mapping (GIS) system. Export the layer you want to a CSV file.
Coordinates must be decimal latitude and longitude (WGS 84), for example 41.5981, -93.6249. Coordinates in feet or state-plane systems will not work; ask your GIS team to export in WGS 84 (EPSG:4326), or reproject the layer in QGIS or ArcGIS before exporting.
No GIS file? You can find the coordinates of a single spot by right-clicking it in OpenStreetMap ("Show address") or Google Maps (the numbers at the top of the menu), and typing them into the template.
The file format
| Column | What it is | Example |
|---|---|---|
asset_code | Your city's own ID for the asset. Must be unique in the file. | SD-2001 |
asset_type | Exactly one of storm_drain, fire_hydrant, priority_sidewalk | storm_drain |
address_label | A street address or intersection residents recognize | 610 Maple St & 6th Ave |
lat | Decimal latitude, -90 to 90 | 41.5981 |
lng | Decimal longitude, -180 to 180 | -93.6249 |
Sample file:
asset_code,asset_type,address_label,lat,lng
SD-2001,storm_drain,610 Maple St & 6th Ave,41.5981,-93.6249
FH-301,fire_hydrant,615 Oak Ave & 6th Ave,41.5983,-93.6219
PS-601,priority_sidewalk,"620 Elm St (Library route)",41.5980,-93.6188
Put quotes around an address that contains a comma. Extra columns are ignored.
Importing
- Open City Data → Import Assets via CSV.
- Download sample template if you want a starting file.
- Choose CSV file. BlockAid checks it right away and lists any rows it can't use, with the line number and reason. Nothing is saved yet.
- Fix those rows and choose the file again, or press Import to load just the valid rows.
- If a row's
asset_codealready exists in your city, that asset's type, address and location are updated instead of creating a duplicate. You can re-import an updated GIS export at any time.
Common problems
- Assets appear in the wrong country or the ocean:
latandlngare swapped, or a minus sign is missing. In the Americas longitude is negative; south of the equator latitude is negative. - "Invalid asset_type": check spelling — lowercase with underscores, e.g.
storm_drain. - "Duplicate asset_code": the same ID appears twice in one file. Only the first is kept.
- "Missing column(s)": the header row must include all five column names.
What happens next
Imported assets appear on your city's map immediately as gray (unadopted) markers that residents can adopt. Residents see the address label, not raw coordinates.
Add colleagues
On City Data → Public Works Staff, enter a colleague's email. They must sign in to BlockAid once first.
Dispatch dashboard
- Top figures: total assets, share adopted by residents, assets cleared, and open crew tickets.
- Storm Mode: start an event (title, severity, resident instructions) or end it. Starting a new event replaces the current one.
- Reset All Adopted Assets to "Needs Check": use at the start of a storm so residents re-check. Assets waiting on a crew keep that status.
- Priority Triage Queue: every open crew ticket, sorted by Newest or Severity (downed wires first, then damaged infrastructure, standing water, clogged grates). Each row has the address, issue, a resident photo you can enlarge, and an Open in Google Maps link.
- Mark Resolved by Crew: closes the ticket and turns the asset green.
Export for work orders
City Data → Export Triage Report (CSV) downloads every open crew ticket for 311 or work-order systems. Columns: asset_code, asset_type, address_label, lat, lng, issue_type, resident_notes, reported_at. Photos stay in the dispatch queue and are not included in the file.
Questions
- Is there a map fee? No. Maps use free OpenStreetMap tiles.
- Who sees photos? Only dispatch staff, through links that expire after an hour.
- Can one person manage several cities? Yes. Start a city lists every city you manage.