Documentation

Getting Started

The first time you open Chronadra, a short setup wizard walks you through getting started:

1. Welcome — a quick introduction. Click Get Started to continue.
2. Database location — choose the folder where Chronadra will store your data. We recommend a folder inside your Documents folder so it syncs across devices automatically (see Database below).
3. Issue trackers — add the trackers you use (see Adding Issue Trackers). If the folder you chose already contains trackers from another machine, they appear here automatically, so there's nothing to re-enter.
4. Theme — pick a light, dark, or system theme.

Once you finish, you land on the Today view, ready to add your first tasks. You only see the wizard on first launch — after that Chronadra remembers your settings.

Adding Issue Trackers

Chronadra turns the ticket and epic references on your tasks into clickable links. To set this up, open Settings → Issue Trackers and add each tracker with a Title and a Base URL. When you reference a ticket on a task, Chronadra appends it to the base URL to build the link — so the base URL should end with a /.

Your trackers are stored in your database folder alongside your days and labels, so they sync with it and are available on every machine that uses the same folder. If you used an earlier version of Chronadra that kept trackers in its local settings, they are moved into your database automatically the first time you open the app — no action needed.

You can add as many trackers as you like — Jira, GitHub, GitLab, Gitea, or any other web-based tracker. Each task can be assigned to one of them, and a reference like PROJ-123 or an issue number becomes a link straight to it.

Adding Days

The Today view creates the current day for you. To record a different day — for example one you were away — open History and click Add day next to the date range picker. If you have no days yet, the button is shown on the empty page.

1. Pick the Date. It defaults to today.
2. Choose the Day type: Work, Absence - sick day, or Absence - annual leave.
3. Click Add Day. Chronadra opens the new day so you can fill it in.

You can only add a day that doesn't exist yet — if there is already a day for that date, Chronadra tells you rather than creating a duplicate. You can change a day's type at any time from the Day type menu on the day itself.

In Office Targets

On the Today view, mark each day as In Office or Remote. Chronadra keeps a running tally so you can stay on top of hybrid-work expectations.

In Settings → In Office you can set two monthly targets, each as a percentage:

• Days target — the share of all days in the month you aim to be in the office.
• Weekdays target — the share of weekdays (Mon–Fri) you aim to be in the office.

The Reports view then breaks your attendance down month by month, shows how many days or weekdays you still owe to hit each target, and rolls everything up into a year-to-date total. Set a target to 0 to hide it if you only care about one of them.

Themes

Open Settings to tune Chronadra's appearance:

• Theme — Light, Dark, or System (follows your OS setting).
• Label Display — show labels as icon only, icon + text, or text only, to suit how compact you like things.

Database

Chronadra is file-based: your days, tasks, labels, and issue trackers are stored as plain files in a folder you choose — no accounts, no servers, no lock-in. You can pick that folder during the setup wizard or change it later in Settings.

To use Chronadra on more than one machine, point each install at the same synced folder. Because it's just files, any file-syncing service works — iCloud, OneDrive, Dropbox, Nextcloud, Seafile, Syncthing, and others. Your tasks, labels, and issue trackers come along with the folder; personal preferences such as theme, label display, and in-office targets are kept per machine.