VoterFlow AI is a high-fidelity, proactive digital assistant built for the PromptWars 2026 competition. It transforms complex electoral and legislative protocols into a guided, interactive "Sovereign" user experience by leveraging Google Gemini and high-performance frontend architecture.
VoterFlow AI is designed to solve the Information Asymmetry in democratic processes. Specifically, it targets the Special Intensive Revision (SIR) 2026 cycle in India, bridging the gap between complex Election Commission of India (ECI) guidelines and the diverse needs of citizens (Students, Seniors, and First-time voters).
Our approach is rooted in Proactive Intelligence. Instead of a static FAQ, VoterFlow AI uses a "Sovereign Assistant" logic:
- Atomic Design Architecture: The UI is built using Atoms, Molecules, and Organisms for maximum scalability and consistency.
- Contextual Personas: The system adapts its language, UI density, and guidance based on the user's persona (e.g., student hostel registration vs. senior home voting).
- Grounded AI: The AI logic is strictly anchored in constitutional protocols, ensuring accuracy in sensitive electoral matters.
- Identity Selection: Users choose a persona (Student, Senior, or New Voter), which triggers a tailored UI state via Zustand.
- Sovereign Dashboard: A central command center providing real-time SIR 2026 timelines, constituency mapping, and readiness tracking.
- Digital Form Engine: A guided multi-step wizard for Form 6/8 registration with simulated AI OCR for identity verification.
- Gemini Assistant: A streaming AI chat that uses Gemini 1.5 Flash to provide real-time, grounded advice on electoral rights and procedures.
- EVM Simulator: A high-fidelity training module for the Electronic Voting Machine and VVPAT process to build voter confidence.
- 2026 Context: The application assumes a futuristic "Special Intensive Revision" cycle for the 2026 elections.
- API Availability: Assumes access to Google Gemini API for core intelligence.
- Data Protocols: Assumes the availability of public Aadhaar and EPIC data structures for simulation purposes.
- Localized UI: Assumes a focus on the Bengaluru Central constituency for geospatial demonstrations.
- Strict TypeScript: 100% type safety enabled with
"strict": trueintsconfig.json. - Maintainable Architecture: Follows the Atomic Design pattern and uses Zustand for clean, decoupled state management.
- Clean Imports: Zero unused locals or imports across the codebase (Verified via
tsc).
- Data Sanitization: All AI-generated content is sanitized using DOMPurify before rendering.
- Environment Security: API keys are managed exclusively via
.envvariables andimport.meta.env. - Resilience: Implemented Global Error Boundaries and defensive coding patterns (e.g., fallback models for Gemini).
- 60FPS Interaction: Uses GPU-offloading (via
will-change) and Layout Containment (contain: layout style) to ensure smooth animations. - Hardware Acceleration: Transitions are optimized for performance on both desktop and mobile devices.
- Bundle Optimization: Built with Vite 8 for lightning-fast HMR and optimized production assets.
- Unit & Logic Testing: Comprehensive test suite using Vitest for store logic, readiness scoring, and journey milestones.
- Build Verification: Every release is verified through a rigorous
npm run buildprocess to ensure zero runtime regressions.
- WCAG Compliance: Semantic HTML5 elements (
aside,nav,header) and proper heading hierarchies. - Inclusive Design: Full ARIA support for form fields, high-contrast civic color palettes, and mobile-first thumb-friendly navigation.
- Multilingual: Instant UI transformation across English, Hindi, and Kannada.
- Gemini 1.5 Flash: Meaningful integration for streaming intelligence, document verification logic, and grounded chat responses.
- Google Maps Intelligence: Satellite mapping integration for polling booth location and sector sync.
- Google Wallet Integration: Simulated "Sovereign Identity" export to Google Wallet for digital credential management.
Built for Google PromptWars 2026 // Sovereign Edition v3.1 // Hardened & Finalized