TUI guide

Run

cargo run -p mambofinance-tui

The process opens an alternate terminal screen and restores the terminal on normal exit. Press Ctrl+C to quit.

Views

The sidebar exposes five record tables:

1. Transactions

2. Groups

3. Categories

4. Funds

5. Currencies

Use Up/Down or k/j in the sidebar. Use Right/l to focus the table and Left/h to return. The table uses Up/Down or k/j for row selection.

Add a record

Press a from the main panel to open the add form for the active table.

• Type into text fields; Backspace deletes one character and Ctrl+Backspace clears the field.

• Use arrow keys to move through horizontal or vertical option fields.

• Use Tab or Enter to advance and Shift+Tab to go back.

• Press Enter on the final row to submit.

• Press Escape to close the popup.

A transaction form collects name, description, integer amount, currency, day, month, year, group, category, and fund. Reference-data views collect their corresponding names; categories also select single or paired behavior.

Amount, day, month, and year must be valid whole numbers; dates must also satisfy the library's calendar rules. Currency, group, category, fund, and category variant selections are required. Invalid input or a database validation failure keeps the popup open and shows an error in the bottom status bar without writing a record.

Unimplemented actions

These actions are not yet connected or advertised in the bottom bar:

• d — delete

• e — edit

• s — sort

• f — filter

The library contains much of the underlying behavior, but the TUI handlers are not implemented. Do not interpret the visible hints as finished features.

← Back