Version 1.0

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.

1

Open the Website

Launch the application by opening Main page in your web browser.

2

Read Documentation

Carefully read this documentation to understand every feature.

3

Start Using

Click the Start Using Application button to begin.

Recommended Workflow

Home Page
โ†“
Documentation
โ†“
Add Usage
โ†“
Appliance Calculator
โ†“
Bill History
โ†“
Backup Planner
โ†“
Interactive Home Planner
โ†“
Interactive Solar Planner

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
Important If the values do not match, the application displays an alert message and prevents the record from being saved.

How It Works

  1. Select a date.
  2. Enter total electricity units.
  3. Enter Morning, Afternoon, Evening and Night usage.
  4. Application validates the values.
  5. Record is saved into Local Storage.
  6. 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

  1. Enter appliance name.
  2. Enter power rating.
  3. Enter daily operating hours.
  4. Consumption is calculated instantly.
  5. Click Calculate & Add Appliance.
  6. Appliance is stored permanently.
  7. 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.
Additional Capability Even if the page is refreshed before submitting, unfinished appliance information is automatically restored using Local Storage.

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

  1. Enter battery capacity.
  2. Enter battery voltage.
  3. Specify battery efficiency.
  4. Select appliances.
  5. Click Calculate Backup Duration.
  6. 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

  1. Select the bill month.
  2. Choose the payment date.
  3. Enter the bill amount.
  4. Click Add Bill Record.
  5. Record is stored in Local Storage.
  6. Table updates automatically.

Key Features

  • Digital bill storage
  • Automatic history table
  • Delete bill records
  • Permanent browser storage
  • Easy bill management

Local Storage Key

userData
Note All bill records remain available after refreshing the page because they are stored in the browser using Local Storage.

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

  1. Open the Interactive Home Planner.
  2. Select an appliance from the Appliance Library.
  3. Drag the appliance into an empty room slot.
  4. Choose the number of hours the appliance runs each day.
  5. Repeat for all appliances in the house.
  6. The analytics panel updates automatically.
  7. The planner automatically saves all changes.
  8. 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
Automatic Save Every appliance placement, movement, removal, and hour adjustment is immediately saved inside Local Storage.

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

  1. Open the Interactive Solar Planner.
  2. Select any component from the Component Library.
  3. Drag the component onto the rooftop.
  4. Place additional solar panels to increase system capacity.
  5. Add batteries for energy storage if required.
  6. Select an inverter capable of supporting the installed panel capacity.
  7. System statistics update automatically.
  8. Planner saves the design automatically.
  9. 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

Smart Validation The planner automatically verifies whether the installed inverter capacity is sufficient for the total installed solar panel capacity. If the inverter is undersized, warning messages are displayed and calculations are temporarily disabled until a suitable inverter is added.

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
Automatic Save Every placement, movement, removal and reset operation is saved instantly inside the browser.

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.