Dark Mode

Toggles your app’s theme. Tapping it switches between light and dark rather than opening a screen, and the member’s choice persists.

Before you start

Plugin	None
Endpoint group	None
Plan	Every plan

Set both palettes under Settings → Appearance before you offer this. A dark palette left at its defaults while the light one is branded makes the toggle look like a bug.

Add it to your app

Drag Dark Mode into the side drawer, alongside settings and sign-out. That is where members look for preferences.

The upper nav bar is reasonable if you have a spare slot and your members switch often. A bottom-nav slot is a poor use of one of eight.

Settings

Setting	What it does	Default
Title, Description	The label	Empty
Restrictions	Which roles see it	Everyone

What your members see

The app switches theme immediately. The choice is remembered between sessions, overriding the Default Mode you set in the builder.

Without this feature placed, your Default Mode is what everyone gets.

Whether to offer it at all

Follow the device as your Default Mode is usually enough. Members who want dark have already told their phone, and an app that honours that needs no toggle.

Offer the toggle when your Default Mode is an explicit light or dark — because then some members are getting the opposite of what they asked their phone for.

See Dark mode in the app.

When it does not work

Symptom	Cause	Fix
Tapping does nothing visible	Both palettes are nearly identical	Set them apart
Dark mode looks unstyled	Only the light palette was branded	Set the dark palette
The choice does not persist	The app is an older build	Rebuild and redistribute
It has no effect in the preview	The preview follows the app’s Default Mode	Toggle it in the preview to check