Zephora UI

佈景主題

主題是編譯為 --z-* CSS 自訂屬性的純 TypeScript 物件。切換主題會改寫這些變數 — 即時生效，沒有 CSS-in-JS，樣式也沒有重新渲染的成本。

現成主題

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）與全域

// 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 層級覆寫

元件直接讀取變數，因此任何 CSS 規則都能為任何子樹重新套用主題：

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

深色模式

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