Skip to content

eugeniogiusti/budgeting-app

Repository files navigation

BudgetKit logo

BudgetKit

Take control of your finances.
Open source personal finance manager — built with Laravel & Tailwind CSS.

Laravel 12 Tailwind CSS Beta GPL-3.0 License

budgetkit-topaz.vercel.app

⚠️ Beta project — core features are stable, but some sections are still under active development.


Demo

BudgetKit Demo


What is BudgetKit

BudgetKit is a web application for personal finance management. It lets you track income and expenses, set a monthly budget per category, monitor savings goals and visualize spending statistics — all with a clean interface including dark mode.

The layout automatically adapts to the device: desktop interface with sidebar and tables, mobile interface with gradient UI and bottom tab navigation — no app to install.


Screenshots

Desktop Mobile
BudgetKit desktop BudgetKit mobile

Features

  • Dashboard — instant overview: available balance, total assigned, active goals
  • Transactions — record income and expenses, filter by type and month
  • Budget — assign a monthly budget per category, copy budget from previous month
  • Goals — create savings goals with target amount and visual progress
  • Statistics — donut chart by category + monthly income/expenses trend (6 months)
  • Categories — manage custom categories with emoji and color
  • Settings — language (IT/EN) and currency (EUR, USD, GBP, CHF)
  • Export/Import CSV — export and import all transactions
  • Auth — registration and login, profile with name/email/password editing
  • Dark mode — native support
  • Multi-language — Italian and English
  • Automatic responsive — desktop layout with sidebar on PC, optimized mobile layout on smartphone (User-Agent detection)

Tech Stack

Layer Technology
Backend Laravel 12 (PHP 8.2+)
Frontend Blade, Tailwind CSS v4, Alpine.js
Charts ApexCharts
Database SQLite (default) / MySQL / PostgreSQL
Base template TailAdmin Laravel

Installation

Requirements

  • PHP 8.2+
  • Composer
  • Node.js 18+

Setup

# 1. Clone the repository
git clone https://github.com/eugeniogiusti/budgeting-app
cd budgeting-app

# 2. Install PHP dependencies
composer install

# 3. Install JS dependencies
npm install

# 4. Configure the environment
cp .env.example .env
php artisan key:generate

# 5. Configure the database in .env, then run migrations
php artisan migrate

# 6. Build assets
npm run build

# 7. Start the server
php artisan serve

License

Distributed under the GNU General Public License v3.0. See LICENSE for details.

In short: you are free to use, modify and distribute this software, but derivative works must be released under the same GPL-3.0 license.

About

Budgetkit - Self-hosted personal finance manager. Track income, expenses, budgets and savings goals. Built with Laravel & Tailwind CSS.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors