KodingKaro
CSS · Intermediate · CSS Variables

Theme tokens and scoped overrides

Variables become especially powerful when a component or page can override a token without rewriting every rule.

✓ What you will learn in this topic

  • Explain the key idea: Use inheritance and scoped overrides to build coherent themes and reusable components.
  • Apply the concept: A scoped theme changes the card’s colors while the component rules stay the same.
  • Avoid this common mistake:

Concept explanation

Because custom properties inherit, a theme class on a wrapper can replace shared values for its descendants. Components can also define local defaults. Keep token names tied to roles—such as surface, text, or accent—rather than a particular page location.

A dark theme needs more than swapping a background; check text, borders, hover states, focus rings, and illustrations together. Test each token where it is consumed.

Syntax

A CSS rule has a selector followed by declarations. Each declaration is a property and a value; the braces group the declarations that apply to matching elements.

.demo {
  --card-accent: #1d4ed8;
  border-inline-start: 0.25rem solid var(--card-accent);
}

Example 1: a small page element

Use this HTML as the target and place the CSS in a stylesheet linked to the page, or inside a <style> element while experimenting.

<main class="demo card-grid course-grid dashboard-panel course-card-list dashboard-grid card-layout"><h2>Learning card</h2><p>Clear styles make this information easier to scan.</p><nav class="site-nav"><a href="/learn">Courses</a></nav><label class="form-field"><span>Email</span><input type="email" aria-invalid="true"></label><article class="card course-card dashboard-card theme-dark"><span class="badge status">New</span><div class="course-card__image"></div><h2 class="course-card__title card__title">Course update</h2><p class="status">New lessons are available this week.</p><a href="/learn" aria-current="page">Read the details</a><div class="actions course-card__actions dashboard-panel__actions"><button type="button">View lessons</button><button type="button" disabled>Unavailable</button></div></article></main>
.demo {
  --card-accent: #1d4ed8;
  border-inline-start: 0.25rem solid var(--card-accent);
}

Expected result: A scoped theme changes the card’s colors while the component rules stay the same.

Example 2: a practical interface card

The same idea can style a reusable card on a course page. The class selector keeps the rule attached to this component rather than changing every element of that type.

<section class="demo card-grid course-grid dashboard-panel course-card-list dashboard-grid card-layout"><h2>Learning card</h2><p>Clear styles make this information easier to scan.</p><nav class="site-nav"><a href="/learn">Courses</a></nav><label class="form-field"><span>Email</span><input type="email" aria-invalid="true"></label><article class="card course-card dashboard-card theme-dark"><span class="badge status">New</span><div class="course-card__image"></div><h2 class="course-card__title card__title">Course update</h2><p class="status">New lessons are available this week.</p><a href="/learn" aria-current="page">Read the details</a><div class="actions course-card__actions dashboard-panel__actions"><button type="button">View lessons</button><button type="button" disabled>Unavailable</button></div></article></section>
.theme-dark {
  --surface: #111c2e;
  --ink: #e2e8f0;
}
.card {
  color: var(--ink, #172033);
  background: var(--surface, #fff);
}

Expected result: The course update reads as a distinct interface card, and its content follows the spacing, color, and layout choices in the rule.

Common mistake

Custom properties are case-sensitive and resolve where they are used; a variable defined in an unrelated scope may not be available.

Best practice

Name tokens by purpose, define shared values at a deliberate scope, and use var() fallbacks when they improve resilience.

Practice exercise

Create design tokens for brand color, surface, spacing, and radius, then apply them to a reusable card. Apply it to the example above and inspect the result at a narrow and a wide viewport.

Section summary

  • Use inheritance and scoped overrides to build coherent themes and reusable components.
  • Name tokens by purpose, define shared values at a deliberate scope, and use var() fallbacks when they improve resilience.

Knowledge check

Why are role-based token names useful?

Reveal the explanation

Role-based names describe meaning, making theme overrides easier to understand.

Finish the module lessons, then take the server-scored module quiz to check your understanding.

Practical example

css
.demo {
  --card-accent: #1d4ed8;
  border-inline-start: 0.25rem solid var(--card-accent);
}

Expected result:

A scoped theme changes the card’s colors while the component rules stay the same.

Hands-on practice task

Create design tokens for brand color, surface, spacing, and radius, then apply them to a reusable card.

In this section

Other lessons in CSS Variables

Broaden your knowledge

Related learning topics