๐Ÿ“˜ Complete Project Documentation

Personal Finance Tracker

Welcome to the official documentation of the Personal Finance Tracker. This document explains every major feature, project architecture, technologies used, workflows, and future roadmap of the application.

Version

v1.0

Premium Frontend Personal Finance Management Application

10+

Web Pages

5

Major Features

HTML โ€ข CSS โ€ข JS

Technologies

Local Storage

Data Management

Project Overview

About The Project

Learn what the Personal Finance Tracker is, why it was created, and how it helps users organize and understand their financial goals.

Purpose

Personal Finance Tracker is designed to help users understand their finances through budgeting, investment simulations, financial health analysis, and goal-based planning.

Objective

The project demonstrates how modern frontend technologies can be used to create practical, interactive, and user-friendly financial management applications.

Target Users

Students, professionals, families, beginners in financial planning, and anyone who wants to better organize their personal finances.

Highlights

Key Capabilities

The project combines multiple finance-related tools into one clean and responsive web application.

Financial Calculator

Access your monthly Financial Condition using Financial Calculator tool.

Investment Simulation

Compare investment strategies and estimate future portfolio growth using different investment profiles.

Goal Planning

Plan future financial goals using dedicated savings calculators and personalized planning modes.

Loan Calculator

Calculate your expected monthly EMI of your Loan using this tool.

Financial Health

Evaluate overall financial condition through an easy-to-understand financial health score.

Core Features

Project Modules

Personal Finance Tracker is divided into multiple financial tools. Each module solves a different personal finance problem while maintaining a consistent user experience.

Personal Finance Calculator

Calculate monthly income, expenses, savings and remaining balance with an organized financial dashboard.

Investment Simulator

Compare multiple investment strategies and estimate future wealth using compound growth calculations.

Financial Health Score

Analyze your financial condition and receive an overall financial score.

Goal Planner

Plan long-term financial goals like education, home, vacation and more.

Loan EMI Calculator

It gives user a basic idea of the expected monthly emi based on total amount and tenure.

Feature 1

Personal Finance Calculator

The Personal Finance Calculator is the foundation of the application. It allows users to organize their monthly finances and instantly calculate their remaining balance after expenses.

Purpose

Helps users understand where their monthly income is spent and how much money remains available for savings or investments.

Income Tracking

Users enter their total monthly income which becomes the starting point for every financial calculation.

Expense Categories

Includes common expenses such as rent, groceries, transportation, utilities, entertainment and many other daily costs.

Savings Calculation

Automatically calculates the remaining balance after subtracting all expenses from monthly income.

Data Storage

Every calculation can be stored inside the browser using Local Storage for quick access during future sessions.

Result Summary

Displays total income, total expenses, remaining balance and complete financial summary in an organized layout.

Workflow

Finance Calculator Process

Monthly Income
      โ”‚
      โ–ผ
Enter Expense Details
      โ”‚
      โ–ผ
JavaScript Validation
      โ”‚
      โ–ผ
Expense Calculation
      โ”‚
      โ–ผ
Remaining Balance
      โ”‚
      โ–ผ
Display Summary
      โ”‚
      โ–ผ
Save To Local Storage
Feature 2

Investment Simulator

The Investment Simulator helps users estimate future investment growth by comparing multiple investment strategies using simple financial calculations.

Purpose

Encourages users to explore long-term investing and understand how regular investments can grow over time.

Conservative Mode

Uses lower expected returns with reduced investment risk for users who prefer stable growth.

Balanced Mode

Provides moderate investment growth with balanced levels of risk and reward.

Growth Mode

Estimates higher long-term returns while assuming greater investment risk.

Compound Growth

Demonstrates how investments grow through compound returns across multiple years.

Investment Summary

Shows estimated future value, investment growth and overall performance after calculation.

Workflow

Investment Simulation Process

Select Investment Mode
        โ”‚
        โ–ผ
Enter Investment Amount
        โ”‚
        โ–ผ
Choose Time Period
        โ”‚
        โ–ผ
JavaScript Calculation
        โ”‚
        โ–ผ
Compound Growth
        โ”‚
        โ–ผ
Estimated Future Value
        โ”‚
        โ–ผ
Display Investment Summary
Feature 3

