Release Notes 1.3.0

Release Notes — XPENC 1.3.0

Released 2026-08-05

The biggest release yet: passcode lock, a home screen widget, redesigned savings goals, tags & receipts, shopping lists, durable automatic backups, and a dozen smaller fixes. Fully backward compatible — the database migrates itself in place (schema v8 → v18, additive columns and five new tables), so updating over an existing install keeps every account, transaction and setting. See the Upgrade Guide before you install.

---

1. Passcode lock

Settings → Security: a 4–6 digit PIN gates the app on open, with an optional biometric (fingerprint/face) unlock layered on top.

• It's device-local — a backup taken before a passcode existed never silently turns the lock off on restore, and the passcode itself survives a backup/restore untouched.
• Off by default; turn it on whenever you want it.

2. Home screen widget

An Android widget showing your net worth at a glance, live-updated whenever the ledger changes. Tapping it opens the app; it also ships "+Expense" / "+Income" quick-add shortcuts so you can log something without opening the app first.

3. Savings Goals

A new Goals hub for saving toward a target amount, with running progress and a contribution history. (This was further redesigned into a real, transfer-funded account in the v1.3.1 beta — see the Roadmap.)

4. Tags & receipts

Both are now always-visible shortcuts in the Add Transaction app bar, not cards buried below the keypad:

• Tags — free-form labels beyond category, with autocomplete drawn from tags you've already used.
• Receipts — attach a photo to any transaction via the system file picker (no camera permission needed); the image is copied into the app's own storage immediately.

5. Shopping lists, properly

Shopping is now shopping lists — named, colour-coded lists instead of one flat list. Anything you already had migrates onto a default list automatically.

6. Prepaid Balance accounts

A new account type for a canteen key fob, gift card, or transit card — money you've already loaded onto it. Unlike Pay-later, it is not a liability: spending it draws down a real balance, exactly like Cash or Bank.

7. Durable, automatic backups

Backups now live in the public Download/BACKUP XPENC folder (via Android's MediaStore), so they survive the app being uninstalled — no storage permission needed.

• An optional schedule (daily / monthly / custom) runs opportunistically on app open, with configurable retention.
• "Find existing backups" re-indexes what's already in that folder after a reinstall, with one folder-picker consent.

Full walkthrough: Backup & Restore.

8. Clear all data

Settings → Clear all data wipes the ledger back to the same defaults a fresh install gets — after taking an automatic safety backup first. Preferences and backup history are left alone.

9. Archived Accounts / Archived Persons

Dedicated screens (More → Accounts/Persons → Archived) to review and unarchive anything you archived earlier, instead of it just disappearing from view.

10. Income & Expense Report PDF

Download a period summary — category breakdown plus the same headline numbers Stats shows — from the Stats screen, alongside the existing per-account and per-budget statement PDFs.

11. Editable person ledger entries

Tap an entry on a person's ledger to edit it (direction, account, amount, date) instead of only delete-and-redo.

12. Budget parent/child cap

A subcategory's budget can no longer exceed its parent's, in either direction — raising a child above its parent, or shrinking a parent below an existing child, is blocked. The Budgets screen now threads subcategories under their parent, indented with a connecting line.

---

Fixes in this release

• The on-screen numpad no longer overlaps the system keyboard when entering a split expense's per-category amount.
• Editing any existing budget no longer crashes — a database insert-on-conflict bug only ever targeted the primary key instead of the real constraint (one budget per category), raising an uncaught error instead of updating the row.
• Budget totals no longer double-count a parent and its children. Food ₹2,000 with Junk food ₹1,000 and Dinner ₹1,000 now correctly reads ₹2,000 budgeted, not ₹4,000 — fixed in both the Budgets screen summary and the budget statement PDF.
• Backup/restore no longer drops Recurring Rules. The Auto (recurring payments/income) feature was missing from the backup format entirely, so restoring a backup used to silently delete every recurring rule. It now round-trips correctly.
• Restoring an archived account works again — unarchiveAccount was genuinely missing before.
• Deleting a person now correctly means archiving/removing the Person themselves (mirroring Accounts), not just their ledger entries.

Known gap

The Android home-screen widget's native Kotlin/XML side hasn't been build-verified on a real device yet — flag it if it misbehaves for you, and see the Roadmap.

Upgrading

Short version: you don't need to reinstall — the database migrates itself in place from v8 to v18. But export a backup first anyway. Full walkthrough, including the one case that forces an uninstall, is in the Upgrade Guide.