Empowering Kenyan citizens with transparent access to government project information
Kagua (Swahili for "inspect" or "examine") is a cutting-edge web platform that brings transparency to government projects across Kenya. Citizens can now easily access, monitor, and provide feedback on public projects through an intuitive interactive map interface.
|
🗺️ Interactive Map Interface
📊 Comprehensive Project Data
|
🏛️ Government Transparency
💬 Citizen Engagement
|
| Frontend | Styling | Maps | Build Tool | UI Components |
|---|---|---|---|---|
 |
 |
 |
 |
 |
- ⚡ Lightning Fast: Built with Vite for optimal development and build performance
- 📱 Mobile First: Responsive design that works seamlessly across all devices
- 🎨 Modern UI: Beautiful components powered by shadcn/ui and Tailwind CSS
- 🗺️ Interactive Maps: Powered by Leaflet.js with OpenStreetMap integration
- 🔍 Type Safe: Full TypeScript implementation for robust development
📋 System Requirements
- Node.js 18+
- npm or yarn
- Modern web browser (Chrome, Firefox, Safari, Edge)
# 1️⃣ Clone the repository
git clone https://github.com/YOUR_USERNAME/kagua-citizen-map-kenya.git
cd kagua-citizen-map-kenya
# 2️⃣ Install dependencies
npm install
# 3️⃣ Start development server
npm run dev
# 4️⃣ Open your browser
# Navigate to http://localhost:5173# Build optimized production bundle
npm run build
# Preview production build locally
npm run preview- Dynamic Filtering: Switch between National and County projects
- Project Details: Click any marker for comprehensive project information
- Status Tracking: Visual indicators for Active, Completed, and Planning phases
- Budget Visualization: Clear breakdown of project allocations
- Timeline Tracking: Monitor project progress from start to completion
- Source Attribution: Transparency in data sourcing and verification
- Feedback System: Submit and view community feedback
- Rating System: Rate projects based on community impact
- Mobile Optimized: Seamless experience across all devices
We welcome contributions from developers, designers, and civic-minded individuals!
💻 For Developers
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
🎨 For Designers
- Submit UI/UX improvements
- Create better visualizations
- Enhance mobile experience
- Contribute icons and graphics
📊 For Data Contributors
- Help verify project information
- Contribute additional data sources
- Improve data accuracy
- Suggest new data fields
- Code Style: Follow TypeScript and React best practices
- Mobile First: Ensure all features work on mobile devices
- Accessibility: Maintain WCAG compliance
- Testing: Add tests for new features
- Documentation: Update docs for any new functionality
Open Source • Free to Use • Built for the People
This project is licensed under the MIT License - see the LICENSE file for details.
"To democratize access to government project information and foster transparency in public spending across Kenya"
- Transparency: Make government projects visible to all citizens
- Accountability: Enable public oversight of project progress
- Engagement: Create channels for citizen feedback and participation
- Data-Driven: Support evidence-based policy discussions
If Kagua is helping you or your community, please consider:
- ⭐ Starring this repository
- 🐛 Reporting bugs and issues
- 💡 Suggesting new features
- 🤝 Contributing code or documentation
- 📢 Sharing with others who might benefit