Documentation
Everything Pulsaria can do
Written for the version you can download today. Every screen, every field, every connector — and the exact rules behind the numbers.
New here? Start with What Pulsaria is →
01
Getting started
Install Pulsaria, understand the idea behind it, and get your first number on the board.
- What Pulsaria is A local-first KPI tracker for macOS that answers one question every day: am I on pace for my target?
- Install & first launch System requirements, installing the DMG, what macOS asks on first open, and the welcome wizard and guided tour on your first launch.
- Your first KPI A walkthrough: create a project, add a manual KPI field by field, record today's value, read the card — then the same for a connector KPI.
02
KPIs
How a KPI is put together: goal, period, direction, status — and how values get in.
- Anatomy of a KPI Every field of a KPI definition explained — name, unit, target, direction, KPI type, scope, period and data source — and what changes when you edit one later.
- Periods & targets How Pulsaria derives the start and end of a KPI period, what happens at rollover, and how the target is read for cumulative and recurring KPIs.
- Ideal line & status How Pulsaria works out where you should be today, the exact thresholds behind on track, at risk and off track, and what the gap and change numbers mean.
- Entering values The Daily Entry screen, the quick entry dialog, backfilling older dates, what happens with two values on one day, and which number formats the field accepts.
- Projects How projects group KPIs: creating and editing, the three status values, moving KPIs between scopes, dashboard grouping and what deleting a project removes.
03
Data sources
Manual entry, ready-made connectors, your own HTTP endpoints, shell commands, schedules.
- Overview Manual, Connector, HTTP and Bash compared: what each needs, when it runs, how the test run works, and why a changed command has to be approved again.
- Connectors The Connector Library, how a connection is set up, where credentials are stored, and every metric the six shipped connectors offer.
- Custom HTTP sources Build a KPI on any JSON API: URL, headers, date tokens, the JSON path syntax, the approval step, the test run and every error message you can get.
- Shell commands Feed a KPI from a shell command on your Mac: what the command must print, the environment it runs in, the 10-second timeout, and the approval model.
- Schedules & refresh How cron schedules work in Pulsaria: presets, accepted syntax, the 60-second tick, catch-up after the app was closed, manual refresh and the daily reminder.
04
Screens
What every screen shows you and which actions live where.
- Dashboard Everything on the Pulsaria dashboard: summary pills, groups, the KPI card piece by piece, alerts, hints, the refresh button and the empty states.
- KPI detail The screen for a single KPI: header badges, stat pills, the trend chart and its range switch, today's entries, status changes, history table and actions.
- Weekly review The print-friendly review screen: what each row shows, how the 7-day change is computed, when it stays empty, and how printing to PDF works.
- Fetch log The record of every automatic fetch: what a row means, success vs failure vs skipped, the expanded detail, filters, retention and how to debug a broken source.
05
Your data
Where your files live, how to sync and back them up, and what never leaves your Mac.
- Where your data lives The exact folder Pulsaria writes to, what each file holds, how to move it elsewhere, and what the app protects against.
- Backup & transfer Export as JSON or CSV, schedule a daily backup, import an export with per-item conflict resolution, and move Pulsaria to a new Mac.
- Privacy A complete list of every outbound connection Pulsaria makes, when each one happens, and what it carries.
06
Licence & app
Trial, licence, activation, settings, and what to do when something breaks.
- Trial & licence How the 30-day trial works, what read-only mode blocks, and how to buy, activate, move and re-check your Pulsaria licence.
- Settings Every setting in Pulsaria — language, theme, reminders, data folder, backups, crash reporting and updates — with what it does and its default.
- Troubleshooting Problem, cause and fix for the failures Pulsaria can actually produce: failed or skipped fetches, silent schedules, missing numbers, imports and updates.
Didn't find it?
Write to us — a real person reads every mail, usually the one who wrote the feature.
admin@one-pixel-ahead.com