💼 FinSmart AI

A modern personal finance management dashboard built with React, TypeScript, Vite, and Tailwind CSS.
FinSmart AI helps users analyze income, expenses, savings, and spending trends intelligently with a clean and interactive UI.

---

🚀 Features

• 📊 Dashboard Overview – Track total income, expenses, balance, and savings at a glance.
• 💸 Transaction Management – Add transactions manually or upload via CSV.
• 🎯 Spending Targets – Set and monitor spending limits by category.
• 📈 Reports & Analytics – View month-wise and year-wise reports with dynamic charts.
• 🤖 AI Insights – Get intelligent recommendations for budgeting and savings.
• 📥 PDF Export – Download comprehensive financial reports in one click.

---

🖼️ Project Preview

Dashboard Overview

Budget Progress

Transactions

Reports & Summary

---

🛠️ Tech Stack

• ⚡ Vite – Lightning-fast development environment
• ⚛️ React + TypeScript – Component-based and type-safe development
• 🎨 Tailwind CSS – Utility-first responsive styling
• 🧩 shadcn/ui – Modern reusable UI components
• 🧠 Lucide Icons – Clean and customizable icon set

---

📂 Folder Structure

FineWave-AI-Main/ │ ├── src/ │ ├── components/ # UI and shared components │ ├── hooks/ # Custom React hooks │ ├── lib/ # Helper and utility functions │ ├── pages/ # Main application pages (Dashboard, Reports, etc.) │ ├── App.tsx │ ├── main.tsx │ ├── index.css │ └── App.css │ ├── public/ │── .gitignore │── package.json │── tailwind.config.ts │── vite.config.ts │── tsconfig.json └── README.md

---

⚙️ Setup Instructions

Follow these steps to set up the project locally:

# 1️⃣ Clone the repository
git clone https://github.com/<your-username>/FinSmart-AI.git

# 2️⃣ Navigate into the project directory
cd FinSmart-AI

# 3️⃣ Install dependencies
npm install

# 4️⃣ Run the development server
npm run dev


#🚫 Files Ignored from Git

#The following files and folders are ignored to keep the repository clean:

node_modules/

dist/, build/, and temporary cache files

Environment variables: .env, .env.local

Editor/IDE settings: .vscode/, .idea/

Log files: *.log

OS junk files: .DS_Store, Thumbs.db


#📜 License
This project is open-source and available under the MIT License.

#👨‍💻 Author
FinSmart-AI Team
3rd Year B.Tech Student | Web Developer | AI Enthusiast


#⭐ If you like this project, consider giving it a star on GitHub!

Thanks! TEAM FinSmart-AI