Spendex

A terminal-based personal finance tracker built with Rust. Manage your daily transactions with a clean TUI interface, categorize your spending, and keep your data stored locally.

Features

• Add transactions with category, description, amount, and date
• Categorize expenses: Eat, Transport, Entertainment, Bills, Other
• View all recorded transactions
• Delete transactions by ID
• Local JSON storage (no cloud, fully offline)
• Simple and fast terminal UI using Cursive

Requirements

• Rust 1.70 or higher
• Cargo

Installation

git clone https://github.com/hiroshiyoka/spendex.git
cd spendex
cargo build --release

Usage

Run the application:

cargo run

Adding a Transaction

1. Select a category (Eat, Transport, Entertainment, Bills, or Other)
2. Enter a description
3. Enter the amount
4. Enter the date in YYYY-MM-DD format
5. Click Save

Viewing Transactions

Click the "View" button to see all recorded transactions.

Deleting a Transaction

Click the "Delete" button and enter the transaction ID you want to remove.

Data Storage

All transactions are stored locally in tracker.json in the project directory. No data is sent to external servers.

Tech Stack

• Rust
• Cursive (TUI framework)
• Serde (JSON serialization)

License

MIT