An independent, mobile-first prototype for handling life events, bills and deadlines, benefits, and government paperwork in plain language. Every person and record in the repository is fictional, and all government responses run in a clearly labelled simulated mode.
Try Citizen · Watch the enhanced Round 2 demo
npm install
npm run devOpen http://localhost:3000 to read the project overview, then choose Start the demo to open a sample profile:
- Arjun Sharma: main citizen journey
- Priya Patel: partner-consent journey
- Sunita Sharma: delegated-access journey
No access code or API key is required. Intent routing and notice explanations run deterministically in the browser.
The public landing page always lives at /. Profile selection lives at /start; after selection, the signed-in Home and dashboard open at /home.
Codex (gpt-5.6) wrote the code, working from design and review direction by the team. The Builder Brief accepts a prototype built with Codex or powered by an OpenAI model, so the submitted app needs no paid runtime model and exposes no API key.
- Next.js App Router for the browser application
- Zustand for the persisted Citizen Graph and local profile-access state
- Zod for seed and mutation validation
- Tailwind CSS for the mobile-first design system
- Local planners for multilingual intent routing and notice explanations
src/data/seed.json is the sole source of sample profile data. Components never mutate the graph directly: workflow procedures emit typed mutations through src/features/graph/mutations.ts, and selector functions derive every citizen-facing view from the graph.
/family keeps connections separate from record-sharing permissions. Arjun, Priya and Sunita can send, accept, decline or cancel invitations. Sharing is explicit, scoped and revocable; changing or ending one permission does not change another person's access. Other family members remain read-only seed context.
/inbox explains the three supported notice samples in English, Hindi and Kannada. Changed or unfamiliar messages stay uncertain and can be saved for review without invented facts or a guessed workflow. Saved notices belong to the active profile; opening one does not mark the underlying government task as completed.
npx tsc --noEmit --incremental false
npx eslint .
npm run buildThe complete Remotion project lives in demo-video. It includes the timed script, app recordings, captions, Gemini voiceover clips, music mix and deterministic render command.
cd demo-video
npm install
npm run lint
npm run renderThe rendered MP4 is excluded from Git. You can watch the enhanced Round 2 demo on YouTube.
Music: “Bombay Summer” by Shane Ivers, licensed under CC BY 4.0. See demo-video/MUSIC-CREDITS.md for the full attribution.
This is an independent prototype, not a government service. It makes no live government API calls, accepts no real identity or payment data, and uses no government logos. Every simulated response is identified in the interface. See /about for the complete service-status disclosure.
Citizen is open source under the MIT Licence. Third-party media retains its original licence and attribution requirements.
