Personal Finance Tracker

A personal expense, income, and assets tracking web application built with React, TypeScript, and Vite.

Features

• Dashboard — Overview of total income, expenses, assets, and net worth with expense breakdown and recent activity
• Income Tracking — Record earnings by category (salary, freelance, investments, rental, etc.)
• Expense Tracking — Categorize spending (housing, food, transport, utilities, and more)
• Asset Management — Track cash, bank accounts, investments, property, and vehicles
• Persistent Storage — All data saved locally in your browser via localStorage

Getting Started

Prerequisites

• Node.js 18+

Install & Run

npm install
npm run dev

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

Build for Production

npm run build
npm run preview

Tech Stack

• React 19 + TypeScript
• Vite 7
• React Router 7
• SASS with design tokens (primary, cancel, danger, warning)
• localStorage for data persistence

Project Structure

src/
  components/   # Reusable UI components (Layout, Modal, Forms)
  hooks/        # Finance store with React Context
  pages/        # Dashboard, Income, Expenses, Assets
  styles/       # SASS variables and global styles
  types/        # TypeScript interfaces and category definitions
  utils/        # Formatting helpers

License

See LICENSE.