MosesChirusha/day_6_electricity_cost_calculator
Domain:
environment and energyRecord type:
softwaretools
Creator:
Mos
Host:
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 | …