/KenyaEmergency

KenyaEmergency is a centralized hub for accessing essential emergency contacts across Kenya, tailored by location—whether you need police, fire services, coast guard, or wildlife protection. Built for quick and easy access, this project is open to contributors. Check out the repository for full documentation and contribute.

Primary LanguageJavaScriptGNU Affero General Public License v3.0AGPL-3.0

KenyaEmergency 🚨🇰🇪

Welcome to KenyaEmergency, a project designed to make it easy for anyone in Kenya to quickly find emergency contacts when it matters most. Whether it’s fire, police, medical, wildlife, or coast guard services, KenyaEmergency is here to make sure you’re only a click away from essential help! Why This Project? 🌍💡

Ni Kunoma 💀

In a country with so much diversity in needs and locations, finding a central source of emergency numbers can be tough. KenyaEmergency was inspired by the need for a comprehensive, accessible platform where Kenyans can access the right contacts for the right emergencies, especially those specific to unique locations like national parks or coastal regions. How It Works 📲🚑

KenyaEmergency is structured to:

📍 Deliver relevant contacts based on your location.
🔍 Provide a search function to find numbers quickly.
🐘 Cover unique emergency needs (like Kenya Wildlife Service near parks).
🤝 Offer a community-driven way to add and validate numbers.

Plus, this project will be lightweight, fast, and easy to navigate for everyone. The repository includes detailed documentation on how KenyaEmergency was built, with insights on geolocation, backend storage solutions, and responsive design. Want to Get Involved? 🚀✨

We’re excited for contributors to join in and help make KenyaEmergency even better! Here’s how to dive in:

Fork the Repository: Click the "Fork" button to create a copy of the repository under your GitHub account.
Clone Your Fork: Clone it to your local machine by running:

bash

git clone https://github.com/your-username/KenyaEmergency.git

Create a New Branch: Branch off to keep your work separate:

bash

git checkout -b feature/amazing-new-feature

Make Changes and Commit: After you’ve coded up your changes, commit them with a short, descriptive message:

bash

git commit -m "Add new amazing feature"

Push and Submit a Pull Request: Push your branch to GitHub and head back to the original KenyaEmergency repo to open a pull request. We’ll review your work and get it ready for launch!

If you’re new to Git or pull requests, check out our Contributing Guide for more details on how to make an impactful contribution. Project Documentation 📜🛠️

In this repository, you'll find a growing collection of documentation on how KenyaEmergency was built—everything from the initial planning stages to design, development, and testing. The docs cover:

How the backend organizes and retrieves emergency data
UI/UX design choices made to keep things user-friendly
Tips on making the platform location-aware and responsive
Roadmaps for future releases

Explore the code, dive into the docs, and reach out if you have any questions. Let’s make Kenya safer, one click at a time! 🎉

With ❤️ from Juja