Pakistan's Premier Participatory Democracy Platform
Hum Awaz (ΫΩ Ψ’ΩΨ§Ψ²) empowers Pakistani citizens to actively participate in democratic processes through digital consultations, proposal submissions, and collaborative decision-making. Built for transparency, accessibility, and meaningful civic engagement.
- Public Consultations: Government-initiated processes on policy matters
- Multi-Language Support: Full English/Urdu bilingual interface with RTL support
- Time-Based Progress: Real-time progress tracking for active consultations
- Category Organization: Education, Healthcare, Infrastructure, Economy, Environment, Governance
- Proposal Submission: Citizens can submit detailed policy proposals
- Collaborative Editing: Multi-language proposal creation
- Status Tracking: Pending β Approved β Under Review β Implemented
- Process Integration: Proposals linked to relevant consultation processes
- Three-Option Voting: Support, Oppose, Neutral positions
- Vote Changes Allowed: Users can update votes until deadline
- Real-Time Updates: Instant vote count refresh
- Visual Feedback: Clear indication of user's current vote
- Process Discussions: General conversation on consultation topics
- Proposal Comments: Threaded discussions on specific proposals
- Multi-Language Content: Comments in English and Urdu
- Community Engagement: Foster dialogue between citizens
- Smart Search: Find processes/proposals by keywords
- Category Filters: Browse by policy area
- Status Filtering: Active, closed, pending processes
- Sorting Options: Recent, popular, most supported
- Supabase Auth: Secure user registration and login
- Row Level Security: Database-level access control
- Profile Management: User profiles with preferences
- Participation Tracking: Engagement analytics
- Next.js 14: React framework with App Router
- TypeScript: Type-safe development
- Tailwind CSS: Modern utility-first styling
- Shadcn/ui: High-quality UI components
- Lucide Icons: Consistent iconography
- Supabase: Backend-as-a-Service platform
- PostgreSQL: Robust relational database
- Row Level Security: Fine-grained access control
- Real-time Subscriptions: Live data updates
- Vercel: Deployment and hosting
- Edge Functions: Global performance optimization
- CDN: Fast content delivery worldwide
profiles β User profiles and preferences
processes β Democratic consultation processes
proposals β Citizen-submitted proposals
discussions β Comments and conversations
votes β User votes on proposals
participations β Engagement tracking
notifications β User alerts and updates
- Processes have many Proposals
- Proposals have many Votes and Discussions
- Users can participate in multiple Processes
- Real-time vote counting with database triggers
- Node.js 18+ and pnpm
- Supabase account and project
- Git for version control
-
Clone the repository
git clone https://github.com/codeforpakistan/hum-awaaz.git cd hum-awaaz -
Install dependencies
pnpm install
-
Environment Setup Create
.env.localfile:NEXT_PUBLIC_SUPABASE_URL=your_supabase_url NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
-
Database Setup
# Run database migrations in order: # 1. Drop existing tables (if any) psql -h your-db-host -d your-db -f supabase/step1-drop-tables.sql # 2. Create schema and tables psql -h your-db-host -d your-db -f supabase/step2-create-schema.sql # 3. Insert sample data psql -h your-db-host -d your-db -f supabase/step3-sample-data.sql
-
Run Development Server
pnpm run dev
-
Open Application Navigate to http://localhost:3000
hum-awaaz/
βββ app/ # Next.js App Router pages
β βββ (auth)/ # Authentication pages
β βββ dashboard/ # User dashboard
β βββ processes/ # Democratic processes
β β βββ [id]/ # Individual process pages
β β βββ new/ # Create new process
β βββ proposals/ # Citizen proposals
β βββ layout.tsx # Global layout
βββ components/ # Reusable UI components
β βββ ui/ # Shadcn/ui components
β βββ main-nav.tsx # Navigation component
β βββ language-provider.tsx # i18n context
β βββ footer.tsx # Footer component
βββ lib/ # Utility libraries
β βββ supabase.ts # Database client
β βββ auth-context.tsx # Authentication context
β βββ utils.ts # Helper functions
βββ supabase/ # Database scripts
β βββ step1-drop-tables.sql
β βββ step2-create-schema.sql
β βββ step3-sample-data.sql
βββ public/ # Static assets
Hum Awaz implements modern participatory democracy principles:
- Deliberative Process: Structured discussions before voting
- Inclusive Participation: Multi-language accessibility
- Transparent Governance: Open process and result tracking
- Iterative Engagement: Vote changes allowed during consultation period
True Pakistani experience with:
- Native Urdu Support: RTL text rendering and Urdu typography
- Cultural Context: Pakistani government structure integration
- Flexible Language Switching: User preference persistence
- Content Localization: All interface elements translated
Modern digital engagement through:
- Live Vote Counts: Instant result updates
- Dynamic Progress Tracking: Time-based consultation progress
- Immediate Feedback: Instant vote confirmation
- Notification System: Real-time updates on process changes
Track democratic engagement through:
- Participation Rates: Users actively engaging in processes
- Geographic Distribution: Participation across Pakistan
- Category Popularity: Most discussed policy areas
- Proposal Success: Conversion from submission to implementation
- Core democratic processes
- Proposal submission system
- Interactive voting
- Discussion platform
- Bilingual interface
- Participatory budgeting module
- Advanced voting systems (ranked choice, quadratic)
- Geographic mapping integration
- Survey and questionnaire engine
- Mobile app development
- Multi-tenant government support
- API for third-party integrations
- Advanced analytics dashboard
- AI-powered proposal analysis
- Blockchain vote verification
- Citizen initiative system
- Assembly management tools
- Cross-border consultation capabilities
- Academic research integration
See ROADMAP.md for detailed development plans
We welcome contributions from developers, designers, policy experts, and civic engagement specialists!
- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open Pull Request
- Frontend Development: React/Next.js components
- Backend Development: Supabase functions and triggers
- UI/UX Design: User experience improvements
- Translation: Urdu and regional language support
- Documentation: API docs and user guides
- Testing: Automated testing and QA
- TypeScript for type safety
- ESLint and Prettier for code formatting
- Conventional commits for clear history
- Component-based architecture
- Responsive design principles
This project is licensed under the MIT License - see the LICENSE file for details.
Hum Awaz is designed for collaboration with:
- Federal Government: National policy consultations
- Provincial Governments: Regional governance initiatives
- Local Governments: Community-level decision making
- Civil Society: NGO and advocacy group engagement
- Academic Institutions: Research and analysis partnerships
- GitHub Issues: Bug reports and feature requests
- Discussions: Community Q&A and ideas
- Live Platform: humawaz.codeforpakistan.org
- Documentation: Comprehensive guides and tutorials
For government organizations and large-scale deployments:
- Implementation Consulting: Custom deployment assistance
- Training Programs: User and administrator training
- Technical Integration: API and system integration support
- Ongoing Maintenance: Long-term support contracts
Democratizing Democracy in Pakistan
Hum Awaz envisions a Pakistan where every citizen has a meaningful voice in governance. Through accessible technology, transparent processes, and inclusive participation, we're building the digital infrastructure for 21st-century democracy.
Our platform bridges the gap between citizens and government, fostering:
- Active Civic Engagement: Beyond voting to continuous participation
- Transparent Governance: Open processes and accountable outcomes
- Inclusive Decision-Making: Voices from all communities and backgrounds
- Evidence-Based Policy: Data-driven insights for better governance
- 100K+ Registered Users in first year
- 500+ Democratic Processes hosted annually
- 10K+ Proposals submitted by citizens
- 80%+ User Satisfaction with platform experience
- Increased Transparency: Open government data and processes
- Better Policy Decisions: Evidence-based, citizen-informed policies
- Stronger Democracy: Higher civic engagement and trust
- Digital Inclusion: Bridging urban-rural participation gaps
Special thanks to:
- Open Source Community: Building on incredible open-source tools
- Decidim Project: Inspiration from leading participatory democracy platform
- Pakistani Civil Society: Advocacy for transparent governance
- Beta Users: Early feedback and platform testing
- Contributors: Developers, designers, and democracy advocates
Built with β€οΈ for the people of Pakistan
Hum Awaz - ΫΩ Ψ’ΩΨ§Ψ² - Voice of the People
| Resource | Link |
|---|---|
| π Live Platform | https://humawaz.codeforpakistan.org |
| π Documentation | /docs |
| πΊοΈ Roadmap | ROADMAP.md |
| π Issues | GitHub Issues |
| π¬ Discussions | GitHub Discussions |
| π§ Contact | support@humawaaz.pk |