ElectiGuide: The #1 AI-Powered Civic Navigator 🗳️

ElectiGuide is a state-of-the-art civic tech platform designed to turn first-time voters into lifelong participants in democracy. Built for the #BuildwithAI #PromptWarsVirtual hackathon, it provides a personalized, multimodal experience powered by cutting-edge Google AI.

---

🏆 Core Features

🧠 1. AI-Powered Personalized Roadmap

Using a sophisticated Diagnostic Quiz, the assistant leverages Google Gemini 3 Flash to analyze the user's specific readiness and generate a bespoke preparation plan.

• Dynamic Logic: Automatically updates the user's checklist based on diagnostic results.
• Deep Personalization: Adapts to the user's knowledge level for the Indian electoral context.

🎙️ 2. Multimodal Interaction (Voice + Text)

ElectiGuide breaks accessibility barriers by integrating the Web Speech API.

• Voice-to-Task: Users can speak their questions naturally, and CivicBot will respond instantly.
• Aria-Live Updates: AI responses are announced in real-time for screen reader users.

📍 3. Interactive Polling Navigator

A custom-built, premium Polling Map integration that helps users visualize their destination.

• Pincode Search: Dynamic search using Google Maps & Places API.
• Cloud-Ready: Integrated with Google Cloud services for high-reliability location fetching.

🎨 4. Premium Motion Design & 3D Visuals

• Glassmorphism 2.0: Professional SaaS-grade depth, blur effects, and high-contrast design.
• Ballot Box Animation: Pure-CSS 3D animation symbolizing the act of voting.
• Live Digital Clock: Real-time pulsing clock synced to Indian Standard Time.

---

🛡️ Security & Reliability

ElectiGuide implements industry-standard security protocols:

• Content Security Policy (CSP): Strict policy to prevent XSS and unauthorized script execution.
• Input Sanitization: Global sanitization engine for all user-facing inputs.
• API Resilience: Automatic exponential backoff and graceful fallback for Gemini API.

🧪 Comprehensive Testing Suite

ElectiGuide includes a custom-built Integrated Verification Suite for real-time validation.

• How to Run: Press Ctrl + Shift + T anywhere in the application.
• Coverage:
  • UI Integrity & Navigation Accessibility
  • LocalStorage Persistence & State Management
  • Sanitization & XSS Protection Logic
  • Google Services & API Connectivity

☁️ Google Cloud Adoption

• Google Analytics: Fully integrated gtag for tracking user engagement.
• Firebase Simulation: Mock cloud synchronization engine demonstrating Auth and Firestore integration for civic activity logging.
• Cloud Run Optimized: Containerized and ready for instant deployment to Google Cloud.

---

🚀 Deployment

Google Cloud Run:

1. Enable APIs:

   gcloud services enable run.googleapis.com \
                          generativelanguage.googleapis.com \
                          maps-backend.googleapis.com \
                          places-backend.googleapis.com

2. Deploy:

   gcloud run deploy electiguide --source . --platform managed --allow-unauthenticated

Local Development:

• Windows: Run run_local.bat.
• Linux/Mac: Run ./run_local.sh.
• Open http://localhost:8000.

---

📝 Setup

To enable live intelligence:

1. Google Gemini: Replace API_CONFIG.KEY in assistant.js with your Gemini API Key.
2. Google Maps: Replace YOUR_API_KEY in index.html with your Google Maps API Key.

---

Built with ❤️ for #BuildwithAI 🚀 Tagging @googlefordevelopers @hack2skill for the #PromptWarsVirtual.