Nova Electricity Documentation
Welcome to the official documentation of Smart Electricity Tracker. This documentation explains every feature, calculation, workflow, and functionality available inside the application. Whether you are using the application for the first time or exploring its advanced tools, this guide will help you understand every part of the project.
Quick Information
Project
Smart Electricity Tracker
Version
1.0
Technologies
HTML5
CSS3
JavaScript
LocalStorage
Major Modules
6 Interactive Features
What's Included
Smart Electricity Tracker consists of multiple interactive modules that help users monitor, calculate and optimize electricity usage.
Usage Tracker
Record daily electricity consumption with time-wise tracking.
Appliance Calculator
Calculate electricity consumption of home appliances.
Backup Planner
Estimate backup duration based on battery capacity and connected appliances.
Bill History
Store and manage electricity bill records.
Home Planner
Design your home's electrical layout using drag and drop.
Solar Planner
Create an interactive solar installation plan.
Smart Electricity Tracker
Smart Electricity Tracker is a modern frontend web application designed to help users monitor, calculate and optimize household electricity consumption through multiple interactive tools.
Instead of simply displaying electricity information, the application allows users to record their daily electricity usage, calculate appliance consumption, estimate battery backup, manage bill history, design their home's electrical layout and even create a complete solar installation plan using interactive drag-and-drop components.
The project has been developed entirely using HTML5, CSS3 and Vanilla JavaScript without using external frameworks.
Project Objectives
โก Monitor Electricity Usage
Help users record daily electricity consumption with detailed time-wise tracking.
๐ Analyze Appliances
Calculate electricity consumed by each appliance and estimate monthly power usage.
๐ Plan Power Backup
Estimate battery backup duration during electricity outages.
โ Solar Planning
Allow users to build an interactive solar installation before actual purchase.
๐ Manage Bills
Maintain electricity bill history inside the browser.
๐ก Home Planning
Design an electrical layout for an entire home using drag and drop.
Technologies Used
| Technology | Purpose |
|---|---|
| HTML5 | Application Structure |
| CSS3 | User Interface & Responsive Design |
| JavaScript | Application Logic & Interactivity |
| Local Storage | Store user data inside browser |
| Drag & Drop API | Interactive planners |
Getting Started
Follow these simple steps before using Smart Electricity Tracker.
Read Documentation
Carefully read this documentation to understand every feature.
Recommended Workflow
Folder Structure
Smart-Electricity-Tracker โ โโโ index.html โโโ documentation.html โโโ documentation.css โโโ application-hub.html โโโ add-usage.html โโโ appliances.html โโโ backup-planner.html โโโ bill-history.html โโโ Interactive_Home.html โโโ Interactive_Home.css โโโ Interactive_Solar.html โโโ Interactive_Solar.css โโโ solar.html โ โโโ add-usage.js โโโ appliances.js โโโ backup-planner.js โโโ bill-history.js โโโ Interactive_Home.js โโโ Interactive_Solar.js โโโ solar.js
Electricity Usage Tracker
The Electricity Usage Tracker allows users to record their daily electricity consumption in a structured manner. Instead of simply entering the total electricity consumed, the application also allows users to divide their consumption into four different periods of the day.
This feature helps users understand when electricity consumption is highest and provides more accurate data for future analysis.
Primary Purpose
Record daily electricity usage and maintain a permanent history inside the browser.
Required Inputs
| Field | Description |
|---|---|
| Date | Select the day for which electricity usage is being recorded. |
| Total Units | Total electricity consumed during the day in kWh. |
| Morning | Units consumed during morning hours. |
| Afternoon | Units consumed during afternoon hours. |
| Evening | Units consumed during evening hours. |
| Night | Units consumed during night hours. |
Validation Rule
Before saving the record, the application automatically checks whether the total electricity entered matches the combined usage of all four time periods.
Morning + Afternoon + Evening + Night = Total Units
How It Works
- Select a date.
- Enter total electricity units.
- Enter Morning, Afternoon, Evening and Night usage.
- Application validates the values.
- Record is saved into Local Storage.
- The table updates automatically.
Key Features
- Daily usage recording
- Time-wise electricity tracking
- Automatic validation
- Recent entries table
- Delete records
- Automatic table refresh
- Persistent Local Storage
Local Storage Key
usageEntry
Appliance Consumption Calculator
The Appliance Consumption Calculator estimates the electricity consumed by household appliances based on their power rating and daily operating hours.
It automatically calculates both daily and monthly electricity consumption and stores every appliance permanently inside the browser.
Primary Purpose
Estimate electricity usage of individual appliances and monitor overall household consumption.
Required Inputs
| Input | Description |
|---|---|
| Appliance Name | Name of the appliance. |
| Power Rating | Power consumption in Watts. |
| Hours Used | Daily operating hours. |
Calculations
Daily electricity consumption is calculated using the following formula.
Daily Units = (Power Rating ร Hours Used) ---------------------------- 1000
Monthly electricity consumption is estimated as
Monthly Units = Daily Units ร 30
Feature Workflow
- Enter appliance name.
- Enter power rating.
- Enter daily operating hours.
- Consumption is calculated instantly.
- Click Calculate & Add Appliance.
- Appliance is stored permanently.
- Total consumption updates automatically.
Key Features
- Real-time calculation
- Daily consumption estimation
- Monthly consumption estimation
- Total household consumption
- Delete appliances
- Automatic form recovery
- Automatic Local Storage saving
Local Storage
| Key | Purpose |
|---|---|
| appliances | Stores appliance records. |
| currentForm | Temporarily stores unfinished form data. |
Power Outage & Backup Planner
The Backup Planner helps users estimate how long a battery backup system can power selected household appliances during a power outage. It also recommends the minimum battery capacity required for approximately four hours of backup.
Primary Purpose
Estimate battery backup duration and recommend the appropriate battery capacity based on appliance load.
Required Inputs
| Input | Description |
|---|---|
| Battery Capacity | Battery size measured in Ampere-hours (Ah). |
| Battery Voltage | Battery operating voltage. |
| Battery Efficiency | Expected battery efficiency percentage. |
| Appliances | Select appliances that should operate during the outage. |
Battery Energy Formula
Battery Energy = Capacity ร Voltage ร Efficiency
Backup Duration Formula
Backup Hours = Battery Energy -------------- Total Load
Recommended Capacity Formula
Recommended Capacity = (Total Load ร 4) --------------------------- Voltage ร Efficiency
Results Generated
- Total appliance load (Watts)
- Estimated backup duration
- Recommended battery capacity
How to Use
- Enter battery capacity.
- Enter battery voltage.
- Specify battery efficiency.
- Select appliances.
- Click Calculate Backup Duration.
- Review the calculated backup time.
Bill History
The Bill History module allows users to maintain a digital record of electricity bills directly inside the browser. Instead of manually keeping paper records, users can store payment information and quickly review previous electricity bills whenever required.
Primary Purpose
Maintain an organized electricity bill history with permanent browser storage.
Required Inputs
| Field | Description |
|---|---|
| Bill Month | Select the billing month. |
| Payment Date | Date when the bill was paid. |
| Bill Amount | Total amount paid for electricity. |
Feature Workflow
- Select the bill month.
- Choose the payment date.
- Enter the bill amount.
- Click Add Bill Record.
- Record is stored in Local Storage.
- Table updates automatically.
Key Features
- Digital bill storage
- Automatic history table
- Delete bill records
- Permanent browser storage
- Easy bill management
Local Storage Key
userData
Interactive Home Planner
The Interactive Home Planner allows users to visually design the electrical layout of their house by dragging appliances into different rooms. It estimates the electrical load, monthly electricity consumption, and estimated electricity bill based on appliance usage.
Primary Purpose
Help homeowners plan appliance placement, understand electricity consumption, and estimate future electricity costs before actual installation.
Module Overview
| Section | Description |
|---|---|
| Appliance Library | Collection of available electrical appliances that can be dragged into rooms. |
| Home Layout | Interactive house containing multiple rooms with appliance drop zones. |
| Analytics Panel | Displays electricity statistics calculated from all placed appliances. |
| Planning Tips | Energy-saving suggestions and electrical planning recommendations. |
| AI Recommendation | Future section reserved for AI-powered optimization features. |
Available Rooms
| Room | Purpose |
|---|---|
| Living Room | Entertainment and daily appliances. |
| Kitchen | Cooking and kitchen appliances. |
| Bedroom 1 | Main bedroom electrical planning. |
| Bedroom 2 | Additional bedroom planning. |
| Bathroom | Bathroom electrical appliances. |
| Dining Room | Dining area appliances. |
| Study Room | Computer and study equipment. |
| Garage | Garage electrical devices. |
Available Appliances
| Appliance | Typical Power |
|---|---|
| Air Conditioner | 1000 W |
| Ceiling Fan | 75 W |
| LED Bulb | 9 W |
| Television | 120 W |
| Washing Machine | 550 W |
| Microwave Oven | 1000 W |
| Desktop Computer | 250 W |
| Refrigerator | 180 W |
| Induction Cooktop | 1500 W |
Interactive Home Planner Workflow
The planner follows a simple drag-and-drop workflow. Users place appliances inside different rooms, specify daily operating hours, and the application automatically calculates electricity usage statistics.
Complete Workflow
- Open the Interactive Home Planner.
- Select an appliance from the Appliance Library.
- Drag the appliance into an empty room slot.
- Choose the number of hours the appliance runs each day.
- Repeat for all appliances in the house.
- The analytics panel updates automatically.
- The planner automatically saves all changes.
- Refreshing the page restores the saved layout.
Analytics Panel
| Statistic | Description |
|---|---|
| Total Connected Appliances | Total number of appliances currently placed inside the home. |
| Total Load | Combined electrical power of all installed appliances. |
| Estimated Monthly Units | Total electricity consumption in kilowatt-hours (kWh). |
| Estimated Monthly Bill | Estimated electricity bill calculated using the configured electricity rate. |
| Solar Coverage | Estimated renewable energy contribution when solar equipment is installed. |
| Battery Backup | Estimated backup level based on installed battery systems. |
User Controls
| Control | Function |
|---|---|
| Drag Appliance | Place appliances inside any room. |
| Increase Hours (+) | Increase appliance operating hours per day. |
| Decrease Hours (-) | Reduce daily operating hours. |
| Remove Appliance | Delete an appliance from a room. |
| Move Appliance | Drag an already placed appliance to another empty location. |
| Reset Planner | Remove all appliances and clear the planner. |
Key Features
- Interactive drag-and-drop interface
- Multiple rooms for home planning
- Automatic electricity calculations
- Daily operating hour adjustment
- Automatic analytics updates
- Reset planner functionality
- Automatic Local Storage saving
- Automatic restoration after page refresh
- Energy planning recommendations
- Future AI optimization support
Data Storage
The Interactive Home Planner automatically saves every appliance placement and its operating hours inside the browser using Local Storage. Users do not need to manually save their work. Whenever the planner is reopened, the previously designed home layout is restored automatically.
Local Storage Key
interactiveHomePlanner
Calculations Performed
| Calculation | Formula |
|---|---|
| Total Connected Appliances | Total number of placed appliances. |
| Total Load | Sum of appliance wattage. |
| Monthly Units | (Power ร Hours ร 30) รท 1000 |
| Estimated Bill | Monthly Units ร Electricity Rate |
Planning Tips Displayed
- Keep refrigerators away from direct sunlight.
- Use LED lighting for better efficiency.
- Install air conditioners on insulated walls.
- Use dedicated electrical circuits for heavy appliances.
Planned Future Improvements
- AI-powered appliance placement recommendations.
- Automatic room energy optimization.
- Seasonal electricity consumption prediction.
- Smart wiring suggestions.
- Personalized energy-saving recommendations.
- Cloud synchronization using a backend database.
Interactive Solar Planner
The Interactive Solar Planner is an advanced visual planning tool that allows users to design a complete residential solar power system before purchasing any equipment. Users can drag and place solar panels, batteries and inverters onto a virtual rooftop, compare different system configurations, estimate electricity generation, calculate monthly savings and verify whether the selected inverter is suitable for the installed solar capacity.
Primary Purpose
Help homeowners design an efficient rooftop solar installation while estimating electricity generation, installation cost, monthly savings and system capacity.
Module Overview
| Section | Description |
|---|---|
| Component Library | Collection of solar panels, batteries and inverters available for planning. |
| Virtual Rooftop | Interactive roof where all solar equipment is placed using drag and drop. |
| Analytics Panel | Displays system capacity, production, savings and installation estimates. |
| System Validation | Checks whether the installed inverter supports the selected solar capacity. |
| Planning Tips | Displays recommendations for efficient solar installation. |
Available Components
| Component | Purpose |
|---|---|
| 400W Solar Panel | Standard residential solar panel. |
| 550W Solar Panel | High-efficiency solar panel. |
| Lithium Battery | High-performance energy storage. |
| Lead Acid Battery | Economical battery storage option. |
| 3kW Inverter | Suitable for small solar systems. |
| 5kW Inverter | Supports medium residential installations. |
| 7kW Inverter | Supports larger residential systems. |
| 10kW Inverter | Designed for high-capacity installations. |
Feature Workflow
- Open the Interactive Solar Planner.
- Select any component from the Component Library.
- Drag the component onto the rooftop.
- Place additional solar panels to increase system capacity.
- Add batteries for energy storage if required.
- Select an inverter capable of supporting the installed panel capacity.
- System statistics update automatically.
- Planner saves the design automatically.
- Refreshing the page restores the saved solar layout.
Analytics Panel
| Statistic | Description |
|---|---|
| Total Solar Capacity | Total installed panel wattage. |
| Estimated Daily Generation | Expected electricity produced per day. |
| Estimated Monthly Generation | Total monthly electricity generation. |
| Estimated Monthly Savings | Expected reduction in electricity bills. |
| Estimated Installation Cost | Total estimated project cost. |
| System Status | Shows whether the selected inverter is compatible. |
User Controls
| Control | Function |
|---|---|
| Drag Component | Place equipment onto the rooftop. |
| Move Component | Reposition installed equipment. |
| Remove Component | Double-click to delete a component. |
| Reset Planner | Clear the complete rooftop layout. |
Automatic Validation
Key Features
- Interactive drag-and-drop rooftop planning
- Multiple solar panel options
- Battery installation planning
- Inverter compatibility validation
- Automatic electricity generation estimation
- Monthly savings estimation
- Installation cost estimation
- Automatic analytics updates
- Automatic Local Storage saving
- Automatic restoration after page refresh
Data Storage
Every rooftop modification is automatically stored inside the browser using Local Storage. Users never need to manually save their design. Whenever the planner is reopened, the complete rooftop configuration is restored.
Local Storage Key
solarPlannerData
Calculations Performed
| Calculation | Formula |
|---|---|
| Total Solar Capacity | Sum of installed panel wattage. |
| Daily Generation | Solar Capacity ร Average Sun Hours |
| Monthly Generation | Daily Generation ร 30 |
| Monthly Savings | Monthly Generation ร Electricity Rate |
| Installation Cost | Sum of all installed component costs. |
Solar Planning Tips
- Install solar panels facing maximum sunlight.
- Avoid rooftop shading whenever possible.
- Select an inverter matching the total panel capacity.
- Use lithium batteries for higher efficiency.
- Leave space between panels for maintenance.
Planned Future Improvements
- AI-powered rooftop optimization.
- Automatic panel angle recommendations.
- Weather-based electricity prediction.
- Shadow simulation.
- 3D rooftop visualization.
- Government subsidy estimation.
- Cloud synchronization.