0.1.2+5. A “sheet”
or “dialog” is included when it represents a distinct user workflow.
Launch and first run
| Screen | How it opens | Purpose |
|---|---|---|
| Native splash and brand reveal | App launch | Holds the branded surface while the encrypted store hydrates. |
| Language select | First launch | Choose English, Sinhala, or Tamil before setup. |
| Mechanism demo | Onboarding | Explain bank-alert processing and the no-sign-up model. |
| Coverage and privacy | Onboarding | Show supported-institution context and privacy boundaries. |
| Payday setup | Onboarding | Set payday and optional expected income. |
| SMS consent / manual choice | Onboarding | Android prominent disclosure and OS permission; manual-first explanation elsewhere. |
| Start choice | Onboarding | Start fresh or load local sample data. |
| Home tour overlay | First Home visit | Point out Safe to Spend, quick add, and navigation. |
| App lock | Launch when enabled | Request biometric or device-PIN verification. |
Primary navigation
| Screen | How it opens | Purpose |
|---|---|---|
| Home | Home tab | Current cycle, Safe to Spend/over state, visual summary, budgets, recent activity, review entry point. |
| Activity | Activity tab | Searchable and filterable confirmed ledger with totals and cash-flow preview. |
| Insights | Insights tab | Category mix, income, cash flow, comparisons, and multi-month trends. |
| More | More tab | Entry point for planning, organization, automation, settings, and trust tools. |
| Transaction editor | Center + button | Add expense or income with full metadata. |
Home sheets
| Surface | How it opens | Purpose |
|---|---|---|
| Safe to Spend breakdown | Home information control | Show the complete affordability and spending-cap calculation. |
| Spent today breakdown | Tap Spent today | List the transactions behind today’s total. |
| Review stack | Tap “to review” | Confirm, recategorize, ignore, or inspect parsed bank alerts. |
| Cycle calculation settings | Home cycle edit / Settings | Edit payday, income, reserves, commitments, and spending limit. |
Transactions
| Screen or state | How it opens | Purpose |
|---|---|---|
| Activity search | Search icon | Search merchant, note, category, and labels. |
| Period picker | Activity/Insights period control | Choose standard or custom date range. |
| Account picker | Activity/Insights filter | Restrict evidence and charts to one wallet or Cash. |
| Category picker | Activity/Insights or editor | Select, search, or create a direction-safe category. |
| Label picker | Activity filter | Restrict the timeline to one label. |
| Direction picker | Activity filter | All, income only, or expense only. |
| Bulk selection | Long-press Activity row | Recategorize compatible entries or delete a set. |
| Transaction detail | Tap Activity row | Inspect source, category, account, date, labels, note, and actions. |
| Edit transaction | Pencil from detail | Modify the full transaction record. |
| Split sheet | Split from detail | Divide an exact value across categories. |
| Transfer editor | Transfer from add/detail | Create linked own-wallet movement excluded from income/spending. |
| Receipt source picker | Receipt add action | Choose camera or photo library for OCR. |
| Receipt confirmation | After OCR | Correct extracted merchant, total, date, category, and account. |
| Attachment picker/tile | Transaction editor | Add or remove a local supporting file. |
Insights and reports
| Screen | How it opens | Purpose |
|---|---|---|
| Insights overview | Insights tab | Period/account filters, category composition, cash flow, comparison, trend charts. |
| Monthly review | Calendar icon in Insights | Calendar-month income, spending, category, and timeline report. |
| Category activity | Tap category chart/row | Open the exact filtered Activity evidence. |
| Account insights | Account detail action | Open Insights with the wallet filter already applied. |
| Budget shortcut | Budgets action in Insights | Move directly from analysis to the category plan. |
Budgets and planning
| Screen or sheet | How it opens | Purpose |
|---|---|---|
| Budgets overview | More → Budgets / Insights → Budgets | Current/past cycle totals, visual plan, rows, and unbudgeted spending. |
| Add/edit budget | Budgets Add or row action | Set a category limit and rollover behavior. |
| Budget suggestions | Suggest budgets | Review conservative limits derived from local history. |
| Budget detail | Tap budget row | Pace, projection, rollover, history, alerts, and transaction evidence. |
| Move money sheet | Budgets move action | Move genuinely unspent allocation between budgets. |
| Goals | More → Goals | List savings goals and reserved progress. |
| Goal editor sheet | Add/edit goal | Set target, date, and plan. |
| Goal contribution sheet | Goal contribution action | Update locally tracked saved progress. |
| Payday runway | More → Payday runway | Project current pace through payday with daily/weekly guidance. |
| Scheduled payments | More → Scheduled payments | Upcoming projection, one-time plans, tracked recurring items, suggestions. |
| Scheduled payment editor | Add/edit plan | Configure merchant, direction, amount, account, category, and due date. |
| Record-paid confirmation | Scheduled payment action | Create confirmed Activity and retire the plan. |
Seettu
| Screen or sheet | How it opens | Purpose |
|---|---|---|
| Seettu list | More → Seettu | Active circles, next event, type, and net position. |
| Create seettu | New seettu | Choose fixed/bidding and enter the circle structure. |
| Seettu detail | Tap a circle | Schedule, contributions, payout, winners, bids, and net position. |
| Auction sheet | Record auction | Save bid, winner, commission, payout, and actual contribution. |
| Mark paid action | Due contribution | Record a contribution against the schedule. |
Accounts and organization
| Screen or sheet | How it opens | Purpose |
|---|---|---|
| Accounts | More → Accounts | Detected suggestions, active wallets, known balance overview, reconciliation state. |
| Account editor | Add/Edit wallet | Name, type, institution, matching digits, currency, rate, balance, active state. |
| Account detail | Tap wallet | Balance, reconciliation, visual movement, and wallet-filtered history. |
| Balance editor sheet | Account detail balance action | Enter a manual balance with local provenance. |
| Categories manager | More → Categories | Add, edit, reorder, and safely remove custom categories. |
| Category editor | Categories Add/Edit or picker Create | Set direction, name, icon, and color. |
| Labels | More → Labels | List label totals and open exact label activity. |
| Label activity | Tap label | Filtered confirmed transactions for the label. |
| Merchants | Settings → Merchants | Inspect locally known merchant names and rules. |
Automation
| Screen | How it opens | Purpose |
|---|---|---|
| Auto-tracking disclosure | More → Auto-tracking | Explain and request Android SMS access. |
| Automation rules | More → Automation rules | Corpus version, personal rules, feedback packages, evidence entry point. |
| Unmatched bank messages | Automation rules | Review/dismiss recognized-sender messages outside supported formats. |
| Trusted test senders | Settings → Trusted test senders | Add exact beta-test SMS/MMS numbers without weakening safety gates. |
| SMS validation lab | Development build → More | Paste a sample, inspect parse evidence, ingest, or run synthetic suite. |
| Validation report | SMS Lab suite action | Bank/message coverage and exact failure evidence. |
Settings and trust
| Screen or sheet | How it opens | Purpose |
|---|---|---|
| Settings | More → Settings | Language, appearance, cycle, merchants, security, SMS, reminders, widget, data. |
| Appearance chooser | Settings | System, Light, or Dark. |
| Currency/cycle settings | Settings → Customize cycle calculation | Payday, income, reserves, commitments, limits, wallet/reporting settings. |
| Reminder controls | Settings → Reminders section | Review, budget, recurring, seettu, lead time, time, preview privacy. |
| Widget controls | Settings → Home screen widget | Pin widget and choose whether values are visible. |
| App-lock control | Settings → Security | Enable or disable device authentication. |
| Export sheet | Settings → Export my data | Choose JSON backup or transaction CSV. |
| Restore confirmation | Settings → Restore a backup | Validate summary and require typed RESTORE. |
| Delete-all confirmation | Settings → Delete everything | Disclose exact scope and require typed DELETE. |
| Privacy & data | More → Privacy & data | Offline plain-language product privacy policy. |
| Help & feedback | More → Help & feedback | Offline FAQs and privacy-safe feedback composer. |
| Feedback composer | Help → Describe a problem or idea | Copy a support package without financial records. |
| About Salli | More → About | Version, product principles, and local-first identity. |
Debug-only and non-primary surfaces
SMS Lab and quick-fire samples appear only in debug builds. A compact legacy quick-add sheet remains in the codebase for specialized entry paths, but the current shell’s center + opens the complete transaction editor.Some rows or buttons are conditional: Android-only SMS and widget controls,
receipt capability, empty-state actions, review counts, suggested accounts,
and debug tooling appear only when applicable.