系统如何运作
颜色分为两层。 基元 是原始调色板 - Tailwind 的默认 OKLCH 比例加上一些 Figma 调整的覆盖 styles/theme.css. 语义变量 坐在上面并通过以下方式引用这些原语 目的 - 颜色的用途,而不是它的外观。 --color-text-secondary says “supporting copy”, not “neutral 500”.
组件仅消耗语义层。这种单一的间接性使得系统可维护:重新调整原语或重新映射语义变量,并且每个组件立即更新 - 没有组件文件发生变化。这也是通向深色模式的途径: .dark theme.css 中的块将相同的标记重新指向暗值,因此组件永远不需要 dark: 前缀。
令牌名称反映 Figma 变量路径(text/primary → --color-text-primary),因此设计规范可以转换为没有查找表的代码。请注意类名中的双前缀 - text-text-primary, bg-background-primary-default - 第一部分是 Tailwind 实用程序,其余部分是令牌的完整语义路径。
一套设计变量,两种主题
添加 .dark 到根元素。 BoardUI 重新映射相同的语义变量,因此每个组件都会随之改变。
映射每个主题
保持光值 :root 和暗值 .dark.
使用语义颜色
使用像这样的令牌 bg-background-primary-default,不是原始颜色。
保持集中
避免组件级 dark: 覆盖,以便更改保持可预测。
包括持久性和无闪存初始化脚本。
查看安装指南一种口音,每一个 CTA
每个交互式表面 - 主按钮渐变、复选框、单选按钮、开关、滑块、选项卡、选定的侧边栏项目、聚焦环 - 从单个内容读取 --color-accent-50…950 默认为蓝色的渐变。选择下面的任何色调(或完全自定义的颜色)并观看此页面实时重新着色;图表和状态颜色故意保持不变。
自定义颜色会精确落在 --color-accent-500 上:主按钮的渐变从这一档开始,焦点环也使用它;其余十档围绕它生成。按钮会在它上面显示白色文字,所以请选择足够深、能让文字清晰可读的颜色。
带回家:复制 11 个变量覆盖并将其粘贴到 theme.css 导入后。
前景
图标填充和反色/同色前景 - 在不运行文本的表面上绘制的所有内容。
文字
类型层次结构:主要用于标题和键值,辅助用于支持副本,第三个用于提示,以及禁用和错误状态。
背景
表面填充。外层画布饱满;第一、第二和第三描述了渐进嵌套的表面及其交互状态。
边框
发际线和对焦环。按钮边框通过悬停和活动而变暗;对焦环是单一的蓝色调。
图表
Chart colors. Track is the background bar/ring behind a series, cursor the hover outline and dashed reference line, neutral an “other”-style data slice. The numbered accents are a categorical ramp — each pairs a base fill with a one-tone-darker active used for hover emphasis (the 400 → 500 recipe every chart follows). In charts these are consumed as CSS variables (e.g. fill=“var(--color-chart-1)”) rather than classes.
状态
语义反馈颜色的含义在不同主题中保持稳定。