Goal

Your app can have one consistent look, and it takes just three brand controls in App Settings: the Global Font every screen uses, a two-color theme palette (a dark color and a light color) that becomes the default for color settings across the app, and the Preferred Accent Color used for highlights. Set these once, and you won’t need to re-pick colors on every individual screen.

Prerequisites

• A MAM app with Mobile App Manager Main active.
• Admin access to the WordPress dashboard with the capability to open App Settings (this page requires the activate_plugins capability).
• Your brand’s font name and your brand color values (hex codes) ready to enter.

Why set these globally

MAM has color settings scattered across many different screens and components. Rather than set each one by hand, you set a theme palette of two colors — a Theme Color Dark and a Theme Color Light — and MAM uses them as the default for the other color settings throughout the app.

Here’s how that works under the hood, because it’s worth understanding: most individual color settings ship with a factory default of either black (#000000) or white (#ffffff). When you set the theme palette, MAM goes through the full settings list and swaps in your dark color wherever the factory default was black, and your light color wherever it was white. So one pair of brand colors reaches every screen you haven’t individually overridden.

A few things follow from that:

• This affects defaults only. If you’ve already changed a specific color setting on a specific screen, that explicit choice is kept — the palette won’t overwrite it.
• A setting can opt out. Some settings are flagged to ignore the palette (the “no default” flag in code) and keep their own value regardless.
• It keys off the factory default value, not the setting’s meaning. A setting that defaulted to a non-black, non-white color (for example a gray) is left alone by the palette.

Steps

1. Open App Settings. In the WordPress admin sidebar, go to Mobile App Mgr → App Settings.

2. Set the Global Font. On the General tab, find Global Font and choose your brand font from the picker — the product describes this as “the font for the entire app,” and it defaults to Roboto. Save.

3. Set the theme palette (dark + light colors). Until you’ve set a palette, opening App Settings greets you with a one-time setup prompt — “Select a dark and light color that fits with your theme” — with Theme Color Dark and Theme Color Light fields ready to fill in. Enter your brand’s primary dark and light hex values there. (Once you save, the prompt won’t appear again; from then on you’ll adjust individual color settings or the palette values directly.)

   • Theme Color Dark replaces the black (#000000) default on color settings across the app.
   • Theme Color Light replaces the white (#ffffff) default on color settings across the app.
   • These are the two values behind the “one color choice, every screen” behavior described above.

4. Set the Preferred Accent Color. On the Misc tab, find Preferred Accent Color (colors_prefered_accent_color, default #000000) and enter your brand’s accent/highlight color — this is the color that draws attention to interactive and emphasized elements.

5. Save and reload. Save your changes. Once the theme palette is saved, the App Settings page re-derives the per-setting defaults so the rest of the color settings reflect your palette — you may see the page reload to pick them up.

6. Spot-check individual screens. Open the screens you care about (login, home, forms, buttons) and check that the colors look right. If a screen still shows the old color, it most likely has its own explicit per-screen color override — change it there, or clear it so it falls back to the palette default.

Verify it worked

• The Global Font value on the General tab reflects your brand font, and app screens render in that font.
• Color settings that you have not individually customized now show your Theme Color Dark / Theme Color Light as their defaults instead of black / white.
• Highlighted elements use your Preferred Accent Color.

Build and preview the app, and every screen should share the same font and the same base palette, with accents in your accent color.

Notes and gotchas

• The palette sets defaults, it doesn’t force values. That’s the point — per-screen overrides survive. It also means that if you change the palette and one screen doesn’t update, that screen almost certainly has its own explicit color set.
• Black and white are the trigger values. The propagation runs off the factory defaults #000000 and #ffffff. A setting whose factory default is some other color is intentionally left alone.
• Some settings opt out of the palette and keep their own default regardless. If a particular color won’t follow the palette, this may be why.
• Theme Color Dark / Light and the accent color are distinct controls. The dark/light pair drives the propagation across other color settings; the accent color is its own setting for highlights, and it isn’t the same as the palette’s dark color even though both default to black.

Related / What’s next

• Building Your App: Set up your app’s home screen and navigation — once the brand is consistent, lay out where users land.
• App Setting Reference: Global Font — the per-setting reference for the global font control.
• App Setting Reference: Preferred Accent Color — the per-setting reference for the accent color.
• App Setting Reference: Theme Color Dark / Theme Color Light — the palette settings that drive app-wide color defaults.