Home / Docs / Theming

Covers 2 of the 14 themes MayteraOS ships today. The IDs, constants, and color values below are verified current against kernel/gui/themes.h. This document just predates the rest of the theme set: MayteraOS now ships 14 built-in themes (classic, light, dark, high-contrast, fluent-dark/light, forest, ocean, sunset, maytera-dark/light, modern-dark/light, retro-unix) in a binary .mtheme format, not the 2 described here. See UI Primitives for how the wider style engine works.

Modern macOS Themes for MayteraOS

This document describes the Modern Light and Modern Dark themes inspired by macOS Big Sur (11) and later versions.

Overview

These themes bring the clean, modern aesthetic of macOS to MayteraOS with:

  • Subtle depth and refined color palette
  • Traffic light window buttons (red/yellow/green)
  • System blue accent color (#007AFF light, #0A84FF dark)
  • Content-focused, minimal chrome design
  • Rounded, pill-style controls

Theme IDs

ThemeIDConstant
Modern Light8THEME_MODERN_LIGHT
Modern Dark9THEME_MODERN_DARK

Usage

#include "gui/themes.h"

// Switch to Modern Light theme
theme_set(THEME_MODERN_LIGHT);

// Switch to Modern Dark theme
theme_set(THEME_MODERN_DARK);

Color Palettes

Modern Light Theme

ElementColorHex
BackgroundOff-white#F5F5F7
ForegroundNear-black#1D1D1F
AccentSystem Blue#007AFF
Titlebar ActiveLight gray#E8E8E8
Titlebar InactiveLighter gray#F0F0F0
Window BackgroundWhite#FFFFFF
Close ButtonRed#FF5F57
Minimize ButtonYellow#FFBD2E
Maximize ButtonGreen#28CA42
SelectionSystem Blue#007AFF
Selection TextWhite#FFFFFF
DesktopSky Blue#5BADE9

Modern Dark Theme

ElementColorHex
BackgroundDark#1E1E1E
ForegroundOff-white#F5F5F7
AccentBright Blue#0A84FF
Titlebar ActiveDark gray#2D2D2D
Titlebar InactiveDarker#252525
Window BackgroundDark#1E1E1E
Close ButtonRed#FF5F57
Minimize ButtonYellow#FFBD2E
Maximize ButtonGreen#28CA42
SelectionBright Blue#0A84FF
Selection TextWhite#FFFFFF
DesktopDeep purple-blue#1C1C28

Design Elements

Traffic Light Buttons

Both themes use the macOS-style "traffic light" window control buttons:

  • Close (red): #FF5F57
  • Minimize (yellow): #FFBD2E
  • Maximize/Zoom (green): #28CA42 These colors are vibrant and consistent across both light and dark modes.

System Blue Accent

The accent color adapts for visibility:

  • Light mode: #007AFF - Standard system blue
  • Dark mode: #0A84FF - Brighter blue for dark backgrounds

Subtle Borders

Instead of heavy borders, these themes use very subtle dividers:

  • Light: #D1D1D6 - barely visible gray
  • Dark: #3D3D3F - subtle dark gray

Translucent Appearance

While true blur effects require compositing support, the colors are chosen to suggest a translucent, layered feel:

  • Taskbar/dock uses slightly tinted backgrounds
  • Menus appear as floating panels
  • Scrollbars use overlay-style thin tracks

Icon Adaptations

For the modern macOS aesthetic, icons should follow SF Symbols design principles:

  1. Consistent weight - Medium weight for legibility
  2. Simple shapes - Avoid unnecessary detail
  3. Optical alignment - Center icons visually, not mathematically
  4. Clear silhouettes - Recognizable at small sizes

Recommended Icon Colors

ContextLight ThemeDark Theme
Primary#1D1D1F#F5F5F7
Secondary#636366#AEAEB2
Accent#007AFF#0A84FF
Destructive#FF3B30#FF453A

File Locations

  • Header: /kernel/gui/themes.h
  • Implementation: /kernel/gui/themes.c

Version History

  • v1.4.0: Initial implementation of Modern Light and Modern Dark themes