💜 Mintro

A comprehensive personal finance management application built with modern web technologies. Track your income, expenses, savings goals, and financial progress with an intuitive and responsive interface.

✨ Features

💰 Financial Management

Multi-Wallet Support: Manage cash, credit cards, debit cards, bank accounts, and more
Transaction Tracking: Add, view, edit, and delete income/expense transactions
Real-time Balance Updates: Automatic balance calculations across all wallets
Fund Transfers: Transfer money between wallets with transaction history

🎯 Savings & Goals

Savings Goals: Set and track financial targets with progress monitoring
Linked Wallets: Connect savings goals to specific wallets
Progress Visualization: Track your journey towards financial goals

📊 Analytics & Reports

Interactive Dashboard: Overview of your financial health
Income vs Expenses: Visual breakdown of your spending patterns
Quick Statistics: Average transactions, largest expenses, savings rate
Recent Activity: Latest transactions with detailed information
Category Analysis: Track spending by category

👤 User Experience

Secure Authentication: User registration and login system
Responsive Design: Works seamlessly on desktop and mobile devices
Dark/Light Mode: Toggle between themes for comfortable viewing
Data Persistence: Secure local storage with session management

🛠️ Tech Stack

Frontend

React 18.3.1 - Modern React with hooks and context
TypeScript 5.8.3 - Type-safe development
Vite 5.4.19 - Fast build tool and development server
Tailwind CSS 3.4.17 - Utility-first CSS framework
shadcn/ui - Beautiful and accessible UI components
Radix UI - Unstyled, accessible UI primitives
Lucide React - Beautiful icons
React Router DOM 6.30.1 - Client-side routing
React Hook Form 7.61.1 - Performant forms with validation
Recharts 2.15.4 - Composable charting library

Backend

FastAPI - Modern Python web framework
PostgreSQL - Robust relational database
SQLAlchemy - Python SQL toolkit and ORM
Pydantic - Data validation using Python type annotations

Development Tools

ESLint 9.32.0 - Code linting
TypeScript ESLint - TypeScript-specific linting rules
PostCSS - CSS post-processor
Autoprefixer - CSS vendor prefixing

🚀 Getting Started

Prerequisites

Node.js 18+ and npm
Python 3.7+
PostgreSQL 12+

Frontend Setup

Clone the repository:

git clone <repository-url>
cd purple-wealth-hub-main

Install dependencies:
```
npm install
```
Start the development server:
```
npm run dev
```
Open your browser: Navigate to http://localhost:5173

Backend Setup

Navigate to backend directory:
```
cd backend
```

Create virtual environment (recommended):

python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

Install Python dependencies:
```
pip install -r requirements.txt
```

Set up PostgreSQL database:

# Create database
createdb purple_wealth_hub

Initialize database:
```
python init_db.py
```
Start the backend server:
```
python run_server.py
```
The API will be available at http://localhost:8000

📁 Project Structure

purple-wealth-hub-main/
├── src/
│   ├── api/                    # API integration modules
│   │   ├── authApi.ts         # Authentication endpoints
│   │   ├── userApi.ts         # User management
│   │   ├── walletApi.ts       # Wallet operations
│   │   ├── transactionApi.ts  # Transaction handling
│   │   ├── savingsApi.ts      # Savings goals
│   │   ├── categoryApi.ts     # Category management
│   │   └── transferApi.ts     # Fund transfers
│   ├── services/              # Business logic services
│   │   ├── themeService.ts    # Theme management
│   │   ├── storageService.ts  # Local storage utilities
│   │   ├── validationService.ts # Data validation
│   │   └── transformService.ts # Data transformation
│   ├── context/               # React context providers
│   │   └── AppContext.tsx     # Main application context
│   ├── components/            # Reusable UI components
│   │   ├── ui/               # shadcn/ui components
│   │   └── layout/           # Layout components
│   ├── pages/                # Application pages
│   │   ├── Dashboard.tsx     # Main dashboard
│   │   ├── Transactions.tsx  # Transaction management
│   │   ├── Wallets.tsx       # Wallet management
│   │   ├── Savings.tsx       # Savings goals
│   │   ├── Reports.tsx       # Financial reports
│   │   ├── Settings.tsx      # User settings
│   │   └── Auth.tsx          # Authentication
│   └── utils/                # Utility functions
├── backend/                  # FastAPI backend
│   ├── main.py              # FastAPI application
│   ├── models.py            # Database models
│   ├── schemas.py           # Pydantic schemas
│   ├── crud.py              # Database operations
│   ├── database.py          # Database configuration
│   └── api.py               # API routes
└── public/                  # Static assets

