keestra-ke/vacant-kenya

vacant kenya is a GPS-based housing platform that maps vacant rooms, apartments, and estates in Nairobi. It lets tenants discover, compare, and verify rentals with real photos, prices, utilities, and neighborhood data before visiting physically. # VACANT KENYA 🏠📍 **Stop walking. Start knowing.** The live housing map for Nairobi estates. See vacant single rooms, bedsitters & one-bedrooms in **Githurai, Baba Dogo, Kayole** before you even leave your chair. No more "Kuna vacant hapa?" guesswork. ### The Real Problem People still walk building-to-building asking caretakers. They don’t know water schedule, electricity stability, gate rules, visitor policy, or how the community actually lives. ### What VACANT KENYA Solves - Live housing feed (trending vacancies right now) - Exact map with building pins → floor → room - Full transparency: rent, deposit, M-Pesa, rules, utilities, photos - Tenant linking ("I live here") - Neighborhood alerts (water outage, security) - Services (movers, mama fua, plumber) tied to your exact room ### Current Status (MVP Phase 1) - [ ] User authentication - [ ] Landlord/Caretaker listing flow - [ ] Map view with pins - [ ] Basic room details (photos, price, floor, type) - [ ] Feed (new vacancies) ### Tech Stack - Mobile: Flutter - Backend: Node.js + NestJS - DB: PostgreSQL + PostGIS - Maps: Mapbox - Real-time: Socket.io ### How to Contribute (Nairobi style) 1. Fork the repo 2. Pick an issue (label: good-first-issue) 3. Work on your branch (`feature/xxx`) 4. Open PR with clear description We especially welcome devs from **Nairobi** who know how estates really work. ### Quick Start ```bash git clone github.com cd vacant-kenya # follow setup in each folder