Troubleshooting

Troubleshooting

A theme fails quietly. A rule that matches nothing simply does nothing, and an undefined variable falls back to a default — none of it raises an error. So the first question is almost always "is the browser even seeing the new CSS".

The theme does not apply at all

Hard reload first — Ctrl+Shift+R. A normal reload serves the cached stylesheet, which looks identical to the theme being broken.

If that does not do it:

bench build --app swift_theme
bench --site your-site clear-cache

Then open the browser console (F12 → Console) and look for anything in red. One error early in the theme's boot script stops the whole file, and the symptom is "the preset does not apply" rather than anything that looks like an error. If you see one, please report it with that line.

Migrate finished instantly and nothing changed

bench migrate needs redis running. Without it, it exits without doing the work and without saying so. Check redis is up, then run it again.

Saving Settings does not update my other tabs

Live updates across sessions need Frappe's realtime server (socket.io). If the console shows ERR_CONNECTION_REFUSED on port 9000, it is not running — start the bench with bench start, which runs it alongside the web server.

The tab you saved in updates either way.

The backdrop is not visible

Check Enable Backdrops is on in Swift Theme Settings.

If it is on and you still cannot see it, that is expected on a busy screen — the backdrop sits behind the desk, and cards are opaque, so on a page full of cards you only catch it around the edges. Turn on Show Backdrop Through Panels to make the cards translucent so it reads through.

No sound plays

The app ships no audio files. Turn on Sounds, then add rows under Sound Events and attach a file to each event you want. An event with no file attached keeps Frappe's own sound.

Colours look wrong on one screen only

That is worth reporting — it usually means a rule is targeting a class Frappe renamed, or a surface nobody has looked at yet. A screenshot plus the page you were on is enough to find it.

Everything looks right but a preset is missing

Presets were renamed in an earlier release. If a site or a user is still on an old name, migrate carries it across to the closest new one — for example Midnight Pro becomes Black Panther. If a stored value no longer exists at all, it is reset to the default and the reason is written to the Error Log rather than stopping the migrate.

Still stuck

Open an issue, or get in touch — see Support.