Appearance Help

Central theme / look-and-feel editor
← All apps

Appearance — overview

This panel is the central look-and-feel editor for the whole platform. Every SAGRIS app reads the same design tokens, so a change you save here retunes all of them at once — no redeploy, no per-app edits.

How it works

Save & publish

  1. Adjust colours and sizes on the left; watch the preview update.
  2. Click Save & publish to write the changes to the shared theme (/assets/theme.json).
  3. Other apps pick up the new theme on their next load.

Use Reset to defaults to discard your changes and return to the built-in palette.

Note: Saving is admin-gated and platform-wide — what you publish here is what every user sees. Preview thoroughly before publishing. See What each control does for the meaning of each token.

What each control does

The editor groups the design tokens into four sections. Colours use a picker plus a hex field; sizes use a slider.

Surfaces

The background and panel colours that build the dark UI — page background, panel, raised panel, and the two border shades. Adjust these to change the overall "depth" of the interface.

Text

The four text brightnesses, from primary (brightest) through body, muted, and dim. Keep enough contrast against the Surfaces colours for readability.

Accents

The semantic colours: Blue/signal (primary highlight), OK/green, Warning, and Error. These drive buttons, badges, and status messages across every app.

Type & shape

ControlEffect
Body fontBase UI/text size.
Heading fontTitle-bar / heading size.
Corner radiusRoundness of buttons, cards, and inputs.
Sidebar widthWidth of the left sidebar in the apps that have one.

How sizes scale

The font and spacing tokens are fluid — they scale with the viewport (balanced across width and height) so the UI keeps its proportions on any monitor. The sliders here set the baseline that the fluid scaling builds on.

Tip: Change one group at a time and watch the live preview. If something looks wrong platform-wide after publishing, Reset to defaults restores the canonical palette.