🔧 Available Scripts

Frontend Scripts

npm run dev          # Start development server
npm run build        # Build for production

Backend Scripts

python run_server.py      # Start FastAPI server
python init_db.py         # Initialize database
python test_backend.py    # Run backend tests

📊 API Endpoints

Authentication

POST /api/login/ - User login
POST /api/users/ - User registration

User Management

GET /api/users/{user_id} - Get user profile
PUT /api/users/{user_id}/profile - Update user profile

Wallets

GET /api/users/{user_id}/wallets/ - Get user wallets
POST /api/users/{user_id}/wallets/ - Create wallet
PUT /api/wallets/{wallet_id} - Update wallet
DELETE /api/wallets/{wallet_id} - Delete wallet

Transactions

GET /api/users/{user_id}/transactions/ - Get user transactions
POST /api/users/{user_id}/transactions/ - Create transaction
DELETE /api/transactions/{transaction_id} - Delete transaction

Savings Goals

GET /api/users/{user_id}/savings_goals/ - Get savings goals
POST /api/users/{user_id}/savings_goals/ - Create savings goal
PUT /api/savings_goals/{goal_id} - Update savings goal
DELETE /api/savings_goals/{goal_id} - Delete savings goal

Transfers

POST /api/users/{user_id}/transfer/ - Transfer between wallets

🎨 Features in Detail

Dashboard

Financial Overview: Total income, expenses, and net balance
Recent Transactions: Latest 5 transactions with details
Quick Statistics: Transaction counts, averages, and insights
Savings Rate: Calculate and display savings percentage

Transaction Management

Add Transactions: Income and expense tracking
Categorization: Organize transactions by categories
Date Tracking: Record transaction dates
Description: Add detailed descriptions
Balance Validation: Prevent overspending

Wallet Management

Multiple Types: Support for various wallet types
Color Coding: Visual wallet identification
Balance Tracking: Real-time balance updates
CRUD Operations: Full wallet lifecycle management

Savings Goals

Goal Setting: Set financial targets
Progress Tracking: Monitor goal completion
Linked Wallets: Connect goals to specific wallets
Target Dates: Set deadline for goals

🔐 Security Features

Secure Authentication: JWT-based user authentication
Data Validation: Input validation on both frontend and backend
Session Management: Secure session handling
CORS Protection: Cross-origin resource sharing controls

🌙 Theme Support

Light/Dark Mode: Toggle between themes
System Preference: Automatic theme detection
Persistent Settings: Theme preferences saved locally
Smooth Transitions: Animated theme switching

📱 Responsive Design

Mobile-First: Optimized for mobile devices
Tablet Support: Seamless tablet experience
Desktop Enhanced: Full-featured desktop interface
Touch-Friendly: Optimized touch interactions

🧪 Testing

Frontend Testing

# Run linting
npm run lint

# Type checking
npx tsc --noEmit

Backend Testing

# Run backend tests
cd backend
python test_backend.py

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

If you encounter any issues or have questions:

Check the existing issues in the repository
Create a new issue with detailed information
Include steps to reproduce the problem
Provide your environment details (OS, Node.js version, etc.)

🙏 Acknowledgments

shadcn/ui for the beautiful UI components
Radix UI for accessible primitives
Lucide for the icon set
FastAPI team for the excellent Python framework
React team for the amazing library

Made with 💜 for better personal finance management

Name		Name	Last commit message	Last commit date
backend		backend
public		public
src		src
LICENSE		LICENSE
README.md		README.md
bun.lockb		bun.lockb
components.json		components.json
eslint.config.js		eslint.config.js
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.ts		tailwind.config.ts
tsconfig.app.json		tsconfig.app.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

Latest commit

History

Folders and files

Repository files navigation

💜 Mintro

✨ Features

💰 Financial Management

🎯 Savings & Goals

📊 Analytics & Reports

👤 User Experience

🛠️ Tech Stack

Frontend

Backend

Development Tools

🚀 Getting Started

Prerequisites

Frontend Setup

Backend Setup

📁 Project Structure

🔧 Available Scripts

Frontend Scripts

Backend Scripts

📊 API Endpoints

Authentication

User Management

Wallets

Transactions

Savings Goals

Transfers

Categories

🎨 Features in Detail

Dashboard

Transaction Management

Wallet Management

Savings Goals

🔐 Security Features

🌙 Theme Support

📱 Responsive Design

🧪 Testing

Frontend Testing

Backend Testing

🤝 Contributing

📄 License

🆘 Support

🙏 Acknowledgments

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages