India's free, open-source, district-level civic transparency platform.
Live Site ยท Watch the Platform Walkthrough ยท Vote for Features ยท Support the Project
ForThePeople.in aggregates publicly available Indian government data into clean, citizen-friendly dashboards โ one for every district. Instead of navigating 50+ government portals, citizens get a single platform for crop prices, dam levels, budget spending, school performance, infrastructure projects, government schemes, tenders and more.
Data is updated daily or when sources publish โ every module shows when its data was last refreshed, and nothing is invented when a source is down.
Currently live: 10 districts across 7 states (see the live site for the current number โ it changes as districts go live):
- Karnataka: Mandya, Mysuru, Bengaluru Urban
- Tamil Nadu: Chennai
- Maharashtra: Mumbai, Pune
- Delhi: New Delhi
- West Bengal: Kolkata
- Telangana: Hyderabad
- Uttar Pradesh: Lucknow
There is also an India-wide dashboard that rolls the same modules up to the national level.
Goal: All 780+ districts across 28 states and 8 UTs.
Each district has 30+ modules (the sidebar on any district page is the authoritative list). Grouped roughly:
| Category | Modules |
|---|---|
| Data | Overview, Interactive Map, Water & Dams, Crop Prices, Weather & Rainfall, Finance & Budget, Population, Power |
| Governance | Leadership, Police & Traffic, Schools, Courts, RTI Tracker, Gram Panchayat, Health, Responsibility, Tenders |
| Services | Gov. Schemes, Services Guide, Elections, Exams, Transport, JJM Water Supply, Housing, Industries, Farm |
| Community | Local Alerts, Offices, Citizen Corner, Famous Personalities, News, Contributors, Data Sources, Update Log |
| Layer | Technology |
|---|---|
| Frontend | Next.js (App Router), React, TypeScript, Tailwind CSS v4, react-simple-maps, Recharts |
| Database | PostgreSQL (Neon), Prisma ORM (108 models) |
| Cache | Upstash Redis (REST) |
| AI | OpenRouter (free-tier models for news classification, low-cost models for insights) with Anthropic fallback โ see src/lib/ai-provider.ts |
| Data collection | Vercel Cron jobs, Google News RSS, Cheerio |
| Hosting | Vercel (Mumbai region) |
| Payments | Razorpay (supporter contributions, India only) |
| Monitoring | Sentry (errors), Plausible (analytics, cookieless) |
| Resend (admin alerts) | |
| Tests | Vitest (pure helpers), ESLint, TypeScript strict |
See docs/ARCHITECTURE.md for how the pieces fit together.
Requires Node.js 24 (see .nvmrc; run nvm use).
# Clone
git clone https://github.com/jayanthmb14/forthepeople.git
cd forthepeople
# Install
npm install
# Set up environment (see .env.example โ it is the only list of variables)
cp .env.example .env.local
# Fill in DATABASE_URL at minimum
# Database
npx prisma generate
npx prisma db push # your OWN dev database only
# Run
npm run dev
# Checks
npm run lint && npx tsc --noEmit && npm testdocs/ # Architecture, runbooks, trackers (docs/ARCHITECTURE.md first)
prompts/ # Claude Code prompts archive (completed + pending)
tests/ # Vitest unit tests for pure helpers
src/
โโโ app/ # Next.js App Router pages + API routes
โ โโโ api/
โ โ โโโ data/[module]/ # Unified per-module data API
โ โ โโโ cron/ # Scheduled jobs (news, crops, insights, exams, budget)
โ โ โโโ admin/ # Admin endpoints (health, alerts, analytics, vault)
โ โโโ [locale]/[state]/[district]/ # District dashboard pages
โโโ components/ # Reusable React components
โโโ lib/ # Core utilities (DB, Redis, AI, alerts, health score, tenders)
โโโ scraper/ # Background data collection jobs
prisma/
โโโ schema.prisma # Database schema (108 models)
โโโ seed*.ts # Seed data per district / module
ForThePeople.in is an independent citizen transparency initiative. It is NOT an official government website. All data is sourced from publicly available government portals under India's Open Data Policy (NDSAP) and the Right to Information (Article 19(1)(a) of the Indian Constitution).
Running this platform for all 780+ districts costs approximately โน12 lakh/year. You can help:
- One-Time Contribution โ any amount from โน10
- District Champion โ โน99/mo, name on your chosen district page
- State Champion โ โน999/mo, name on every district in that state
- All-India Patron โ โน9,999/mo, featured on every district page
- Founding Builder โ โน50,000/mo, permanent homepage spotlight
Support page โ ยท Contributor leaderboard โ ยท funding.json โ
We welcome contributions from developers of all skill levels! Whether you want to add a new district, fix a bug, improve the UI, or add translations โ every contribution helps.
- Read the Contributing Guide to get started
- Check out
good-first-issueandhelp-wantedissues - Review our Code of Conduct
- Report security issues privately via SECURITY.md
Thank you to everyone who has opened a pull request or issue so far โ including @AmanSurushe, @threatner, @joellui, @Ronithkumar, @tiwarikaran, @abhiprd2000 and @rigsutra. Open PRs are being reviewed in order; see the pinned STATUS issue for where things stand.
Goal: Cover all 780+ districts across India. Currently at 10 โ help us get there!
Jayanth M B โ Entrepreneur from Karnataka, India.
Built with the belief that every Indian citizen deserves free, transparent access to their district's government data.
- Instagram: @jayanth_m_b
- Project: forthepeople.in
- Contact: support@forthepeople.in
MIT โ Copyright (c) 2026 Jayanth M B. Use it, fork it, build on it.
The MIT licence only requires you to keep the copyright notice. Beyond that, if you fork or deploy this project, the creator would appreciate โ but does not legally require โ that you:
- Keep the "Originally created by Jayanth M B" line in your README or About page.
- Link back to github.com/jayanthmb14/forthepeople so improvements can flow back upstream.
- Keep the platform free for citizens and never present it as an official government service.