Skip to main content

Master Your Personal Finances

Track income and expenses, manage budgets, and gain insights into your financial health with a modern, full-stack finance application built with NestJS, React, and PostgreSQL.

Get StartedAPI Reference

Quick Start

Get Your Finance App running in minutes with these simple steps.

1

Clone the repository

Clone the repository and install dependencies using pnpm.
git clone https://github.com/RoAriel/your-finance-app.git
cd your-finance-app
pnpm install
2

Configure environment variables

Copy the example environment file and configure your database connection.
cp apps/backend/.env.example apps/backend/.env
You’ll need a PostgreSQL database. The project uses Supabase for hosted PostgreSQL, but any PostgreSQL instance will work.
3

Run database migrations

Set up your database schema using Prisma migrations.
cd apps/backend
npx prisma migrate dev
4

Start the development servers

Launch both the backend API and frontend application.
# From the root directory
pnpm dev
The backend API runs on http://localhost:3000/api and the frontend on http://localhost:5173.

Explore Features

Discover the powerful features that make Your Finance App a comprehensive personal finance solution.

Transactions

Track income and expenses with multi-currency support and intelligent categorization.

Budgets

Set monthly budgets by category and monitor spending with real-time alerts.

Accounts

Manage multiple accounts including wallets, savings, investments, and credit cards.

Categories

Organize transactions with hierarchical categories and custom icons.

Reports

Generate detailed financial reports and export to Excel or PDF formats.

Authentication

Secure JWT authentication with Google OAuth integration support.

Built with Modern Technologies

Your Finance App is built on a robust, scalable architecture using industry-leading technologies.

Backend Architecture

NestJS framework with modular architecture, Prisma ORM, and PostgreSQL database with comprehensive API design.

Explore architecture

Database Design

Relational database schema with user accounts, transactions, categories, budgets, and accounts with optimized indexes.

View schema

Comprehensive API

Access all features through a well-documented RESTful API with Swagger documentation.

Authentication API

User registration, login, and profile management with JWT tokens.

Transactions API

Create, read, update, and delete transactions with advanced filtering.

Budgets API

Manage monthly budgets and track spending against targets.

Reports API

Generate financial summaries and export data to Excel or PDF.

Resources

Additional resources to help you make the most of Your Finance App.

Best Practices

Learn recommended patterns and conventions

GitHub Repository

View source code and contribute

Deployment Guide

Deploy to production environments

Ready to Take Control of Your Finances?

Start building with Your Finance App today and create a powerful personal finance management solution.

Get Started Now