User Guide

Quick concepts

• Month-based: browse bills by month (swipe or arrows).
• Paid vs unpaid: paid bills count toward totals and statistics.
• Recurring bills: monthly, quarterly, or yearly bills can auto-generate into the future.
• Income (optional): when enabled, track multiple income entries per month.

Bills

Add a bill

Tap the “+” button to add a bill. The following fields are available:

• Name (required)
• Amount (optional)
• Due day (optional)
• Recurrence: one-time, monthly, quarterly, yearly
• Category: built-in categories or a custom category
• Notes (optional)

Validation

If required fields are missing, the empty fields are visually highlighted until completed.

Edit, mark paid, delete

• Tap any bill to edit it.
• Use the paid checkbox to mark a bill as paid/unpaid.
• Swipe a bill to delete, or delete from the edit screen.

Overdue bills

Bills with a due day that has passed (and are still unpaid) are automatically highlighted as overdue.

Recurring bills

Supported schedules

• One-time
• Monthly
• Quarterly
• Yearly

Auto-generation

Recurring bills are automatically generated up to the current month plus 12 months ahead, so future months are ready when you swipe forward.

Editing from a future month (series split)

If you edit a recurring bill starting from a future month, Billiary splits the series:

• Past months keep the original details.
• Updated details apply from the selected month onward.
• The older series is prevented from regenerating into the future (avoids duplicates).

Deleting from a future month

If you delete a recurring bill from a future month:

• Past occurrences are preserved.
• The selected month and all future occurrences are removed.
• Auto-generation is prevented from recreating deleted future bills.

Categories

Built-in and custom

• Billiary includes built-in categories and supports custom categories.
• Bills without a category appear under Uncategorized.

Manage categories

• Add, rename, and delete custom categories.
• Custom categories can be deleted only if they are not used by any bills.

Month filter

Category filters only show categories used in the currently selected month.

Income (optional)

Enable income tracking

Income tracking is off by default and can be enabled in Settings.

Income entries

You can add multiple income entries per month using fixed income categories:

• Salary
• Bonus
• Tip
• Other

Income summary card

• Shows total monthly income.
• Provides a “+” affordance to add entries quickly.
• Shows Available now = total income − paid bills.

Managing income

• Delete individual income entries.
• Clear all income for a month (with confirmation).

Statistics

Paid totals

• Total paid over the last 12 months.
• Per-month breakdown: paid count, total bills, total paid amount.
• Per-category paid totals (built-in and custom categories).

Income stats (when enabled)

• Total income over the last 12 months.
• Per-month income with per-entry breakdown (category + amount).

Premium features

Premium unlocks optional power features while keeping the app offline and local-only.

PDF Export

• Export your month overview and summaries as a PDF for archiving or sharing.

JSON Backup & Restore

• Create a JSON backup of your data.
• Restore from a backup to recover data or move to a new device.

Advanced statistics

• Category trends over time
• Monthly comparison
• Visual charts (bar)
• Visual charts (donut)

Multiple reminders per bill

• Set multiple reminders (e.g., 7 / 3 / 1 day before due date).
• Default reminder is 1 day before.
• Reminders are saved per bill.

Default recurring settings

• Choose the default recurrence for new bills (e.g., monthly vs one-time).

Privacy and data

• No accounts, no sign-in, no sync.
• No ads. Premium is optional and does not affect the core offline experience.
• Data is stored locally on your device.

Support

If you need help, include the app version and a short description of the issue (and screenshots if possible).