Work / Aakalan / Wiki

Aakalan wiki

What a picture cannot hold: the rules that only break across screens, the product’s own names and numbers, and why each screen is drawn the way it is.

49 pages · last verified 2026-10-03

Concepts 8

Page	Owns
a-record-is-never-erased	An expense can be removed. The record that somebody removed it cannot.
local-first-ledger	Every write applies locally first and the server write queues behind it, so no screen in the product has a loading state.
money-in-minor-units	Every amount is an integer in its currency's minor unit, carried with the currency it was entered in, and never converted.
pro-never-gates-the-core-loop	Adding expenses, splitting them any of the four ways, settling up and exporting your data are free without limit, permanently.
reserved-money-direction	Green means "you are owed" and rose means "you owe". Nothing else in Aakalan may wear either hue.
settling-is-immediate	A settlement clears the balance the moment it is recorded, in both directions, and the other person is TOLD rather than asked.
upi-cannot-pay-a-number	A UPI intent has exactly one payee field, pa, and it takes a VPA. There is no public mapping from a phone number to one.
we-never-message-anyone	Aakalan never sends a message, an invite or a reminder on somebody's behalf. It opens the user's own messaging app with the text filled in, and they press send.

Entities 3

Page	Owns
categories	Seven expense categories, each owning one hue and one lucide icon everywhere it appears.
pricing	One Pro tier, billed individually, monthly or yearly.
tokens	The design set's palette, and where it agrees and disagrees with the Expo app.

Surfaces 35

Page	Screen
account	Everything about you: how you are paid, what currency, what the app looks like, and how to leave.
add-receipt	The add screen with a bill photographed and attached.
add-with-group	The same screen, scoped to a group.
add-with-person	The same screen, split with one person and no group.
add	One screen, three fields, Save. The most repeated action in the product.
alerts	The fifteen native dialogs the app raises, with the copy it actually ships.
balances-groups	The same balances, cut by group.
balances-search	One query over your people, your groups and the whole address book.
balances	Every person you split with, ranked, under one hero figure. The first screen after entry.
delete-account	The confirmation, with the consequences on screen before the button.
expense-personal	A solo expense — the same screen with everything about other people removed.
expense-receipt	An expense with a bill photographed, including the state where the photo has not uploaded yet.
expense	One expense in full, and the place it gets deleted.
group-new	Create a group. Only the name is required.
group-settings	Who is in this group, what currency it is in, how it settles, and how to leave it.
group-simplified	The same group with Simplify debts on — the fewest transfers that clear it.
group	One group: what you stand at, who owes whom, and what was spent.
not-found	What a detail screen shows when the thing it is about is gone.
person-claim	A settlement somebody else claimed, and the two buttons that answer it.
person	One person's running ledger, totalled across every group.
plans	Free against Pro, monthly against yearly, with the auto-renew terms on the screen.
profile	Your name, and an optional UPI ID. The last screen of onboarding.
recurring-new	A new rule — the add screen with a schedule bolted on.
recurring	The recurring rules — active, paused, and stopped.
settle-no-upi	You owe them, and there is no UPI ID to pay.
settle-pay	You owe them, and their UPI ID is on file.
settle-receive	They owe you. There is nothing to pay, only something to record.
settle-settled	All square — the state that replaced the /settle/done route.
sign-in	Phone number in, six-digit code out. The first screen of the app.
spending-solo	The same month, filtered to expenses that were only yours.
spending	The month summarised, then itemised. The whole tracker half.
splash	The one screen the OS draws rather than React.
split-sheet	How the bill divides — who is in it, in what proportion, and who paid.
verify	Six boxes, auto-submitting, with a live resend countdown.
with-sheet	Who this expense is with — people and groups in one searchable list.

Decisions 3

Page	Decided
2026-09-23-design-set-migrated-to-the-estate-standard	Aakalan's mobile design set moves to the estate standard defined in ~/git/personal/STYLE-GUIDE.md: one screen per file, a single routes.js manifest, the shared chrome bar and fl…
2026-09-23-the-bar-is-icons-and-the-sheet-is-a-journey	The demo navbar drops its breadcrumb and renders its five fixed controls as icons; the contact sheet shows one tile per screen, in journey order; and screen names stop qualifyin…
2026-10-02-context-migrated-to-the-ten-folder-standard	.context/ moves to the estate's ten folders, the store listing to fastlane's tree, and the store screenshots to a capture of the running app.