Branding basics
App name, logo, colors, fonts, theme presets, and renamable terminology
Brand basics are available in every customization mode and cover the identity layer: what your platform is called, what it looks like at a glance, and what its product nouns are.
Identity
| Setting | What it controls |
|---|---|
App name (appName) | The product name rendered across the dashboard, emails, and page titles |
Logo (logoUrl) | Full logo shown in the sidebar header |
Icon (iconUrl) | Square mark used for favicons and compact placements |
Hide badge (hideBadge) | Removes the "built with" badge from customer surfaces |
Branded links
Five URLs let you point built-in actions at your own properties. Each must be a valid http(s) URL:
| Setting | Where it's used |
|---|---|
supportUrl | Support links in the dashboard |
docsUrl | Documentation links |
upgradeUrl | Upgrade prompts and plan CTAs |
buyDomainUrl | Domain-purchase pointers |
loginUrl | Where signed-out customers are sent |
Colors
Three layers, from simplest to most control:
- Accent color — a single brand color (
primaryColor/accentColor, or a curated color scheme). It becomes the--brandand--accentdesign tokens and drives buttons, links, and highlights. - Surface skins — a gallery of curated full light + dark palettes mapped onto the token ladder: Default, Dracula, Nord, Gruvbox, Catppuccin, Tokyo Night, Solarized, One Dark, and Rosé Pine. Each skin ships its own accent swatches; you can pick one of those or keep your custom color.
- Custom theme — set every core token yourself, per mode, in the advanced editor. See Design tokens.
You can also lock your customers to a single mode (modeLock) or leave light/dark switching to them (colorScheme).
The studio warns when a text/background pair falls under a 4.5:1 contrast ratio, the WCAG AA threshold for body text.
Fonts
A curated list of twelve UI-tested faces, loaded from Google Fonts only when set (default sessions keep the stock Geist stack):
Inter, Roboto, Open Sans, Lato, Montserrat, Poppins, Source Sans 3, Nunito, Work Sans, DM Sans, Plus Jakarta Sans, Space Grotesk.
Dashboard background
Optional canvas-tier backgrounds behind the dashboard (backgroundStyle): a set of CSS presets built from your theme tokens, plus animated "fluid" presets that render a WebGL flow field tinted to a palette, play briefly on load, then freeze. A readability scrim keeps content legible over the animated ones.
Greeting
The dashboard headline your customers see. You can supply up to 12 rotating greeting lines, 80 characters each (greetingLines); the default is "What are we building today?". The greeting block can also be hidden entirely — see Dashboard surface.
Theme presets
Four one-click starting points in the Guided mode's gallery. Since each preset bundles design tokens plus an authored per-component stylesheet (delivered through the rules channel), applying one is a full re-skin, not just a recolor:
| Preset | Character |
|---|---|
| Swarmz | The factory look, and the quickest way back to it. Clears any preset styling. |
| Unstyled | A flat grayscale wireframe with square corners and no shadows, so structure shows before style. |
| Boardroom | Square corners and hairline borders over dense slate panels, built for data-heavy dashboards. Blue accent, Inter. |
| Manuscript | Warm paper surfaces with rounded corners and roomy spacing, made for reading-heavy apps. Terracotta accent, Source Sans 3. |
Applying a preset stages its tokens and styles into the editor — nothing goes live until you save. After saving you can keep editing on top of it; the moment you change anything the preset stops reading as "active", which is expected.
Applying a non-factory preset replaces any component styles you already published through the rules editor, so the studio asks for confirmation first.
Terminology
Ten product nouns can be renamed platform-wide. Values are plain text, capped at 24 characters; leaving one empty falls back to the default.
| Key | Default |
|---|---|
project | Project |
projects | Projects |
publish | Publish |
workspace | Workspace |
team | Team |
domain | Domain |
credits | Credits |
included | Included |
rollover | Rollover |
topup | Top-up |
Rename project to "Site", credits to "Tokens", publish to "Go live" — every built-in surface that uses the noun picks up your label.