Course contentsShow
← Web Development
Lesson 1362 of 2,98224. CSS Architecture and MaintainabilityFree lesson

Dark Mode Implementation with Custom Properties

Implement light and dark themes by overriding custom property values based on user preference or system settings.

Dark Mode Implementation with Custom Properties

You'll learn how to switch between light and dark color schemes by swapping custom property values, giving users control over their visual experience.

The Core Idea

Instead of hardcoding colors throughout your stylesheet, you define semantic color variables (like --color-background and --color-text) at the root level. Then, you override these variables in a dark theme context—either through a class on the <html> element or by detecting the user's system preference with a media query. All your components automatically adopt the new values without touching their individual rules.

Think of it like a universal light switch: you're not rewiring each lamp individually; you flip one master switch and all the bulbs change together.

How It Works

Step 1: Define default (light) theme variables:

:root {
  --color-background: #ffffff;
  --color-text: #222222;
  --color-primary: #0066cc;
}

Step 2: Override for dark mode using a class or media query:

/* User toggle approach */
.dark-theme {
  --color-background: #1a1a1a;
  --color-text: #e0e0e0;
  --color-primary: #66aaff;
}

/* System preference approach */
@media (prefers-color-scheme: dark) {
  :root {
    --color-background: #1a1a1a;
    --color-text: #e0e0e0;
    --color-primary: #66aaff;
  }
}

Step 3: Use the variables everywhere:

body {
  background: var(--color-background);
  color: var(--color-text);
}

Now when .dark-theme is added to the <html> tag or the user's system is in dark mode, every element using these variables updates instantly.

Key Takeaway: Dark mode with custom properties means defining theme tokens once and overriding them contextually—your entire color system switches without rewriting component styles.