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

1. Clone the repository

   git clone https://github.com/codeforpakistan/hum-awaaz.git
   cd hum-awaaz

2. Install dependencies

   pnpm install

3. Environment Setup Create .env.local file:

   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

4. 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

5. Run Development Server

   pnpm run dev

6. 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!

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. 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