主题导航

Theme

主题与设计 Token

瑚琏的一切视觉都由设计 token 驱动,分三层:原始、语义、预设。消费方只需全局引入两个 CSS 文件,组件、明暗、断点便全部就位。

三层 Token 架构

改下层影响上层;组件永远只碰最上面的语义色和工具类。

  1. 01

    原始层 Primitives

    @hulianui/tokens/primitives.css

    OKLCH 原始色板。明暗共用,不随主题变化,只是一张调色盘。

  2. 02

    语义层 Semantic

    @hulianui/tokens/semantic.css

    按用途命名原始色。明暗模式只换值、不换结构,组件只消费这一层。

  3. 03

    预设层 Preset

    @hulianui/tokens/preset.css

    Tailwind CSS v4 主题把语义 token 映射成工具类,并声明暗色变体、断点和圆角。

如何消费

任意 React 项目只需全局引入一次。

/* app/globals.css */
@import "@hulianui/tokens/tokens.css"; /* 原始色和语义色 */
@import "@hulianui/tokens/preset.css"; /* Tailwind CSS v4 和工具类 */

逐项查看