Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’Έ SpendWise β€” Expense Tracker

A beautiful and modern Expense Tracker built with React + Vite + Recharts.
Track your daily spending, view category charts, and manage your finances β€” all saved in localStorage.


πŸš€ Features

  • βœ… Add & delete expenses with title, amount, category, and date
  • πŸ“Š Interactive Pie Chart showing spending by category
  • πŸ’Ύ Data saved in LocalStorage (persists on refresh)
  • πŸ” Filter transactions by category
  • πŸ“± Fully responsive design (mobile + desktop)
  • πŸŒ™ Sleek dark theme UI

πŸ› οΈ Tech Stack

Tech Purpose
React 18 UI framework
Vite Fast build tool
Recharts Charts & data visualization
LocalStorage Data persistence
CSS3 Custom dark theme styling

πŸ“ Project Structure

expense-tracker/
β”œβ”€β”€ public/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ ExpenseForm.jsx    # Add expense form with validation
β”‚   β”‚   β”œβ”€β”€ ExpenseList.jsx    # List of all expenses
β”‚   β”‚   β”œβ”€β”€ ExpenseChart.jsx   # Pie chart visualization
β”‚   β”‚   └── Summary.jsx        # Stats cards (total, month, count)
β”‚   β”œβ”€β”€ App.jsx                # Main app + state management
β”‚   β”œβ”€β”€ App.css                # All styles
β”‚   └── main.jsx               # Entry point
β”œβ”€β”€ index.html
β”œβ”€β”€ vite.config.js
└── package.json

βš™οΈ Getting Started

1. Clone the repo

git clone https://github.com/YOUR_USERNAME/expense-tracker.git
cd expense-tracker

2. Install dependencies

npm install

3. Run locally

npm run dev

Open http://localhost:5173 in your browser.


🚒 Deploy to GitHub Pages

Step 1 β€” Build and deploy

npm run deploy

Step 2 β€” Enable GitHub Pages

Go to your repo β†’ Settings β†’ Pages β†’ Source: gh-pages branch β†’ Save

Your app will be live at:

https://YOUR_USERNAME.github.io/expense-tracker/

πŸ“‹ What I Learned

  • React useState and useEffect hooks
  • Lifting state up between components
  • localStorage for data persistence
  • Recharts PieChart with custom styling
  • Form validation in React
  • Component-based architecture

πŸ‘€ Author

Jatinmor89 β€” GitHub


πŸ“„ License

MIT License

About

πŸ’° SpendWise - A modern Expense Tracker built with React + Vite + Recharts. Track spending, view charts & manage finances.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages