Primary action
Each Finance list puts its most-used action in the floating dock’s priority slot, because people add records far more often than they search:
Search is a top-bar icon on Transactions and Wallets (Overview’s search opens
Transactions in search). The action is only offered with the matching
permission. Where the dock has no room for it (narrow phones with every
destination shown), the shell shows it as a filled top-bar button instead.
Destinations
The dock holds Overview, Transactions, Budgets and Wallets; More opens Categories and Checkpoints. Finance has no separate Manage page: creating a wallet belongs to Wallets, and old/finance/manage links open Wallets.
Overview also opens All-wallet check directly.
Coverage: finance_manage_redirect_test.dart and app_registry_test.dart.
Periods
Transactions and a wallet page pin a period bar: previous, the period, next (never past today) and a Week / Month / Year chooser. Finance managers can also filter Transactions by tag. Both open on the current month; Transactions also offers All time, which search uses. Weeks start on Monday.Empty transactions
The empty message follows what hides the rows; the period alone never counts as a filter:- Nothing in the period: “No transactions in ” with Add first transaction.
- Kind, category, tag, creator or wallet filters hide every row: “No matching transactions” with Clear filters, which keeps the period.
- A search query matches nothing: “No results for ” with Clear search.
Wallet page
A balance card (with a workspace-currency estimate for foreign wallets and the credit limit for credit wallets) offers Transfer and Edit. Below the balance, Reconcile opens the wallet’s balance review and the checkpoint timeline opens its recorded checks. Below the pinned period bar, the period’s income, expense and net keep their labels on one line at any supported width and text size; amounts shrink to fit rather than clip, and the figures stack when three columns would be too narrow. A daily in/out chart (monthly for a year) appears once every row of the period is loaded. Transactions follow, grouped by day with each day’s net.Wallet reconciliation
Enter the observed balance to preview the signed variance against the wallet ledger. Save checkpoint records a checkpoint without changing transactions. When a check uses a different date or time, its saved details show the server-calculated historical variance. Open a checkpoint in the timeline to compare the observed and ledger balances. Wallet editors with access to the checkpoint can mark it reviewed or reopen it on web or mobile. Changes to the observed amount or time reopen the checkpoint. Review status is independent of the variance and updates across devices when the timeline refreshes. People with transaction-create permission can post a non-reporting adjustment for the checkpoint or for an unresolved interval between two checks. The server calculates the adjustment from the current ledger and skips it when the difference is zero. Wallet-update permission controls recording, editing and deleting checks. Each check uses its wallet’s currency. All-wallet check records several observations at one time. Its vertical list opens the relevant wallet, and the amount-visibility control masks variances as well as balances. The focusedwallet_checkpoint_ui_test.dart covers signed
balance inputs, variance direction and light and dark renders.
Budgets
Each budget shows its health (on track, near limit, over), what is left and what can still be spent per remaining day, counting today. Tapping a budget opens its details; Edit is offered with budget permission.Recurring transactions
Overview opens recurring transactions, with each rule’s frequency, wallet and next scheduled date. Finance managers can create, edit or delete rules. Use a negative amount for an expense and a positive amount for income. A rule uses the selected wallet’s currency and can end on a date.Invoices and subscriptions
Open Invoices from the Overview. Search by customer, open an invoice to edit its description or notes, and create invoices from catalog products. Each line uses the selected unit and warehouse. The server checks the prices and issues the invoice. Subscriptions lists outstanding group payments. Pick an entry to collect a payment for a month and select the number of months covered. Finance permissions control access, creation, editing, and deletion. Mobile keeps ambiguous saves from being submitted again until the invoice list can be checked.finance_invoices_test.dart covers opening the list, editing an invoice, and
selecting an outstanding subscription.
Reports
Open Reports from Overview and choose a wallet and calendar period. The report shows income, expense, cumulative net movement from the start of the period, and category totals in the selected wallet’s currency. Transfers and transactions excluded from reports are omitted. Amount masking hides the charts and all financial figures. For a large report, choose a shorter period.finance_report_test.dart covers period and category totals.
Cross-wallet reports include reporting-enabled wallets and use the latest
available exchange rates to estimate totals in the workspace currency. A
missing exchange rate stops the report. Invoice reports show counts by
creator and each wallet’s amount in its own currency.
Credit wallets
Credit summary shows availability, utilization, activity, statement balance, and payment dates calculated by Finance. Its payment action starts a transfer into the credit wallet. Purchases and refunds open the transaction composer with the expense or income mode selected.Wallet interest
Open Interest tracking in a wallet to view accruals, projections, historical interest, and rate history. Wallet editors can opt in to MoMo or ZaloPay tracking when Experimental Finance is on for the workspace. Existing configurations remain visible and editable with the matching wallet permissions.Transaction filters
The creator filter matches both workspace and platform creator records. A custom date range includes the selected end date in the device’s local time. Search and CSV export use the selected creator and custom date range.Invoice workflows
Start a subscription for a customer and eligible groups on the Subscriptions tab, then select the wallet and add invoice lines. Invoice editors with wallet reassignment permission can change the linked wallet. A currency change requires confirmation because the invoice retains its numeric amount. Invoice history requires workspace audit permission. Recovery uses the stored snapshot and requires the same create and delete permissions on web and mobile. Fee locks support drafting from configured tuition lines, editing quantities, locking a version, and reopening with a reason. The web app includes bulk operations, notice templates, and custom fee lines.Import and export
Finance managers can import Money Lover files from Transactions. Choose the delimiter and file, review the row count, and confirm. The file limit is 5 MB and 10,000 transactions. Each file wallet must have a uniquely named wallet in the workspace with the same currency. The receipt reports how many rows the server imported. Check the ledger if the server did not confirm an import before trying again. The export action shares a CSV for the current transaction search and filters. Exports require Finance data export permission. The all-transactions view can include transfers alongside other entries. Narrow a large export by date. Invoice exports use the invoice or pending-subscription search and require Finance data export permission. Share a CSV or Excel file for up to 5,000 matching rows. If this limit is reached, narrow the search.Hidden amounts
The eye toggle masks every figure on these screens, including balances, totals, day nets, budget meters and per-day allowances. The wallet chart is omitted while amounts are hidden, since bar heights would reveal relative sizes. Regression coverage:finance_redesign_test.dart (label fit at 320 dp and
1.3x text, empty-state variants, wallet masking, period and budget-pace
rules), finance_accessibility_test.dart (create in the dock, search in the
top bar, masking on every screen) and the Linux goldens in
finance_goldens_test.dart.
Parity with web Finance
Compare the native mini app with the standalone web Finance dashboard inapps/finance/src/app/[locale]/(dashboard)/[wsId], its shared UI in
packages/ui/src/components/ui/finance, and the mounted APIs in
apps/finance/src/app/api and packages/apis/src/finance. The entry in
apps/web links to standalone Finance.
Mobile requests use the Finance repository and its bearer-authenticated endpoint
mappings. Verify routes and response contracts before adding a new client call.