Goal Planner

The Goal Planner helps users prepare for important financial milestones through dedicated planning modes. Instead of simply estimating costs, every planner calculates savings progress, remaining amount, estimated completion time, and stores the calculation locally for future reference.

Feature Overview

The Goal Planner is a powerful financial planning module designed to help users organize, track, and achieve their future goals with confidence.


Key Features

  1. Create customized financial plans for different life goals.

  2. Calculate required savings based on target amounts.

  3. Track current savings progress toward each goal.

  4. Estimate the time required to complete financial objectives.

  5. Support multiple planning categories like education, home, car, vacation, and marriage.

  6. Provide instant calculation results using JavaScript.

  7. Display financial progress through clear and organized result cards.

  8. Store previous calculations using browser Local Storage.

  9. Offer a simple and user-friendly planning experience.

  10. Help users develop better saving habits through structured financial planning.

๐ŸŽฏ Goal Planner Hub

Landing page containing all planning categories.

๐Ÿš— Car Purchase

Plan vehicle savings.

๐ŸŽ“ Higher Education

Estimate education funding.

๐Ÿ  House Purchase

Prepare home buying savings.

๐Ÿ’ Marriage

Organize wedding finances.

โœˆ๏ธ Vacation

Save for future travel.

The Complete Documentation of Goal Planner



Goal Planner Home

The Goal Planner serves as the central navigation page for all financial goals.




Common Workflow

Every planner follows the exact same calculation process.

1 User enters Goal Cost.
2 User enters Current Savings.
3 User enters Monthly Savings.
4 Click Calculate Plan.
5 JavaScript performs financial calculations.
6 Results appear instantly.
7 Calculation is stored inside Local Storage.



Financial Calculations

Every planning mode performs the following calculations.

Calculation Formula
Savings Needed Goal Cost โˆ’ Current Savings
Time Required Savings Needed รท Monthly Savings
Progress (Current Savings รท Goal Cost) ร— 100



Local Storage

Every successful calculation is saved inside Local Storage.

Storage Key Description
financeData Stores every financial planning calculation performed by the user.

Planning Modes

Each planning mode uses the same calculation engine but is customized for different financial goals.

๐Ÿš— Mode 1 โ€” Car Purchase Planner

Designed to estimate the time required to purchase a vehicle based on the user's current savings and monthly contribution.

Inputs Outputs
Car Price Estimated Time Required
Current Savings Savings Needed
Monthly Savings Savings Progress

๐ŸŽ“ Mode 2 โ€” Higher Education Planner

Helps estimate how long it will take to save enough money for future education expenses.

Inputs Outputs
Goal Cost Estimated Time Required
Current Savings Remaining Savings
Monthly Savings Progress Percentage

๐Ÿ  Mode 3 โ€” House Purchase Planner

Calculates the estimated savings timeline for buying a future house while displaying current progress toward the goal.

Inputs Outputs
House Cost Time Required
Current Savings Remaining Savings
Monthly Savings Progress Percentage

๐Ÿ’ Mode 4 โ€” Marriage Planner

Allows users to estimate wedding savings and prepare a personalized financial roadmap for marriage expenses.

Inputs Outputs
Wedding Budget Estimated Timeline
Current Savings Remaining Savings
Monthly Savings Savings Progress

โœˆ๏ธ Mode 5 โ€” Vacation Planner

Helps users create a savings plan for future vacations by estimating the time required to reach the desired travel budget.

Inputs Outputs
Vacation Budget Estimated Time Required
Current Savings Savings Needed
Monthly Savings Progress Percentage

User Interface Components

All five planning modes follow a consistent interface to provide a familiar user experience throughout the application.

Component Purpose
Hero Section Introduces the selected financial goal and planner.
Planning Form Accepts goal cost, current savings, and monthly savings.
Calculate Button Executes the financial calculations.
Result Cards Displays calculated savings information instantly.
Financial Tips Provides practical guidance related to the selected goal.

JavaScript Functionality

Every planner uses JavaScript to perform calculations, update the interface, and save financial records.

Feature Summary

The Goal Planner transforms financial planning into a simple step-by-step process. Whether the user is preparing for higher education, buying a car, purchasing a house, planning a wedding, or saving for a vacation, each planner provides quick calculations, instant visual feedback, progress tracking, and persistent local storage.

