Skip to content
/ budget Public

A personal finance tracker built with React. It helps you track expenses and income without requiring accounting knowledge. Each transaction is categorized, and the app provides review and reporting capabilities.

Notifications You must be signed in to change notification settings

nogo/budget

Repository files navigation

Budget

A personal finance tracker built with React. It helps you track expenses and income without requiring accounting knowledge. Each transaction is categorized, and the app provides review and reporting capabilities.

Features ✨

Core Functionality

  • 📊 Track expenses and income with categorized transactions
  • ✏️ Create, edit, and delete transactions and categories
  • 🕒 View transaction history in a clean, modern interface
  • 🐳 Simple deployment with container support
  • 🌍 Localization

Future Plans 🚀

  • 📈 Generate expense reports by category or date range
  • 🔒 User authentication (Coming Soon)
  • 📶 Offline-first functionality with PWA support (Coming Soon)
  • 🔄 Export/Import data capabilities (Coming Soon)

Screenshots 📸

Here are some screenshots of the app in action:

Home Categories
Home Category list

Technology Stack 🛠️

  • ⚛️ React
  • 🧰 TanStack Start, Query and Form
  • 🎨 Tailwind CSS
  • 🗄️ SQLite
  • 📦 pnpm

Installation & Setup ⚙️

Prerequisites

  • 🖥️ Node.js (>=23.0) and pnpm installed

Steps

  1. Clone the repository:
git clone https://github.com/nogo/budget.git
cd budget
  1. Copy the environment configuration file:
cp .env.example .env
  1. Install dependencies:
pnpm install
  1. Start the development server:
pnpm run dev

Docker Usage 🐳

Build the images

docker compose build

Run database migrations (one-time, before first launch)

docker compose run --rm budget-migrate

Start the application

docker compose up budget-app

The app will be available at http://localhost:3000.

Glossary 📚

Term Definition
Expense An amount spent on goods or services.
Income Money received from sources such as work, investments, or selling assets.
Transaction An action to add or remove an item from a collection.
Category A label used to organize transactions.

About

A personal finance tracker built with React. It helps you track expenses and income without requiring accounting knowledge. Each transaction is categorized, and the app provides review and reporting capabilities.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published