A modern, full-stack personal finance management application built with React, TypeScript, and Node.js. Track your income, expenses, budget goals, and savings with an intuitive and beautiful interface.
- Real-time Overview: Get instant insights into your financial health
- Interactive Charts: Visualize spending patterns and income trends
- Smart Analytics: AI-powered financial insights and recommendations
- Customizable Widgets: Arrange your dashboard to match your preferences
- Multi-Account Support: Manage checking, savings, credit cards, and cash
- Balance Tracking: Real-time balance updates across all accounts
- Account Categories: Organize accounts by type and purpose
- Transaction History: Detailed logs of all financial activities
- Smart Categorization: Automatic expense categorization
- Receipt Upload: Store and organize digital receipts
- Recurring Expenses: Set up automatic recurring expense tracking
- Expense Analytics: Detailed breakdown of spending patterns
- Multiple Income Sources: Track salary, freelance, investments, and more
- Income Categories: Organize different types of income
- Income Trends: Analyze income patterns over time
- Tax Preparation: Export income data for tax purposes
- Smart Budgeting: Set realistic budget goals by category
- Progress Tracking: Visual progress indicators for each goal
- Monthly/Yearly Goals: Flexible time-based budgeting
- Overspending Alerts: Get notified when approaching budget limits
- Goal Setting: Create and track multiple savings goals
- Progress Visualization: See your progress towards each goal
- Target Dates: Set deadlines for achieving your goals
- Motivational Tracking: Celebrate milestones along the way
- Split Expenses: Easily split bills with friends and family
- IOU Tracking: Keep track of money owed and owed to you
- Payment Status: Mark transactions as completed
- Friend Management: Organize transactions by person
- Hover-to-convert: Move your cursor over any monetary value to instantly preview it in your chosen target currency.
- Sitewide currency: Set the default currency for the entire app based on your preference.
- Conversion toggle: Turn the on-hover conversion behavior on or off anytime.
- Target currency: Pick which currency is shown on hover when conversion is enabled.
- Managed in Settings: Go to
Settings β Currencyto configure preferences; they persist locally per device.
- React 18 - Modern UI library
- TypeScript - Type-safe development
- Vite - Fast build tool and dev server
- Tailwind CSS - Utility-first CSS framework
- shadcn/ui - Beautiful, accessible components
- React Router - Client-side routing
- React Hook Form - Form management
- Recharts - Data visualization
- ApexCharts - Advanced charting
- Node.js - JavaScript runtime
- Express.js - Web application framework
- Prisma - Modern database ORM
- PostgreSQL - Reliable relational database
- JWT - Authentication and authorization
- bcryptjs - Password hashing
- Nodemailer - Email functionality
- ESLint - Code linting
- Prettier - Code formatting
- TypeScript - Type checking
- Vite - Development server
Before you begin, ensure you have the following installed:
- Node.js (v18 or higher)
- npm (comes with Node.js)
- PostgreSQL (v14 or higher)
- Git (for cloning the repository)
git clone <your-repository-url>
cd Finanace-Flow-mainnpm installcd backend
npm installsudo apt-get update
sudo apt-get install postgresql postgresql-contrib
sudo service postgresql startbrew install postgresql
brew services start postgresqlDownload and install PostgreSQL from the official website
# Connect to PostgreSQL as superuser
sudo -u postgres psql
# Create database and user
CREATE DATABASE financeflow;
CREATE USER financeflow WITH PASSWORD 'financeflow123';
GRANT ALL PRIVILEGES ON DATABASE financeflow TO financeflow;
GRANT ALL ON SCHEMA public TO financeflow;
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO financeflow;
GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO financeflow;
# Exit PostgreSQL
\qCreate a .env file in the backend directory:
cd backend
echo 'DATABASE_URL="postgresql://financeflow:financeflow123@localhost:5432/financeflow"' > .env
echo 'JWT_SECRET="your-super-secret-jwt-key-change-in-production"' >> .env
echo 'CONTACT_EMAIL_USER="[email protected]"' >> .env
echo 'CONTACT_EMAIL_PASS="your-app-password"' >> .env# Generate Prisma client
npx prisma generate
# Push schema to database
npx prisma db push# Create a sample user and populate with data
node seed-iron-man-data.jscd backend
npm run devThe backend will be available at http://localhost:4000
# In a new terminal, from the project root
npm run devThe frontend will be available at http://localhost:5173 (or the next available port like 8080, 8081, 8082, etc.)
For testing purposes, you can use these sample credentials:
- Email:
[email protected] - Password:
password123
Note: This account comes with 6 months of sample financial data including:
- 11 different accounts (checking, savings, credit cards, cash)
- 31 expense entries across various categories
- 13 income entries from multiple sources
- Budget goals and savings goals
- Friend transactions
- Sign Up/Login: Create a new account or log in with existing credentials
- Add Accounts: Set up your bank accounts, credit cards, and cash accounts
- Track Income: Record your income sources and amounts
- Log Expenses: Add your daily expenses with categories
- Set Budget Goals: Create monthly budget targets for different categories
- Create Savings Goals: Set financial goals with target amounts and dates
- Manage Friends: Track money owed to and from friends
- Preferred Currency: Controls the currency shown across the entire UI.
- Enable Hover Conversion: When enabled, hovering a money value shows it in the target currency.
- Target Currency: The currency used for the on-hover preview.
All of the above are configurable in Settings β Currency.
- Dashboard: Get an overview of your financial health
- Analytics: View detailed charts and insights
- Accounts: Manage all your financial accounts
- Expenses: Track and categorize your spending
- Income: Record and analyze your income sources
- Budget Goals: Set and monitor budget targets
- Savings Goals: Track progress towards financial goals
- Friends: Manage shared expenses and IOUs
Finanace-Flow-main/
βββ src/ # Frontend source code
β βββ components/ # React components
β βββ pages/ # Page components
β βββ hooks/ # Custom React hooks
β βββ lib/ # Utility functions and API
β βββ ui/ # shadcn/ui components
βββ backend/ # Backend source code
β βββ prisma/ # Database schema and migrations
β βββ index.mjs # Main server file
β βββ seed-iron-man-data.js # Sample data seeder
βββ public/ # Static assets
βββ package.json # Frontend dependencies
npm run dev- Start development servernpm run build- Build for productionnpm run preview- Preview production buildnpm run lint- Run ESLint
npm run dev- Start development server
# Generate Prisma client after schema changes
npx prisma generate
# Push schema changes to database
npx prisma db push
# Open Prisma Studio (database GUI)
npx prisma studio
# Reset database (WARNING: deletes all data)
npx prisma db push --force-resetThe frontend can be deployed to any static hosting service:
-
Build the application:
npm run build
-
Deploy the
distfolder to your preferred hosting service:- Vercel
- Netlify
- GitHub Pages
- AWS S3
The backend can be deployed to various platforms:
-
Heroku:
heroku create heroku addons:create heroku-postgresql git push heroku main
-
Railway:
- Connect your GitHub repository
- Add PostgreSQL database
- Deploy automatically
-
DigitalOcean App Platform:
- Connect your repository
- Configure environment variables
- Deploy with one click
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
If you encounter any issues or have questions:
- Check the Issues page
- Create a new issue with detailed information
- Contact the development team
- shadcn/ui for beautiful components
- Tailwind CSS for styling
- Prisma for database management
- Vite for fast development
Made with β€οΈ for better financial management
