Community-run transit monitoring for Singapore MRT/LRT disruptions.
mrtdown-site is a TanStack Start React app deployed to Fly.io. The Node server
reads canonical mrtdown data through a Postgres/PostGIS-backed read model
populated from data archives by durable Upstash Workflows.
-
Install dependencies:
npm ci
-
Create local environment variables:
cp .env.example .env
The example points
VITE_ROOT_URL,DATABASE_URL, andREDIS_URLat the local services.QSTASH_DEV=trueenables the local QStash development server used by Upstash Workflow. -
Start local Postgres/PostGIS and Valkey services, then run migrations and seed fixture data:
docker compose up -d postgres valkey npm run db:migrate npm run db:seed:fixtures
-
Start the app:
npm run dev
Visit http://localhost:3000.
npm run dev:pullandnpm run dev:public-holidaystrigger the local workflows while the dev server is running.- Run
npm run verifybefore publishing. See the quality guide for database test setup and the generated files guide for migrations.
Use the documentation index to find subject guides and the execution plan index to find current work.
See the repository working rules before contributing.