用途:为 Nuxt 项目建立令牌驱动的设计系统,把品牌与暗色模式行为放进 CSS 变量,而不是散落在 Tailwind 工具类里,使模板保持语义化。
主要能力:注册自定义字号体系(display、流体字号)、动效曲线、品牌调色板与字体栈;构建暗色模式正确的界面;为局部区域做上下文 CSS 覆盖;为主题切换接入 View Transitions;通过 app.config.ts 配置组件级默认值。
核心规则:模板中不使用原始调色板类,改用 text-default、bg-elevated、border-muted 等语义类,暗色模式由 Nuxt UI 自动翻转;令牌写在 main.css 的 @theme static 中,Tailwind 会将其识别为工具类(如 text-display-xl、ease-out-expo);品牌调色板在 app.config.ts 中覆盖 primary 与 neutral;任意值仅在尺度无法表达时使用;容器需要改变子元素配色时,写一条上下文 CSS 规则优于多条工具类覆盖。
参考文件:tokens.md(@theme static 注册、流体字号、动效曲线、字体栈)、semantic-colors.md(语义类目录、暗色自动翻转、品牌调色板、组件默认变体)、contextual-overrides.md(重绑 --ui-* 变量、.section-dark 模式与作用域)、view-transitions.md(主题切换径向擦除、降级处理、ClientOnly 包装)、fonts.md(@nuxt/fonts 自托管、字重子集、回退度量、预加载、可变字体、font-display)。
快速定位:品牌主色在 app.config.ts 的 ui.colors.primary;自定义字号与动效曲线在 main.css 的 @theme static;表单默认尺寸在 app.config.ts 的组件 defaultVariants.size;局部调色板调整用单条 .my-class { --ui-* } 规则;平滑主题切换用 ThemeToggle.vue 与 ::view-transition-* 关键帧。
反模式:模板中写 text-gray-500、bg-stone-100 会破坏暗色模式;直接在 CSS 定义 --ui-primary-500 应改用 app.config.ts;重复使用的一次性 text-[15px] 应注册为令牌;品牌色决策不应放在 nuxt.config.ts;Tailwind 4 期望通过 CSS 而非 JS 配置提供令牌。
相关技能:nuxt-ui(组件 API、ui prop、插槽覆盖)、nuxt-components(tailwind-variants 组件级变体,消费此处令牌)、nuxt-config(app.config.ts 位置)。
限制:资料未提供安装命令、版本要求、收费与平台信息。