Colors

colors maps a color name to an HTML color, "#rrggbb" or "#rrggbbaa". Names you leave out keep Nari’s default, so a theme can change just one color.

"colors": {
  "background": "#fdf0f5",
  "foreground": "#5a2a44",
  "panel_bg": "#5a2a44",
  "panel_fg": "#ffffff",
  "accent_bg": "#ff7aa8",
  "accent_gradient": "#ffc2d8"
}

Color names

Group	Names	Used for
Surface	background, background_gradient, background_tint, foreground	The screen behind everything and the text on it.
Panels	panel_bg, panel_fg, panel_gradient	Cards, lists, buttons and bars. gradient is the soft glow inside them.
Accent	accent_bg, accent_fg, accent_gradient	What stands out: the play button, the progress bar, selections.
Animated background	animbg_color1, animbg_color2, animbg_color3	The moving blobs and triangles.
States	success_*, warning_*, error_*	Messages and warnings.
Families	blue_*, green_*, yellow_*, red_*, purple_*, gray_*, pink_*, orange_*, teal_*, cyan_*, indigo_*, lime_*	Home and Search tiles, and the plugin entries that pick a color.

Every * stands for bg, fg and gradient, like pink_bg, pink_fg and pink_gradient.

Following the album art

Users can turn on Colors adapt to song. Nari then picks the cover’s main color, the way matugen does (Material You), and builds a palette from it:

• a light palette, or a dark one when the theme’s mode is "dark", so a dark theme stays dark on every song
• only the surface, panel, accent and animated background colors follow the cover; states and families always keep the theme’s values

Set adapt in the manifest to "off" to keep your colors no matter what, or to "force" to always follow the album art.