Swarmz

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

SettingWhat 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

Five URLs let you point built-in actions at your own properties. Each must be a valid http(s) URL:

SettingWhere it's used
supportUrlSupport links in the dashboard
docsUrlDocumentation links
upgradeUrlUpgrade prompts and plan CTAs
buyDomainUrlDomain-purchase pointers
loginUrlWhere signed-out customers are sent

Colors

Three layers, from simplest to most control:

  1. Accent color — a single brand color (primaryColor / accentColor, or a curated color scheme). It becomes the --brand and --accent design tokens and drives buttons, links, and highlights.
  2. 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.
  3. 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:

PresetCharacter
SwarmzThe factory look, and the quickest way back to it. Clears any preset styling.
UnstyledA flat grayscale wireframe with square corners and no shadows, so structure shows before style.
BoardroomSquare corners and hairline borders over dense slate panels, built for data-heavy dashboards. Blue accent, Inter.
ManuscriptWarm 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.

KeyDefault
projectProject
projectsProjects
publishPublish
workspaceWorkspace
teamTeam
domainDomain
creditsCredits
includedIncluded
rolloverRollover
topupTop-up

Rename project to "Site", credits to "Tokens", publish to "Go live" — every built-in surface that uses the noun picks up your label.

On this page