Skip to Content
Docs

Web app and customization

Surfaces

Route / pageWhoPurpose
Landing /PublicDocs link, sign-in
Home /homeSigned-inPersonal struggle summary
StatsSigned-inBreakdowns, projects, ranges
BuildersSigned-inLeaderboard (opt-in)
SettingsSigned-inProfile, customize, danger zone
Review / fraudStaff rolesSubmission queue and anomalies
/docs/PublicFumadocs site

SPA navigation lives in server/static/app.js. Docs always open the Fumadocs export at /docs/.

Dashboard customization

Settings -> Customize (and the home customize drawer):

ControlWhat it changes
Metric modeHow primary hours/struggle metrics are framed
Calibration presetAlign display with labelled formula expectations
Layout / densityCompact vs roomy dashboard chrome
Colour schemeToken-driven palette (shared with docs CSS variables)

Preferences persist for the signed-in account. Docs and SPA share the same design tokens.

Builders leaderboard

  • Aggregates verified weighted hours across opted-in builders
  • Structural totals only (no file trees or prompts)
  • Opt-out controls live in Settings; leaving the board does not delete private history

Roles and guards

RoleCapabilities
UserOwn projects, keys, stats, customize, opt-out
Reviewer / staffReview queue, reason codes, deflations
AdminElevated fraud tools, dangerous account ops

The SPA hides staff nav for non-staff. The API enforces the same guards.

Danger zone

Settings -> Danger zone:

  • Regenerate or revoke API keys (invalidates daemon auth immediately)
  • Destructive account or data actions require explicit confirmation
  • Soft-delete paths keep analytics filters from resurfacing PII

Stop the daemon or run struggletime apikey after rotating keys.

Settings navigation

  • Docs in the Settings rail goes to /docs/.
  • Daemon in the Settings rail goes to /docs/tray/.

Also: Review, API, Getting started.

On this page