4 4.19 Metrics
github-actions[bot] edited this page 2026-10-21 06:39:46 +00:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Metrics

Metrics in Super Productivity are per-day and context-based data used to review how you worked: raw inputs you enter or that the app records (e.g. focus sessions, impact rating, energy check-in, reflections), and derived values computed from that data (e.g. aggregates over a date range, charts). The app persists the raw daily fields and computes aggregates and charts on demand so you can see both “what happened that day” and “how that compares over time.” Understanding what is stored vs computed, what each metric represents, and where metrics appear in the app helps you use the evaluation sheet, metrics view, and sharing effectively.

Reflections are one of the persisted daily fields; see 4.18-Reflection. Focus sessions are logged into the daily record; see 4.15-Timers-and-Focus-Mode. Evaluation and metrics settings are in 3.02-Settings-and-Preferences.

What Daily Metrics Are Tracked?

The app tracks per-day data in two categories: persisted (stored as part of that day’s record) and computed (calculated when you open a view or report).

Persisted Daily Fields

Each day has a metric record identified by the date. The app stores:

  • Date — The day this record belongs to.
  • Focus sessions — A list of focus-session durations (from Focus Mode) for that day. The app appends a duration when you complete a focus session.
  • Evaluation fields — Notes, “remind tomorrow,” and reflections (freeform text; see 4.18-Reflection). These are what you enter in the evaluation sheet.
  • Impact rating — Your 1–4 rating of how impactful your work was that day.
  • Energy check-in — Your 1–3 rating of how you felt (e.g. exhausted / okay / good).
  • Work and task counters — Total work minutes (or derived from worklog), completed task count, and planned task count for that day, when the app records them.

So “what the app remembers for a day” is: date, focus sessions, notes/remind/reflections, impact, energy, and work/task totals. Everything else you see (averages, charts) is computed from this stored data plus worklog and task data when you open the relevant view.

Computed on Demand

The app does not store these; it calculates them when needed:

  • Aggregate metrics (simple metrics) — For a chosen date range and context (see below), the app computes: total time spent, total break time and break count, task counts (completed, total, subtasks, etc.), days worked in the range, and averages (e.g. average time per day, average time per task, average breaks per day). These are derived from worklog, break data, and task lists. Tasks finished as won't do are not counted as completed.
  • Chart data — Line charts of your impact and energy ratings over time (and other series like focus sessions or simple-counter data). The underlying numbers come from the stored daily records and counters. The impact and energy chart only includes days you rated, so its timeframe options count rated days rather than calendar days.

So when you open the metrics view, the app loads the stored daily records and then computes aggregates for the range and context you’re looking at. Global chart series are shown in the Today metrics view.

Persisted Vs Computed: Why It Matters

  • Persisted — Stored in your data (and synced if you use sync). You can edit or add it (e.g. impact, energy, reflections); the app only appends focus sessions and updates work/task counters as you work. This is the “source of truth” for that day.
  • Computed — Not stored as separate numbers. If you change a persisted value (e.g. impact) or add more focus sessions, the next time you open the metrics view the aggregates and charts recalculate. So you always see numbers and charts that match the current stored data.

That split keeps storage simple (one record per day with a fixed set of fields) while still giving you summaries and charts over time.

What Parts of the App Use These Metrics?

  • Metrics view — Shows a table of aggregate metrics (time spent, time estimated, tasks done/created, days worked, averages for time per day, time per task, breaks, etc.) for the current work context. When your context is today (the “all tasks” / today view), the table reflects metrics across all your tasks for the configured range; when your context is a project, the table reflects only that project’s tasks and worklog. The Today metrics view can also show global line charts of impact and energy ratings, focus sessions, and simple-counter data over time.
  • Evaluation sheet — For a single day, shows and edits the persisted fields (reflections, impact, energy). The day’s total time, and its focused time when you completed focus sessions, are shown in the daily summary header above it. It does not compute a score; the ratings are kept as you entered them.
  • Share / summary — When you use the share or “work summary” feature, the app builds a summary from the aggregate metrics (and optionally the current project or today context), so the shared text reflects the same numbers you see in the metrics table for that context and range.
  • Charts — Line charts (e.g. impact and energy over the last N days) are shown in the Today metrics view and are drawn from the stored daily records; they don’t have a separate stored “chart” object.

So: persisted data is edited and viewed in the evaluation sheet (and focus sessions are added automatically); computed aggregates are shown in the metrics view and share summary, while global charts are shown in the Today metrics view.

How Context Affects Metrics

The aggregate metrics table (time spent, task counts, averages, etc.) is context-sensitive:

  • Today / all tasks — The app uses all tasks and the full worklog to compute totals and averages. So you see “everything” for the selected range.
  • Project — The app uses only tasks in the current project and worklog for that project. So you see project-specific totals and averages.

The evaluation sheet is always per day (one date at a time). The impact and energy chart covers a date range from the stored daily records; it is not restricted by project—it uses the global daily metric records and appears in the Today metrics view.

Summary

  • Persisted per day: date, focus sessions, notes, remind tomorrow, reflections, impact (1–4), energy (1–3), total work minutes, completed/planned task counts.
  • Computed on demand: aggregate metrics (time spent, breaks, task counts, averages over a range) and chart data.
  • Where you see them: evaluation sheet (per-day inputs), metrics view (aggregate table by context, global charts in Today), share summary (aggregates for current context).