5

Planning Modes

3

User Inputs

4

Calculated Results

1

Local Storage Database

Feature 4

Loan Calculator

The Loan Calculator helps users estimate loan payments by calculating important factors such as loan amount, interest rate, and repayment duration. It provides a clear understanding of monthly installments, total repayment cost, and interest expenses. This feature allows users to compare different loan scenarios, plan their finances better, and make smarter borrowing decisions through an interactive and simple interface.

Workflow

Loan Calculator Process

Enter Loan Details

   โ”œโ”€โ”€ Loan Amount
   โ”œโ”€โ”€ Interest Rate
   โ””โ”€โ”€ Loan Duration
      โ”‚
      โ–ผ
Validation User Input
      |
   โ”œโ”€โ”€ If Invalid
   |       |
   |       โ†“
   |    Error Message will be displayed
   |
   โ””โ”€โ”€ If Valid
      โ”‚
      โ–ผ
Results will be displayed To User
      โ”‚
      โ–ผ
User Can Modify Inputs
      โ”‚
      โ–ผ
Recalculate Results
Feature 5

Financial Health

The Financial Health Score evaluates a user's overall financial condition by analyzing important factors such as income, expenses, savings, investments, and financial goals. It provides a simple score-based overview that helps users understand their current financial stability and identify areas for improvement. This feature encourages better money management habits and supports smarter financial planning through an interactive experience.

๐Ÿ“Š How to Use Financial Health Score Feature

The Financial Health Score feature helps users understand their current financial condition by analyzing important factors such as income, expenses, savings, investments, and financial goals. It provides a simple score-based evaluation that highlights financial strengths and areas that may require improvement.


1๏ธโƒฃ Open Financial Health Score

Navigate to the Financial Health Score section from the application dashboard. The feature will display an input form where you can provide your financial information for analysis.


2๏ธโƒฃ Enter Monthly Income Details

Enter your total monthly income from all sources. This helps the system understand your earning capacity and calculate your financial stability.

Example:

Monthly Income: $3,000

3๏ธโƒฃ Add Monthly Expenses

Provide your regular monthly expenses to analyze your spending habits.

Example:

Monthly Expenses: $1,800

4๏ธโƒฃ Enter Savings Information

Add your current savings amount to evaluate your emergency preparedness and saving discipline.

Example:

Current Savings: $8,000

5๏ธโƒฃ Provide Monthly Investment Details

Enter information about your investments to measure your wealth-building efforts and long-term financial planning.

Example:

Investment Value: $5,000

6๏ธโƒฃ Add Information about current debt

Enter your current overall debt details


7๏ธโƒฃ Generate Financial Health Score

After entering all required information, click the Calculate Score button. The system analyzes your financial information and generates your score.

Analyzed Factors:

  • Income-to-expense ratio
  • Saving habits
  • Investment contribution
  • Debt ratio
  • Overall money management

8๏ธโƒฃ Understand Your Score

๐ŸŸข Excellent Financial Health

Indicates strong financial management with good savings, controlled expenses, and effective planning.

๐ŸŸก Good Financial Health

Shows stable financial habits with some opportunities for improvement.

๐ŸŸ  Needs Improvement

Indicates areas such as high expenses, low savings, or insufficient planning.

๐Ÿ”ด Poor Financial Health

Highlights financial challenges and suggests focusing on better budgeting and money management.


9๏ธโƒฃ Review Recommendations

After receiving the score, users can review suggestions to improve their financial condition.

  • Reduce unnecessary expenses
  • Increase savings
  • Start investing regularly
  • Create realistic financial goals
  • Improve budgeting habits

๐Ÿ’ก Feature Benefits

  • Understand current financial position
  • Track financial improvement over time
  • Identify weak areas in money management
  • Develop better saving habits
  • Make smarter financial decisions

This feature works as a personal finance assessment tool that encourages users to build stronger financial habits and achieve their future goals.

Workflow

Financial Health Process

Enter Financial Details
          โ†“
Analyze Financial Data
          โ†“
Calculate Health Score
          โ†“
Generate Financial Rating
          โ†“
Display Improvement Suggestions
          โ†“
Track Financial Progress