MosesChirusha/day_6_electricity_cost_calculator

A simple, offline-first electricity consumption calculator for African households. Track appliance usage, calculate costs, and reduce your electricity bill. # Electricity Cost Calculator - Africa A simple, offline-first electricity consumption calculator for African households. Track appliance usage, calculate costs, and reduce your electricity bill. **Live Demo**: Demo URL **Medium Article**: Link ## Quick Start ```bash # Clone and run git clone github.com cd day_6_electricity_cost_calculator open index.html ``` No build tools, no dependencies, no npm install. ## Features - **20+ African countries** with local currencies and rates - **18 appliance presets** (TV, fridge, AC, lights, etc.) - **Real-time cost calculations** (daily, weekly, monthly, yearly) - **Personalized saving tips** based on your usage - **Export reports** to CSV - **100% offline** functionality - **Mobile-responsive** design ## Supported Countries **East Africa:** Kenya, Tanzania, Uganda, Rwanda, Ethiopia **West Africa:** Nigeria, Ghana, Senegal, Côte d'Ivoire, Mali **Southern Africa:** South Africa, Zimbabwe, Zambia, Botswana **North Africa:** Egypt, Morocco, Tunisia **Central Africa:** Cameroon, DR Congo ## Tech Stack - **HTML5** - Structure - **CSS3** - Styling (Grid, Flexbox) - **Vanilla JavaScript** - All functionality - **localStorage** - Data persistence **Why vanilla?** Zero dependencies, works everywhere, easy to customize. ## Contributing 1. Fork the repo 2. Create feature branch: `git checkout -b feature-name` 3. Make changes (vanilla JS only) 4. Test on mobile devices 5. Commit: `git commit -m "Add feature"` 6. Push: `git push origin feature-name` 7. Open Pull Request ### Code Guidelines - Use vanilla JavaScript (no frameworks) - Comment complex calculations - Keep functions small and focused - Maintain mobile responsiveness - Test across browsers - Preserve offline functionality ## Common Appliance Power Ratings | Appliance | Power (Watts) | Typical Usage | |-----------|---------------|---------------| | LED Bulb | 10W | 5 hrs/day | | CFL Bulb | 15W | 5 hrs/day | …