A comprehensive personal finance management web application that helps you track expenses, manage loans, and achieve your savings goals with beautiful visualizations and intuitive design.
Features • Getting Started • Tech Stack • Screenshots • Contributing
| 📊 Dashboard | 💳 Transactions | 🏦 Loans | 🎯 Goals |
|---|---|---|---|
| Financial Overview | Easy Entry | Debt Management | Goal Setting |
| Visual Analytics | Category Organization | Lending Records | Progress Tracking |
| Income & Expense Tracking | Transaction History | Outstanding Balances | Achievement Monitoring |
🎯 Get a complete snapshot of your financial health at a glance
- 💹 Financial Overview: Monitor total income, expenses, and current balance
- 📈 Visual Analytics: Interactive doughnut charts showing expense breakdown by category
- 💰 Loan Summary: Track total debt and money lent to others
- 🔍 Real-time Insights: Instant updates reflecting your latest transactions
📝 Effortlessly track every penny in and out
- ⚡ Quick Entry: Add income and expense transactions with one-click categorization
- 🏷️ Smart Categories: Organize transactions with customizable categories
- 📋 Transaction History: Beautiful table view with dates, amounts, and categories
- 🔄 Real-time Updates: See changes reflected instantly across the app
🤝 Never lose track of money borrowed or lent
- 📉 Debt Management: Record and track money you've borrowed
- 📈 Lending Records: Monitor money you've lent to friends and family
- 💳 Outstanding Balances: Clear view of remaining amounts for all loans
- 📊 Visual Separation: Distinct views for money you owe vs. money owed to you
🌟 Turn your dreams into achievable financial targets
- 🎪 Goal Creation: Set specific savings targets (e.g., "New Laptop", "Dream Vacation")
- 📊 Progress Visualization: Beautiful progress bars with percentage completion
- 🎉 Multiple Goals: Manage unlimited savings objectives simultaneously
- 🏆 Achievement Tracking: Celebrate milestones as you reach your targets
🛡️ Your financial data is protected with enterprise-grade security
- 🔑 JWT Authentication: Industry-standard token-based security
- 🚀 Easy Registration: Streamlined account creation process
- 🔒 Protected Routes: Secure access to personal financial data
- ⚡ Fast Login: Quick and secure access to your financial dashboard
| Technology | Version | Purpose |
|---|---|---|
| React | 19.1.1 | ⚛️ Modern UI with hooks and functional components |
| React Router | 7.9.1 | 🧭 Client-side routing and navigation |
| Tailwind CSS | 2.2.19 | 🎨 Utility-first CSS for responsive design |
| Chart.js | 4.5.0 | 📊 Interactive data visualization |
| Axios | 1.12.1 | 🌐 HTTP client for API communication |
| Technology | Purpose |
|---|---|
| FastAPI | ⚡ Modern, fast Python web framework |
| SQLAlchemy | 🗄️ SQL toolkit and Object-Relational Mapping |
| SQLite | 💾 Lightweight database for data storage |
| JWT | 🔐 Secure token-based authentication |
| Bcrypt | 🛡️ Password hashing for security |
| Requirement | Version | Download Link |
|---|---|---|
| Node.js | v14+ | Download |
| Python | 3.8+ | Download |
| Package Manager | npm/yarn | Included with Node.js |
🔽 Click to expand installation steps
git clone https://github.com/intronep666/Financial-Hub.git
cd Financial-Hubcd backend
# Install dependencies
pip install fastapi uvicorn sqlalchemy passlib python-jose python-multipart bcrypt
# Start the backend server
python main.py🌐 Backend will be available at
http://localhost:8000
cd frontend
# Install dependencies
npm install
# Start the development server
npm start🌐 Frontend will be available at
http://localhost:3000
| Step | Action | Description |
|---|---|---|
| 1️⃣ | Register | Create your account in seconds |
| 2️⃣ | Add Transactions | Start tracking your income & expenses |
| 3️⃣ | Set Categories | Organize your financial data |
| 4️⃣ | Create Goals | Set savings targets to work towards |
| 5️⃣ | Track Loans | Record money borrowed or lent |
| 6️⃣ | Monitor Progress | Watch your financial health improve! |
| 📊 Dashboard Overview | 💳 Transaction Management |
|---|---|
| Complete financial overview with charts | Easy transaction entry and history |
| 🏦 Loan Tracking | 🎯 Goals Progress |
|---|---|
| Track money borrowed and lent | Visual progress for savings targets |
🔐 Authentication Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST |
/register |
👤 User registration |
POST |
/token |
🔑 User authentication |
📊 Data Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET |
/summary |
📈 Financial summary data |
GET |
/transactions |
💳 Get user transactions |
POST |
/transactions |
➕ Add new transaction |
GET |
/categories |
🏷️ Get expense categories |
GET |
/loans |
🏦 Get user loans |
POST |
/loans |
➕ Add new loan |
GET |
/goals |
🎯 Get savings goals |
POST |
/goals |
➕ Create new goal |
GET |
/charts/expense-by-category |
📊 Chart data for expenses |
Contributions make the open source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!
🔽 How to Contribute
- 🍴 Fork the Project
- 🌟 Create your Feature Branch (
git checkout -b feature/AmazingFeature) - 💾 Commit your Changes (
git commit -m 'Add some AmazingFeature') - 📤 Push to the Branch (
git push origin feature/AmazingFeature) - 🔄 Open a Pull Request
Please open an issue with detailed information.
We'd love to hear it! Start a discussion and let's make it happen.
This project is licensed under the MIT License - see the LICENSE file for details.
"Building tools that make financial management accessible to everyone"
- 🚀 React Team - For the incredible framework
- ⚡ FastAPI - For making Python web development a joy
- 🎨 Tailwind CSS - For beautiful, responsive styling
- 📊 Chart.js - For stunning data visualizations
- 🌟 Open Source Community - For inspiration and support
