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 three sections organised as cards:

Theme — choose between light and dark themes.
Language — select the interface language.
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¶

Select the interface language from the dropdown:

Português (BR) — Brazilian Portuguese
English (US) — American English

Restart required

Language changes require an application restart to take effect. Interface labels 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
Time zone	Server (via API)	Per tenant (organisation)

Theme and language 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 language to Portuguese¶

In the Language section, select Português (BR).
Click Save.
Close and reopen the application for the new language 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.