Zephora UI

Theming

Themes are plain TypeScript objects compiled into --z-* CSS custom properties. Switching a theme rewrites variables — instantly, no CSS-in-JS, no re-render cost for styles.

Ready-made themes

import { lightTheme, darkTheme, auraTheme, materialTheme } from "@zephora/theme";

createTheme

import { createTheme, lightTheme } from "@zephora/theme";

const brand = createTheme(lightTheme, {
  name: "brand",
  colors: {
    primary: "#0f766e",
    primaryHover: "#115e59",
    ring: "#14b8a6",
  },
  radius: "0.75rem",
});

Scoped vs global

// Scoped — wraps a subtree in a themed scope element
<ThemeProvider theme={brand}>...</ThemeProvider>

// Global — writes variables onto <html>, ideal for app-level switching
import { applyTheme } from "@zephora/theme";
applyTheme(brand);

CSS-level overrides

Components read variables directly, so any CSS rule can retheme any subtree:

.marketing-section {
  --z-primary: #ea580c;
  --z-radius: 9999px;
}

Dark mode

const [scheme, setScheme] = useState<"light" | "dark">("light");
<ThemeProvider theme={scheme === "dark" ? darkTheme : lightTheme} global>
  <App />
</ThemeProvider>