rajadityaaaaaa/election-navigator
0
๐ณ๏ธ Election Navigator (India)
A GPS for Democracy โ Your Step-by-Step Guide to Voting in India
Tech Stack
Project Structure
Election assistant/
โโโ .github/
โ โโโ workflows/
โ โโโ ci.yml โ GitHub Actions CI pipeline
โโโ src/
โ โโโ backend/
โ โ โโโ server.js โ Express app entry point
โ โ โโโ routes/ โ API route definitions
โ โ โโโ controllers/ โ Business logic
โ โ โโโ services/ โ Data & Logic services
โ โโโ frontend/
โ โ โโโ index.html โ App shell
โ โ โโโ css/
โ โ โ โโโ index.css โ Base styles + design tokens
โ โ โโโ js/
โ โ โโโ app.js โ Frontend entry point
โ โโโ data/
โ โโโ elections.json โ Indian State election data seed
โ โโโ glossary.json โ Jargon Buster term seed (Indian context)
โโโ tests/
โ โโโ api.test.js โ Integration tests
โโโ .env.example
โโโ package.json
โโโ TASKS.md
โโโ README.mdGetting Started
1. Prerequisites
- Node.js โฅ 18.0.0
- npm โฅ 9.0.0
2. Install
npm install3. Run in Development
npm run dev4. API Endpoints
Design Principles
- Reduce Cognitive Load โ One step at a time
- Radical Neutrality โ Process only, no party endorsements
- Accessibility First โ WCAG 2.1 AA, mobile-first
- Verified Data โ ECI (voters.eci.gov.in), NVSP, and ADR India (MyNeta) sources only
Election Navigator (India) ยท April 2026
