NJ Transit Explorer

Interactive map of NJ Transit bus routes, NJ Transit rail lines, and local shuttle routes with route-level filtering, area-based selection, and stop-level schedule popups.

Live app: https://nj-transit.vercel.app

Requirements

• uv
• Python 3.10+

Local Development

1. Build data (refresh feeds + regenerate route/schedule JSON):

uv run scripts/build_njt_data.py --refresh

2. Start a local static server:

uv run python -m http.server 8000

3. Open:

http://localhost:8000

Data Build Modes

Default (recommended): route/line geometry in data/routes/ plus schedule payloads in data/schedules/.

uv run scripts/build_njt_data.py --refresh

Inline schedules (larger route files, fewer hover fetches):

uv run scripts/build_njt_data.py --inline-schedules --refresh

No stop schedules (smallest payload):

uv run scripts/build_njt_data.py --no-stop-schedules --refresh

Repository Layout

src/
  app/
    routes/
  config/
  data/
  map/
  ui/
  utils/
scripts/
  build_njt_data.py
data/
  manifest.json
  routes/
  schedules/
index.html
styles.css
sw.js

Notes

• Route/line files are lazy-loaded when selected.
• Schedule files are prefetched after route load so stop hover popups render quickly.
• GTFS archives are cached under data/ for reproducible rebuilds.