DebitMate

A JavaFX desktop application for tracking and planning your monthly direct debits and recurring payments.

Features

• Add, edit, and delete recurring payments
• Automatic monthly total calculation
• Row colour-coding — yellow for payments due within 3 days, grey for payments already taken this month
• Live search across name, category, amount, and due day
• Press Enter in any form field to quickly add or update a payment
• Export all payments to CSV
• Data stored locally in SQLite (~/.debitmate/payments.db) — no account needed

Technologies

• Java 21
• JavaFX 21
• Maven
• SQLite (via sqlite-jdbc)

How to Run

Clone the repository:

git clone https://github.com/Pouyaghp/DebitMate.git
cd DebitMate

Run with Maven:

mvn javafx:run

Or build a fat JAR and run it:

mvn package
java -jar target/debitmate-1.0.jar

Project Structure

src/main/java/com/pouya/debitmate/
  ├── DebitMateApplication.java   — JavaFX entry point, loads FXML and styles
  ├── DebitMateController.java    — UI logic / FXML controller
  ├── DatabaseManager.java        — SQLite CRUD operations
  ├── Payment.java                — immutable payment data model
  └── Launcher.java               — classpath-safe launcher wrapper

src/main/resources/com/pouya/debitmate/
  ├── debitmate-view.fxml         — UI layout
  └── styles.css                  — application stylesheet

Screenshot