philemon-kibor001/majidelivery
Record type:
software
Creator:
phi
Host:
💧 MajiDelivery — A water delivery web app for Eldoret, Kenya. Order clean water from verified local suppliers, track orders, and pay via M-Pesa. Built with Python & Streamlit.
# 💧 MajiDelivery — Streamlit App (Eldoret)
A clean water delivery app built with Python + Streamlit for Eldoret, Kenya.
## 🚀 Run Locally
```bash
# 1. Install dependencies
pip install -r requirements.txt
# 2. Run the app
streamlit run app.py
```
Then open localhost in your browser.
## 📱 Pages
| Page | Description |
|---|---|
| 🏠 Home | Landing page with stats & how it works |
| 🚰 Order Water | Place an order with live price calculator |
| 📦 Track Order | Find orders by phone number |
| 🚚 Suppliers | All verified Eldoret water suppliers |
| ⚙️ Admin | Manage orders, update status, track commission |
## ☁️ Deploy Free on Streamlit Cloud
1. Push this folder to GitHub
2. Go to share.streamlit.io
3. Connect your GitHub repo
4. Set `app.py` as the main file
5. Click Deploy — your app goes live in minutes! 🎉
## 🛠️ Tech Stack
- Python 3.9+
- Streamlit
- JSON file storage (swap to SQLite/PostgreSQL for production)
Built with ❤️ for Eldoret, Kenya 🇰🇪