Arc styling

How game screens resolve colors, fonts and metrics through .theme themes, and how the editor's themes, density and motion settings apply to Arc widgets.

Last updated Oct 26, 2026Edit this pageVersion 1.0.0

Arc has two styling layers. Game themes (.theme assets) let each game screen resolve color, font and metric tokens against its own palette. The editor style ("Mowo Graphite") is the editor's own palette, with Dark, Light and High Contrast themes; editor extensions draw with its tokens. This page covers both.

Game themes (.theme)

Game screens do not use the editor palette directly. A .ui screen resolves color tokens such as "accent" or "textbright" through an FArcUITheme, stored as an MDF .theme asset Engine/Source/Runtime/ArcUI/Public/ArcUI/FArcUITheme.h.

Content/UI/Game.theme
ArcTheme "Sample Game" {
    Colors {
        accent: vec4(0.20784314, 0.64705884, 0.8980392, 1.0)
        textbright: vec4(0.9098039, 0.91764706, 0.9254902, 1.0)
        scanner: vec4(0.32000002, 0.96, 0.72, 1.0)
    }
    Fonts {
        Font "body" {
            family: "Geist"
            size: 14.0
        }
    }
    Metrics {
        corner_radius: 4.0
    }
}

This is an excerpt of the sample theme. A theme can add any token name, like scanner above, and screens can reference it.

Resolution order

  1. Screen's own theme:
  2. Project theme
  3. Built-in default theme
The first theme that defines the token wins.
  1. The theme: property at the root of the .ui.
  2. The host's project theme, set with CArcUIScreenStack::SetProjectTheme(path) Engine/Source/Runtime/ArcUI/Public/ArcUI/CArcUIScreenStack.h.
  3. The built-in default theme ("Mowo Default").

The default theme defines eight colors taken from the editor palette: accent, success, warning, error, info, text, textbright and surface, plus the fonts body (Geist 14) and heading (Sora 22).

Token names are normalized before lookup. A path prefix is dropped and the rest is lowercased, so token/accent, Content/UI/Game.theme.accent and the legacy name AccentColor all resolve to accent Engine/Source/Runtime/ArcUI/Public/ArcUI/FArcUITheme.h.

Tip

In the ArcUI Designer, color rows offer the theme's token list before a raw color picker. Prefer tokens: a screen authored in raw colors stops following the theme when the theme changes.

Editor themes

The editor's default theme is Dark. The editor's Preferences > Appearance > Theme also offers Light and High Contrast, which replace the colour tokens; a project can add its own theme as a JSON file of colour tokens under Config/Themes. High Contrast drops elevation shadows, because popups there rely on their outline.

Using tokens in C++

An editor extension that draws its own widgets reads the editor palette from the Arcf::Mowo namespace. ToFontInfo turns a typography entry into an Arc font description Engine/Source/Runtime/Arc/Public/Arc/Mowo/ArcMowoStyle.gen.h.

StatusLabel.cpp
#include <Arc/Widgets/ATextBlock.h>
#include <Arc/Widgets/ABorder.h>
#include <Arc/Mowo/ArcMowoStyle.gen.h>

const Arcf::ArcColor warningText = Arcf::Mowo::MowoColors::WarningText;
const float radius = Arcf::Mowo::MowoMetrics.Radius.Small;
const float fadeMs = Arcf::Mowo::MowoMotion.Fade.DurationMs;

Arcf::TSharedPtr<Arcf::AWidget> label = ArcNew(Arcf::ATextBlock).Text(Arcf::CText::FromString("Unsaved changes")).Font(Arcf::Mowo::ToFontInfo(Arcf::Mowo::MowoTypography.Caption)).ColorAndOpacity(warningText);

At run time, CArcStyle::Get() is the registry of style sets: RegisterStyleSet, SetActiveStyleSet, GetColor(key), and a change listener Engine/Source/Runtime/Arc/Public/Arc/Style/CArcStyle.h. With no set registered it falls back to a built-in dark theme, so widgets can resolve defaults before initialization.

Density

The editor's Preferences > Appearance > Density offers Compact, Default and Comfortable. Metric tokens hold the Default values. A widget that lays out from a row height, control height or padding asks CArcDensity for the value at the current density, and a density change re-lays out the whole UI without a restart CArcDensity. Rows move by 4 pixels, control heights by 2, and padding scales by 3/4 or 5/4, so the 4-pixel grid holds.

Motion and reduced motion

Transitions read their duration and easing from the motion tokens. When Reduced Motion is on (the ui.ReducedMotion setting, see Settings and accessibility), Arc skips decorative transitions: non-looping animations jump to their end and popups open without sliding. High Contrast UI (ui.HighContrast) switches the Mowo theme to its high-contrast colours.

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 3f3a08d31.

  • Engine/Source/Runtime/Arc/Public/Arc/Mowo/ArcMowoStyle.gen.h
  • Engine/Source/Runtime/Arc/Public/Arc/Style/CArcStyle.h
  • Engine/Source/Runtime/ArcUI/Public/ArcUI/FArcUITheme.h
  • Engine/Source/Runtime/ArcUI/Public/ArcUI/CArcUIScreenStack.h
  • Engine/Source/Runtime/Arc/Public/Arc/Style/CArcDensity.h

Page feedback

Was this page helpful?