Back to Docs Hub

Themes

35 hand-crafted visual themes spanning light, dark, luxury, and specialty designs.

35
Total Themes
10
Luxury Themes
system
Auto mode

Every theme uses flat, solid colors with no gradients — a design philosophy inspired by warm, calm, coworking spaces. The design tokens are built with CSS custom properties, making themes fully composable.

Theme Categories

Themes are organized into categories:

CategoryDescriptionExamples
StandardClean, professional themes for daily uselight, dark, amoled
ColorfulVibrant themes with distinct color palettesblue, forest, ocean, sunset
LuxuryPremium themes with rich, sophisticated colorsluxury-gold, luxury-emerald, luxury-royal
SpecialtyUnique themes for specific moods or environmentscyberpunk, matrix, sakura, coffee
AccessibilityHigh-contrast themes for better readabilityhigh-contrast
SystemAuto-detects OS preference (light/dark)system

light

#c2683f

dark

#cf7a52

amoled

#3ddc97

blue

#2563eb

high-contrast

#ffd166

cyberpunk

#ff00ff

forest

#4a9e4a

pastel

#b38cb3

sunset

#e8744a

sepia

#a67c52

nord

#88c0d0

dracula

#bd93f9

matrix

#00ff41

sakura

#e88ba8

sakura-dark

#e88ba8

coffee

#a67c52

ocean

#3b82f6

luxury

#d4a853

emerald-luxury

#3ddc84

rose-luxury

#e85a7a

velvet-luxury

#8b5cf6

bronze-luxury

#cd7f32

platinum-luxury

#e8e8f0

crimson-luxury

#dc2626

sapphire-luxury

#3b82f6

amethyst-luxury

#a855f7

amber-luxury

#f59e0b

obsidian-gold

#d4a853

pearl-noir

#c0b8a8

jade-silk

#34d399

arctic-glass

#7dd3fc

royal-indigo

#6366f1

copper-olive

#b87333

moonlit-rose

#f472b6

carbon-teal

#14b8a6

Token architecture

The design system is defined in packages/ui/src/tokens.css with a layered architecture:

  1. 1. Primitives — base color ramps (sand, terracotta, green, amber, red)
  2. 2. Semantic tokens — purpose-driven colors (--color-bg, --color-text, --color-accent)
  3. 3. Component tokens — component-specific overrides (--button-bg, --card-border)

All themes share the same primitive color ramps and override only semantic tokens. This ensures consistency while allowing customization.

🎨 Color Primitives

A warm, clay-based palette with:

  • Sand neutrals — warm grays for backgrounds and text
  • Terracotta accent — a single accent color that shifts between light/dark modes
  • Semantic greens — for success states and confirmations
  • Amber warnings — for caution states and alerts
  • Red errors — for error states and destructive actions

The accent shifts between light and dark modes while maintaining the same warm character.

📝 CSS Custom Properties

Themes use CSS custom properties for all colors:

TokenDescriptionExample (Light)
--color-bgBase page background#faf9f5
--color-bg-cardCard and raised element background#ffffff
--color-textPrimary text color#5c5544
--color-text-strongProminent heading text#28241d
--color-accentAccent color for links and primary buttons#c2683f
--color-successSuccess states#4f7d47
--color-warningWarning states#a9761f
--color-dangerError states#b8482f
--shadow-mdMedium shadow for cards0 4px 16px rgba(...)
:root {
  /* Backgrounds */
  --color-bg: #faf9f5;
  --color-bg-weak: #f5f3ec;
  --color-bg-card: #ffffff;
  --color-bg-strong: #1e1b16;

  /* Text */
  --color-text: #5c5544;
  --color-text-weak: #938a76;
  --color-text-strong: #28241d;

  /* Accent */
  --color-accent: #c2683f;
  --color-accent-warm: #cf7a52;
  --color-accent-subtle: rgba(194, 104, 63, 0.11);

  /* Semantic */
  --color-success: #4f7d47;
  --color-warning: #a9761f;
  --color-danger: #b8482f;

  /* Shadows */
  --shadow-sm: 0 1px 2px rgba(54, 46, 32, 0.06);
  --shadow-md: 0 4px 16px rgba(54, 46, 32, 0.09);
  --shadow-lg: 0 16px 40px rgba(54, 46, 32, 0.13);
}

Override these properties in your custom theme to change the entire look.

☀️🌙 Light and Dark Mode

Every theme in Aura Work has a light and a dark variant (e.g. ocean-light and ocean-dark). Switching between them is instant with no page reload. The special system theme automatically follows your OS preference via the prefers-color-scheme property and switches automatically when your device's settings change (e.g. macOS sunset/sunrise).

🔧 Creating Custom Themes

Create your own theme by following these steps:

  1. 1. Copy an existing theme (e.g., light.css)
  2. 2. Override the CSS custom properties with your colors
  3. 3. Add your theme to packages/ui/src/themes/
  4. 4. Register it in the theme list
  5. 5. Test in both light and dark modes
  6. 6. Submit a PR

See packages/ui/src/themes/ for all theme files.

📱 RTL & Accessibility

The theme system includes:

  • High-contrast theme — for accessibility (WCAG AA compliant)
  • Full RTL support — for Arabic and Persian
  • System preference detection — via prefers-color-scheme
  • Reduced motion — respects prefers-reduced-motion
  • Font scaling — supports browser font size adjustments

The system theme automatically matches your OS preference, switching between light and dark mode.

Creating a Custom Theme Manually

You can create a custom theme by defining a set of CSS variables. Place the theme file in ~/.config/aura/themes/ and it will be loaded automatically.

{
  "name": "my-theme",
  "colors": {
    "bg-primary": "#1a1b26",
    "fg-primary": "#c0caf5",
    "accent": "#7aa2f7"
  }
}

You can export themes and share them with the community. Featured community themes are added to the official gallery.