User manual

8. Budgets

Back to home

8. Budgets

A budget defines a cap (or target) for one category over a period of time. CaeliBudget continuously shows where you stand against it.

When to use it

  • Cap monthly groceries.
  • Allocate a yearly travel budget.
  • Track an income goal (e.g. quarterly revenue).

Creating a budget

In Budgets, click + New budget:

  • Category — every budget is bound to one specific category (or sub-category).
  • Amount — the target amount (stored in cents, formatted on display).
  • Period — one of:
Period Span
Weekly 7-day window
Monthly Calendar month
Quarterly 3-month block
Yearly Calendar year
  • Start date — the start of the first period; subsequent ones follow from the chosen period.
  • End date (optional) — if empty, the budget rolls forward indefinitely.

Actual vs planned

Each budget card shows:

  • planned amount,
  • actual amount in this period for the chosen category,
  • progress bar with the percentage,
  • remaining amount or overspend.

The bar colour gives quick feedback:

  • ≤ 60 % — green (comfortable),
  • 60–80 % — yellow (watch),
  • 80–100 % — orange,
  • 100 % — red (over budget).

Where else it appears

  • Dashboard — primary budgets and any warning (>80 %) are surfaced.
  • Transactions filter — one click filters the transaction list to the matching category for the budget's current period.

Edit and delete

Budgets can be edited freely (amount, period, dates). Deleting a budget does not affect any transactions — only the tracking is removed.

Typical pattern

Monthly groceries cap:

  1. Make sure Groceries is an expense category.
  2. + New budget → category Groceries, amount e.g. 400, period Monthly, start date the 1st of the month.
  3. The dashboard resets the counter automatically each month.

Related chapters

5. Categories, 9. Dashboard & statistics

Table of contents
1. Introduction
CaeliBudget is a workspace-based financial management application.
3. Workspaces
A *workspace* is the isolated unit that owns your accounts, categories, transactions and tags. A user can belong to multiple workspaces (e.g. *Household*, *Business*), and every membership is bound to a **role**.
Create or edit a workspace
This page is used to create a new workspace or update the core settings of an existing one.
Workspace onboarding
This page guides you through the first setup steps of a newly created workspace.
Workspace members
This page manages the list of users who can access the workspace and their roles.
9. Dashboard
After sign-in your home screen is the **Dashboard**: a consolidated view of your workspace's balances, spending split, budgets, savings goals and most recent transactions.
4. Accounts
An *account* represents a concrete money-holding instrument inside a workspace: bank account, cash, credit card, savings, etc. Every transaction is bound to exactly one account (a transfer touches two — source and destination).
Create or edit an account
This page is used to add a new account or update the settings of an existing one.
5. Categories
Categories let you classify transactions so statistics, budgets, and exports can group them meaningfully.
Create or edit a category
This page is used to create a new category or fine-tune an existing one.
Category statistics
This page shows the detailed activity of a selected category.
4. Transactions
A transaction is the atomic unit of CaeliBudget: every income, expense or transfer is stored as one transaction.
4.1 Create a new transaction
This page is used to quickly and accurately record a new income, expense, or transfer between accounts.
Import transactions from CSV
This page is used for bulk transaction upload from a CSV file.
7. Planned transactions
A *planned transaction* is a template that either automatically generates **real transactions** at a fixed cadence, or pre-generates **planned occurrences** that you confirm before they are booked.
Planned transaction form
This page is used to define regular income, expense, or transfer rules that either generate transactions automatically or create planned occurrences for your review.
8. Budgets
Budget form
This page is used to create or edit a budget linked to a category.
14. Savings goals
The Savings Goals module helps you separate money reserved for specific targets from day-to-day spending. Each goal is linked to a dedicated virtual account that sits beneath a savings account.
Tag list
This page shows all tags available in the workspace.
Create or edit a tag
This page is used to create a new tag or update an existing one.
Profile page
This page is used to manage your own user details and password.
Accessibility

Adjust display preferences for better readability and usability.

Keyboard shortcuts

A limited desktop-oriented shortcut set. Disabled by default.

Focus a field, then press Ctrl + Alt + Shift + a letter or digit. Press Backspace or Delete to clear the binding.
Active only on desktop or installed desktop PWA environments.
Full accessibility manual