Settings Reference

Settings Reference

Everything lives in one place: Swift Theme Settings (search it from the awesomebar). Saving applies immediately in every open desk session — no reload.

Color Mode

Setting	Default	What it does
Color Mode	Theme Preset	Theme Preset or Custom Colors. There is no third option.
Active Preset	Iron Man	Which of the twelve presets is active. Only shown in preset mode.

Custom Colors

Only shown when Color Mode is Custom Colors.

Setting	Default	What it does
Primary Color	—	The brand colour. Everything else is derived from this pair.
Secondary Color	—	The second colour — gradients, accents, hover states.
Custom Mode	Dark	Light or Dark. Cannot be guessed from a hex code.
Colour Strength	Subtle	Subtle keeps cards neutral; Bold gives cards the brand tone.
Backdrop	—	Aurora, Mesh, Grain, Facets, Silk or None. Ignored in preset mode, where the preset brings its own.

Desk Defaults

Site-wide defaults. Each user can override these for themselves.

Setting	Default	Options
Default Density	Comfortable	Compact / Comfortable / Cozy
Default Shape	Rounded	Sharp / Rounded / Pill
Default Font Scale	M	S / M / L / XL
Default Font Family	Inter	Inter / Poppins / Manrope / Roboto / System

Features

Setting	Default	What it does
Enable Theme Switcher	On	Governs all three ways to change theme: navbar chip, Switch Theme dialog, command palette.
Enable Command Palette	On	Ctrl+K style palette for theme and layout actions.
Enable Focus / Reading Mode	On	Strips the desk back for reading.
Enable Backdrops	On	The background behind the desk. Off gives a plain, flat colour.
Show Backdrop Through Panels	Off	Makes cards and the sidebar translucent so the backdrop reads through.
Enable Performance Mode	On	Cuts transitions and expensive effects. Backdrops keep moving — that layer is composited and costs nothing.
Enable Styled Scrollbar	On	Themed scrollbars.
Enable Toast Theming	On	Moves Frappe's alerts to the top and themes them.
Enable Print Theming	On	Applies the theme's typography to printed documents.
Print Font Family	Inter	Font used when printing.

Branding

Setting	What it does
Brand Name	Replaces the app name in the navbar and on the login page.
Brand Favicon	The browser tab icon.
Brand Logo	Shown in the navbar and on the login page.
Brand Logo (Dark)	Used when a dark theme is active, so a dark logo does not vanish.

Login Page

Setting	Default	What it does
Login Layout	Split	Split / Centered / Minimal
Login Tagline	—	A line of text under the heading.
Show Sign Up Link	Off	Whether to offer sign-up.
Login Background Image	—	Optional image for the Split layout.

The login page is rendered server-side, so it paints in the right colours on first load rather than flashing.

Auto Dark Mode

Setting	Default	What it does
Enable Auto Dark	Off	Switch to dark between the two times below.
Dark Mode Starts	19:00
Dark Mode Ends	07:00

Sounds

Setting	Default	What it does
Enable Sounds	Off	Whether the theme answers for desk sound.
Volume Level (%)	50
Sound Events	—	One row per event, each with its own file.

No audio ships with the app. With Sounds on, the theme plays only what you have attached; any event you have not attached a file for keeps Frappe's own sound rather than falling silent. With Sounds off, Frappe's own sounds play exactly as they normally would.

Navigation

Setting	Default	Options
Navbar Variant	Solid
Sidebar Variant	Floating

The sidebar can also be hidden entirely with Alt+B, with a small button at the screen edge to bring it back.

Custom code

Swift Theme does not inject custom CSS or JavaScript. Earlier versions had two fields for it; they were removed, and upgrading clears anything stored in them.

A theming app is the wrong place to hold that much power — the fields ran on every desk page for every user, with no review and no way to see what had been put there. Frappe already covers the need properly:

• Client Script for JavaScript, scoped to a DocType and its own permissions.
• Website Theme, or an app of your own, for stylesheet overrides.

Per-user preferences

Each user can set their own on their User record, and these win over the site defaults: theme preset, primary/secondary colour, density, shape, font scale and font family.

The colour ones are only editable if the theme switcher is on and the user is allowed to switch — otherwise they show read-only, matching what the server would actually accept.