| title | GlobeVote Civic Intelligence |
|---|---|
| emoji | 🌍 |
| colorFrom | indigo |
| colorTo | blue |
| sdk | docker |
| app_port | 7860 |
The world's most knowledgeable political scientist in your pocket.
Understand global elections · Fact-check claims instantly · Simulate electoral systems · Learn civics interactively
GlobeVote is a state-of-the-art civic education platform designed to make democracy transparent and accessible. It bridges the gap between complex political data and citizen engagement by combining an AI-powered assistant, real-time election tracking, and interactive simulations into a premium, dark-themed experience.
Whether you're a first-time voter, a political science student, or a curious citizen, GlobeVote provides the tools to understand how your world is governed.
- GPT-4o Integration: Context-aware, strictly neutral political analysis.
- Multi-Mode: Toggle between Standard, ELI5 (simple), and Expert (deep-dive) responses.
- Session Intelligence: Persistent conversation history for continuous learning.
- Real-Time Simulation: Model how FPTP, PR, MMP, and STV translate votes into seats.
- Scientific Scoring: Automatic Gallagher Index calculation for proportionality analysis.
- Comparative Analysis: View how different systems impact representation side-by-side.
- AI Fact-Checking: Submit any political claim for instant verification.
- Transparency Scale: Clear verdicts from True to False with detailed evidence summaries.
- Community Pulse: View recent verifications to stay ahead of trending misinformation.
- Live Tracking: Real-time countdowns and data for 190+ countries.
- Voter Journey: Step-by-step interactive guides to registration and voting.
- Deep Data: Historical results, upcoming candidates, and key political issues.
| Layer | Technology | Why? |
|---|---|---|
| Core | React 18 + TS | Type-safe, high-performance UI components. |
| Styling | Tailwind + Framer | Motion-heavy, premium dark-space aesthetic. |
| Backend | Express 5 + Pino | Modern, asynchronous API with structured logging. |
| Database | Postgres + Drizzle | Type-safe SQL access with automated migrations. |
| AI Layer | OpenAI SDK | Multi-modal support (text + future voice) via GPT-4o. |
| Tooling | pnpm Workspaces | Efficient monorepo management with shared catalogs. |
- Node.js: v20+
- pnpm: v9 or v10
- PostgreSQL: v15+
- FFmpeg: (Optional) For advanced audio/voice features
-
Clone & Install
git clone https://github.com/AbhishekGupta0164/-GlobeVote-AI-Powered-Civic-Intelligence-Platform.git cd GlobeVote pnpm install -
Environment Configuration
cp .env.example .env # Edit .env with your DATABASE_URL and OPENAI_API_KEY -
Database Initialization
# Push schema and seed initial data (Countries, Systems, Quizzes) pnpm --filter @workspace/db run push pnpm --filter @workspace/scripts run seed -
Launch Development Environment
pnpm dev
Visit
http://localhost:5173to experience GlobeVote.
globevote/
├── artifacts/
│ ├── globevote/ # React + Vite frontend application
│ └── api-server/ # Express.js API backend
├── lib/
│ ├── api-spec/ # OpenAPI 3.0 specification
│ ├── api-zod/ # Shared Zod validation schemas
│ ├── api-client-react/ # Generated TanStack Query hooks
│ ├── db/ # Drizzle ORM schema & migrations
│ └── integrations/ # OpenAI, Audio, and Image processing modules
└── scripts/ # Database seeding and migration tools
GlobeVote adheres to a Deep Space aesthetic:
- Glassmorphism: High-blur backdrops for a premium feel.
- Micro-interactions: Subtle Framer Motion animations on every hover and click.
- Data Viz: Animated charts and counters to make statistics engaging.
We welcome contributions that help make civic data more accessible!
- Fork the repo.
- Create your feature branch.
- Commit with Conventional Commits.
- Submit a PR.
Released under the MIT License. Copyright © 2026 GlobeVote.
Built with ❤️ to make democracy accessible to everyone.
GlobeVote — Civic Intelligence for Every Citizen