Skip to content

Guide

Choose a theme and dark mode

Branding & settings · 6 min read

A theme sets your community's brand colors, fonts, corner radius, and shadows, separately for light mode and dark mode. Use themes to match your brand's color scheme and to choose whether members see your community in light or dark mode by default.

Who can do this: Owners and admins. Members choose their own light or dark mode. · Where: Web (admin console). Members switch modes on the web and in the Mateflow app. · Plan: Themes and colors aren't limited by plan. Custom CSS depends on your platform plan.

Open the Themes page

Go to Admin → Appearance → Themes. You can also click Manage colors & fonts in Themes → on the Branding page.

  • Active Theme shows the theme members see now. It has a Live badge.
  • Theme Library lists your other themes. Search them or sort them, for example by Recently Updated.
  • The buttons at the top are App Theme and Add Theme.
  • Default Appearance sets the light or dark mode for people who haven't picked their own.

Add a new theme from a preset

  1. Click Add Theme.
  2. Choose a preset. Use Search presets... or the Category filter to find one. Search also looks in each preset's description. A theme always starts from a preset.
  3. Check the Theme Name (up to 50 characters). It starts as the preset's name.
  4. To make it live right away, tick Publish immediately.
  5. Click Create Theme.

To copy an existing theme instead, open its ⋯ menu, click Clone, enter a New Theme Name, and click Clone Theme. The copy keeps all light and dark colors, typography, corner radius, and shadows.

Edit a theme's colors and fonts

Click Customize on the active theme, or Edit on another theme. The editor opens as Edit Theme: and the theme name, and says whether the theme is live or a draft.

  1. Under Color Mode, choose Light or Dark. Each mode has its own colors, so set both.
  2. On the Colors tab, set colors such as Background, Primary, Accent, Card, and Sidebar. Each text color shows its contrast ratio. Click Smart Adjust to fix a color that doesn't meet the WCAG AA contrast level.
  3. On the Typography tab, choose the fonts for Body text, Headings, and Code, and set the Letter Spacing. Headings start with Same as body text on, so they follow your body font until you turn it off and pick another.
  4. On the Other tab, set the Border Radius and Shadow. Custom CSS is here too, if your platform plan includes it. If you saved custom CSS and your plan no longer includes it, the tab says Your current plan doesn't include custom CSS, so it isn't applied to your community. Your saved CSS is kept and applies again when you upgrade.
  5. Check the preview. Switch between Feed, Post, Profile, and UI, and between Desktop View and Mobile View. On a phone, tap Preview to see it. The preview leaves out Custom CSS.
  6. Click Save on a draft, or Save and apply on the live theme. To save a draft and make it live in one step, click Save and publish.

If a required field is empty, the editor opens the tab it's on and tells you. A color that isn't valid is marked on its row: it can still be saved, but it won't show on your site. @import doesn't work in Custom CSS, so set fonts on the Typography tab.

The editor warns you when text would be very hard to read: a text color below 2:1 against its background, or Primary below 2:1 against Background (it's also used for links such as "View all"). The color shows "Text contrast is only {ratio}:1 and may be hard to read. Aim for at least 3:1." A warning icon also appears on the Light or Dark switch and on a collapsed color group, so you can spot a problem in the mode or group you're not looking at. For a text color, click Use recommended text color to switch to white or black, whichever reads better. Primary is your brand color, so it only gets the warning. When you save with low-contrast colors, Low color contrast asks you to confirm; you can still save.

Saving the active theme changes what members see right away. To try changes safely, clone it, edit the copy, and publish it when it's ready.

Preview a draft on your real community

The editor's preview is a sample page. To see a saved theme on your actual community, including its Custom CSS and fonts, click Preview on site. It opens your community in a new tab with the theme applied, and a bar at the bottom says you're previewing. Only that tab changes, and members don't see anything. Click Exit preview to leave.

The preview shows the last saved version, so save your changes first. It stops working after about an hour; open it again from the editor.

Publish a theme

Click Publish on a theme in the Theme Library, then confirm. It becomes the Active Theme for every member right away, and the previous one moves back to the library. Only one theme is live at a time. The confirmation message that follows has Undo, which puts the previous theme back, and View community, which opens your community with the new theme.

You can delete any theme except the live one: open its ⋯ menu, click Delete, and confirm. Deleting can't be undone.

Restore an earlier version of a theme

Mateflow saves a snapshot of a theme every time it's edited, published, or reverted.

  1. Open the theme's ⋯ menu and click History.
  2. In Version History, find the version you want and click Revert. Each version shows a small preview and when it was saved: Before edit, When published, or Before revert.
  3. Confirm. Mateflow first saves the current state as a new snapshot, so you can undo the revert. If the theme is live, members see the change right away.

App colors aren't part of a theme, so they aren't in its history.

Set the default light or dark mode

The default mode applies to every member and visitor who hasn't picked their own, including existing members. They can still switch.

On the Themes page, under Default Appearance, choose Light, Dark, or System. System follows each person's device setting. Your choice saves right away.

How members switch between light and dark mode

Members can override your default at any time:

  • Web: click the avatar, then Appearance (or go to Settings → Appearance). Under Theme, choose Follow community, System, Light, or Dark. Follow community shows which mode you set as the default.
  • App: open Settings and privacy → Appearance. Under Theme, choose Match community, Match system, Light, or Dark.

Members can't pick a different theme. Your published theme's colors apply to everyone, in the mode they choose.

Give the Mateflow app its own colors

By default, the Mateflow app takes its colors from your live web theme: Primary becomes its accent color, and Primary Text is used for text and icons on it. To change them for the app only:

  1. Click App Theme on the Themes page.
  2. Choose Light or Dark, then set the colors you want to change. Colors you leave empty keep following your live web theme. Derive from web fills in every color from your web theme, which fixes them until you change them.
  3. Click Save.

The editor warns you when a color will be hard to read in the app: Accent below 3:1 against Background (links, active tabs, and icons), or Accent Text below 4.5:1 against Accent (text and icons on accent-colored buttons, badges, and cards). A color you leave empty is checked using the color it takes from your web theme. Below 2:1, the stronger "Text contrast is only {ratio}:1" warning from the web editor replaces it; this check also covers the other text colors on their backgrounds, such as text on surfaces and on the danger color. As in the web editor, warning icons appear on the Light or Dark switch and collapsed groups, and saving asks you to confirm under Low color contrast. The warnings don't stop you from saving.

App colors belong to your community, not to a theme, so they stay the same when you publish a different web theme. The app keeps its own fonts. To make the app follow your web theme completely again, click Clear override and confirm. This can't be undone.

Related articles

Was this guide helpful?

Back to guides

Can't find what you need?

If you're a member of a community, its admins are the right people to ask. If you're building or running one on Mateflow, our team can help.