https://github.com/silvauncompte/dbudget
Simple web app to track expenses, manage budgets, and monitor savings.
https://github.com/silvauncompte/dbudget
budget-app budget-manager budget-tracker savings-calculator savings-tracker tool
Last synced: 19 days ago
JSON representation
Simple web app to track expenses, manage budgets, and monitor savings.
- Host: GitHub
- URL: https://github.com/silvauncompte/dbudget
- Owner: SilvaUnCompte
- License: other
- Created: 2023-09-10T14:28:10.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-06-04T06:42:26.000Z (25 days ago)
- Last Synced: 2026-06-04T08:17:27.771Z (25 days ago)
- Topics: budget-app, budget-manager, budget-tracker, savings-calculator, savings-tracker, tool
- Language: JavaScript
- Homepage:
- Size: 1.25 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Epargne-Controle
## Description
**Epargne-Controle** is a web application designed to help users track and manage their expenses and savings. It all started because, like many students, I had to keep an eye on my budget if I wanted to eat something other than pasta at the end of the month. And, being lazy, I didn't want to learn how to use an existing solution... so I spent even more time building my own. Classic programmer logic ahah.
**IMPORTANT:** This project NEVER interacted with any banking APIs or services. It is purely for personal budget management and does not handle any real money transactions.
## Features
- Manage multiple accounts (checking, savings)
- Record and categorize operations (income, expenses, transfers)
- Create and manage regular events (recurring transactions)
- Budget tracking and analytics (charts, forecasts, CSV export)
- Transaction history and verification
## Technologies Used
- PHP (backend logic)
- MariaDB (database)
- Smarty (template engine) - Will be replaced in future versions
- JavaScript (frontend logic, Chart.js for data visualization)
- Vanilla HTML/CSS
## Installation
1. Clone the repository:
```sh
git clone https://github.com/SilvaUnCompte/epargne-controle.git
```
2. Set up a local web server (e.g., XAMPP) and place the project in the `htdocs` directory.
3. Configure the database with .env file or directly in the code (`database/connexion.php`).
4. Import the database schema (see `database/tables/` for table definitions).
5. Access the app via `http://localhost/epargne-controle` in your browser.
## Usage
1. Register or log in with your email and password.
2. Create accounts (checking/savings) and set initial balances.
3. Add operations (income, expenses, transfers) and categorize them.
4. Set up regular events for recurring transactions (e.g., monthly rent).
5. View analytics and budget charts to monitor your financial health.
6. Export data as CSV if you're crazy about statistics (or just want to analyze your data further).
## Folder Structure
- `assets/` - Images and vendor libraries
- `controler/` - PHP controllers for CRUD operations and page rendering
- `database/` - Database connection and table definitions
- `public/` - Frontend assets (JS, CSS, templates)
- `public/templates/` - Smarty templates for UI pages
## License
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. See the [LICENSE](LICENSE) file for details.