Preferences¶

The Preferences screen allows you to customise the application's behaviour. Settings are saved locally on the device and apply to the current user.

Access

Preferences is accessed from the File menu in the menu bar. It opens as a standalone screen (desktop), outside the store tabs.

Screen layout¶

The screen has five sections organised as cards:

Theme — choose between light and dark themes.
Language — select the interface language for UI labels.
Region & Format — set date, number, and region-specific formatting.
Currency — choose the default currency for monetary displays.
Time zone — set the system time zone (owners only).

A Save button at the bottom confirms all changes at once.

Theme¶

Choose between Light and Dark by clicking the corresponding button. The theme change is applied immediately across all open screens — no restart is required.

Language, Region & Format, and Currency¶

These three settings are independent and control different aspects of the application's localization.

All settings independent

Language, Region & Format, and Currency can be combined freely. For example, you can use the English interface language with Brazilian date and number formatting and display amounts in US Dollars.

Language¶

Select the interface language for UI labels:

Português — Portuguese interface (stored as pt)
English — English interface (stored as en)
Deutsch — German interface (stored as de)

Region & Format¶

This controls how dates, numbers, and times are formatted via the browser's Intl APIs. Options cover the regional variants of each interface language:

Option	Stored as
Brasil · pt-BR	`pt-BR`
Portugal · pt-PT	`pt-PT`
United States · en-US	`en-US`
United Kingdom · en-GB	`en-GB`
Australia · en-AU	`en-AU`
Malaysia · en-MY	`en-MY`
Deutschland · de-DE	`de-DE`
Österreich · de-AT	`de-AT`
Schweiz · de-CH	`de-CH`

Currency¶

This controls how monetary amounts are displayed across all grid screens (Expenses, Cheques, Accounts, Petty Cash, Customers, Suppliers):

Option	ISO code
BRL – Real Brasileiro	`BRL`
USD – US Dollar	`USD`
EUR – Euro	`EUR`
GBP – Pound Sterling	`GBP`
MYR – Malaysian Ringgit	`MYR`
AUD – Australian Dollar	`AUD`
CHF – Swiss Franc	`CHF`

The currency only affects display formatting — it does not change the accounting system or convert between currencies.

Restart required

Changing any of these three settings (Language, Region & Format, or Currency) requires an application restart to take effect. Interface labels and formatting rules are loaded at startup and are not updated dynamically.

Time zone¶

The time zone determines how dates and times are displayed throughout the system. The list includes the most common IANA time zones.

Owners only

Only users with the owner permission can change the time zone. For other users, the field is shown as read-only, displaying the time zone set by the owner.

The time zone change is sent to the server and affects all users within the same tenant (organisation).

Settings storage¶

Setting	Where saved	Scope
Theme	Local file (`settings.json`)	Per device
Language	Local file (`settings.json`)	Per device
Region & Format	Local file (`settings.json`)	Per device
Currency	Local file (`settings.json`)	Per device
Time zone	Server (via API)	Per tenant (organisation)

Theme, Language, Region & Format, and Currency are independent per device — each installation of the application can have different settings. The time zone is shared across all users in the same organisation.

Common tasks¶

Switch to dark theme¶

In the Theme section, click Dark.
Click Save.
The theme is applied immediately.

Change the UI language¶

In the Language section, select the desired language (e.g., Deutsch).
Click Save.
Close and reopen the application for the new language to take effect.

Change the regional formatting¶

In the Region & Format section, select the desired format (e.g., Brasil · pt-BR).
Click Save.
Close and reopen the application for the new format to take effect.

Change the displayed currency¶

In the Currency section, select the desired currency (e.g., EUR – Euro).
Click Save.
Close and reopen the application for the new currency to take effect.

Change the time zone (owner)¶

In the Time zone section, select the desired time zone from the dropdown.
Click Save.
The change is sent to the server and takes effect immediately.