curb CLAUDE.md

CURB — SF street parking, block by block

Context for Claude Code. Read this before editing.

What it is

A mobile-first web app that shows San Francisco street-parking rules on an interactive map: where you can park, until when it's swept, whether it's metered, and whether it's a residential permit (RPP) zone. Lets the user set a calendar reminder before the next sweep.

Stack (intentionally minimal)

• Single static file: index.html. No build step, no framework, no bundler.
• Vanilla JS + Leaflet 1.9.4 (from cdnjs) for the map.
• Basemap: official Google Map Tiles API when GMAPS_KEY (or window.GMAPS_KEY) is set — session-token flow in initBasemap(), viewport attribution refreshed on moveend. Falls back to keyless CARTO Voyager raster tiles when no key / on any failure. Leaflet stays the map engine either way. The Google key is a client key (referrer-restrict it) kept OUT of the public repo: local dev reads a gitignored config.js (from config.example.js); on Vercel, api/config.js emits window.GMAPS_KEY from the GMAPS_KEY env var and vercel.json rewrites /config.js → /api/config.
• Everything is client-side. Data is fetched live from DataSF (Socrata) at runtime.
• Design system: fonts Anton (display) + Hanken Grotesk (body); "transit signage" aesthetic; color tokens in :root (--green clear / --amber soon / --red now / --meter permit-blue / paper+ink). Keep this language if extending the UI.

Data sources (all DataSF Socrata, CORS-open: access-control-allow-origin: *)

1. Street sweeping — yhqp-riqs https://data.sfgov.org/resource/yhqp-riqs.json Fields: cnn (segment id), corridor, limits (cross streets), blockside, cnnrightleft (L/R vs digitized direction), weekday, fromhour, tohour, week1..week5 ("1"/"0" = Nth occurrence of that weekday in the month), line (GeoJSON LineString). CURRENT data.
2. Parking meters — 8vzz-qzz9 https://data.sfgov.org/resource/8vzz-qzz9.json Fields: street_name (UPPERCASE), cap_color, on_offstreet_type, lat/long, etc. CURRENT data. Used only for a street-level count (no spatial join — see limits).
3. Parking regulations / RPP — hi6h-neyh https://data.sfgov.org/resource/hi6h-neyh.json Fields: regulation, rpparea1 (permit-area letter), hrlimit, days, from_time, to_time, exceptions, shape (GeoJSON MultiLineString). STALE: this is SFMTA's 2017 set, flagged by the city as not comprehensively updated. Treat as a hint. NOTE: RPP covers BOTH curbs — rendered as ONE street-wide centerline ribbon UNDER the curb lines, with zoom-scaled weight (rppWeight(): 4px@z15 → 26px@z18 ≈ curb-to-curb). Do NOT draw offset bands per side: they stack into a blue blanket at low zoom and collide with the ±5m curb lines at high zoom (tried 2026-06-09, looked broken).
4. Loading / color-curb zones — 6cqg-dxku (Meter Operating Schedules) Field applied_color_rule carries the regulation + days_applied/from_time/to_time/ time_limit (White=passenger, Yellow=commercial, Red=truck, Green=short-term, Orange=bus). cap_color is UNRELIABLE (white zones show Grey caps) — match on applied_color_rule. No geometry → join to meter coords by post_id (8vzz-qzz9 lat/long). Metered zones only; paint-only curbs aren't published. Loaded once on toggle, rendered per-viewport.
5. Parking citations — ab4h-6ztd (23.8M rows, daily, ~2-5 day lag) STR CLEAN (TRC7.2.22) + ST CLEANIN (T37C) = street-cleaning tickets, minute-resolution. A 2024 records request (#26-5453) restored GPS lat/long on the citations: ~815k of ~1M street-cleaning tickets now match to a CNN by NEAREST CNN SEGMENT (<=40m), the primary pipeline. The old address→CNN join via EAS (3mea-di5p, keyed by stripZeros(number)|street_name) is demoted to a pre-2024 fallback for rows without GPS. Precomputed offline into data/enforcement.json — see scripts/build-enforcement-records.py and docs/sweeper-data-research.md. Powers the "🎯 Ticketed ~9:11a" lines.