Leo Counter is a self-hosted web application that gives you complete control over your household or small-business finances. Built with Laravel 12 and React 18 using Inertia.js, it combines a powerful backend with a modern, reactive interface — all running on your own infrastructure with no data ever leaving your network.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/juanVillamilEchavarria/Leo_Counter-app/llms.txt
Use this file to discover all available pages before exploring further.
Quick Start
Get Leo Counter running in minutes with Docker and your first transaction logged.
Linux Installation
Full production install guide for Linux with systemd service configuration.
Windows Installation
Step-by-step production install for Windows using PowerShell and Docker Desktop.
Core Features
Explore transactions, budgets, reports, notifications, and more.
What Leo Counter Does
Leo Counter is built around a set of integrated modules that cover every aspect of personal and household finance:Movements
Record spontaneous, recurring, and pending transactions with file attachments.
Budgets
Create and track monthly budgets. Review historical budget performance over time.
Accounts
Manage multiple bank accounts and assign owners to each.
Categories
Classify income and expenses with a flexible category system.
Reports
Interactive KPI dashboards, income vs. expense charts, and category breakdowns.
Notifications
Email alerts for pending payments and recurring events via configurable channels.
Technology Stack
Leo Counter is built on a modern, production-grade stack:| Layer | Technology |
|---|---|
| Backend | Laravel 12 (PHP 8.2) |
| Frontend | React 18 + Inertia.js |
| Database | MariaDB (LTS) |
| Cache & Queue | Redis |
| Real-time | Laravel Reverb (WebSockets) |
| SMTP / Mailhog (dev) | |
| Deployment | Docker Compose |
Architecture Principles
Every module in Leo Counter follows Domain-Driven Design (DDD) with CQRS and Clean Architecture patterns. The codebase is organized intoDomains, Application, and Infrastructure layers — making it straightforward to extend, test, and maintain for years to come.
Architecture Overview
Understand the DDD/CQRS structure and how modules are organized.
Development Setup
Run Leo Counter locally with hot module replacement for fast iteration.
Leo Counter is open source under the MIT license. All data stays on your own infrastructure — nothing is sent to external services.