颜色

每个 BoardUI 组件的语义颜色变量都是由前景、文本、背景和边框角色构建的,与 Figma 变量按 1:1 命名。

系统如何运作

颜色分为两层。 基元 是原始调色板 - 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 重新映射相同的语义变量,因此每个组件都会随之改变。

01

映射每个主题

保持光值 :root 和暗值 .dark.

02

使用语义颜色

使用像这样的令牌 bg-background-primary-default,不是原始颜色。

03

保持集中

避免组件级 dark: 覆盖,以便更改保持可预测。

包括持久性和无闪存初始化脚本。

查看安装指南

一种口音,每一个 CTA

每个交互式表面 - 主按钮渐变、复选框、单选按钮、开关、滑块、选项卡、选定的侧边栏项目、聚焦环 - 从单个内容读取 --color-accent-50…950 默认为蓝色的渐变。选择下面的任何色调(或完全自定义的颜色)并观看此页面实时重新着色;图表和状态颜色故意保持不变。

自定义颜色会精确落在 --color-accent-500 上:主按钮的渐变从这一档开始,焦点环也使用它;其余十档围绕它生成。按钮会在它上面显示白色文字,所以请选择足够深、能让文字清晰可读的颜色。

带回家:复制 11 个变量覆盖并将其粘贴到 theme.css 导入后。

安装指南

前景

图标填充和反色/同色前景 - 在不运行文本的表面上绘制的所有内容。

Token顺风级浅色深色
--color-foreground-fulltext-foreground-fullwhiteneutral-700
--color-foreground-icon-primarytext-foreground-icon-primaryneutral-950neutral-50
--color-foreground-icon-hovertext-foreground-icon-hoverblackwhite
--color-foreground-icon-secondarytext-foreground-icon-secondaryneutral-500neutral-500
--color-foreground-icon-tertiarytext-foreground-icon-tertiaryneutral-400neutral-600
--color-foreground-icon-quaternarytext-foreground-icon-quaternaryneutral-300neutral-700
--color-foreground-icon-errortext-foreground-icon-errorred-600red-400
--color-foreground-icon-disabledtext-foreground-icon-disabledneutral-300neutral-800
--color-foreground-disabledtext-foreground-disabledneutral-400neutral-700
--color-foreground-disabled-dangertext-foreground-disabled-dangerred-300red-400
--color-input-disabled-foregroundtext-input-disabled-foregroundneutral-300neutral-600
--color-icon-button-disabled-foregroundtext-icon-button-disabled-foregroundneutral-300neutral-500

文字

类型层次结构:主要用于标题和键值,辅助用于支持副本,第三个用于提示,以及禁用和错误状态。

Token顺风级浅色深色
--color-text-primarytext-text-primaryneutral-950neutral-50
--color-text-secondarytext-text-secondaryneutral-500neutral-500
--color-text-tertiarytext-text-tertiaryneutral-400neutral-600
--color-text-disabledtext-text-disabledneutral-300neutral-800
--color-text-disabled-dangertext-text-disabled-dangerred-300red-300
--color-text-error-primarytext-text-error-primaryred-500red-400
--color-input-disabled-texttext-input-disabled-textneutral-300neutral-500 / 40%
--color-text-placeholderplaceholder:text-text-placeholderneutral-400neutral-400
--color-text-whitetext-text-whitewhitewhite
--color-text-error-placeholdertext-text-error-placeholderred-400red-400

背景

表面填充。外层画布饱满;第一、第二和第三描述了渐进嵌套的表面及其交互状态。

Token顺风级浅色深色
--color-background-fullbg-background-fullwhiteneutral-925 (#121212)
--color-background-primary-defaultbg-background-primary-defaultwhiteneutral-800
--color-background-inner-defaultbg-background-inner-defaultwhiteneutral-800 / 60%
--color-background-primary-hoverbg-background-primary-hoverneutral-100neutral-700 / 60%
--color-background-primary-activebg-background-primary-activeneutral-200neutral-800
--color-background-primary-disabledbg-background-primary-disabledneutral-100neutral-800
--color-input-disabled-backgroundbg-input-disabled-backgroundneutral-100neutral-800 / 30%
--color-background-secondary-defaultbg-background-secondary-defaultneutral-100neutral-900
--color-background-secondary-hoverbg-background-secondary-hoverneutral-200neutral-800
--color-background-tertiary-defaultbg-background-tertiary-defaultneutral-200neutral-800
--color-background-tertiary-hoverbg-background-tertiary-hoverneutral-300neutral-700
--color-background-tertiary-errorbg-background-tertiary-errorred-100red-950 / 60%
--color-avatar-neutral-backgroundbg-avatar-neutral-backgroundneutral-300background/primary/default
--color-background-quaternary-defaultbg-background-quaternary-defaultneutral-300neutral-300
--color-background-quaternary-hoverbg-background-quaternary-hoverneutral-400neutral-400
--color-background-quaternary-errorbg-background-quaternary-errorred-200red-200
--color-notification-center-backgroundbg-notification-center-backgroundwhiteneutral-900
--color-segmented-control-backgroundbg-segmented-control-backgroundneutral-100neutral-925 (#121212)
--color-theme-toggle-sidebar-backgroundbg-theme-toggle-sidebar-backgroundneutral-200neutral-800
--color-theme-toggle-sidebar-selected-backgroundbg-theme-toggle-sidebar-selected-backgroundwhiteneutral-700

边框

发际线和对焦环。按钮边框通过悬停和活动而变暗;对焦环是单一的蓝色调。

Token顺风级浅色深色
--color-border-button-defaultborder-border-button-defaultneutral-200neutral-700
--color-border-button-hoverborder-border-button-hoverneutral-300neutral-500
--color-border-button-activeborder-border-button-activeneutral-400neutral-600
--color-border-button-whiteborder-border-button-whitewhitezinc-800
--color-border-checkbox-defaultborder-border-checkbox-defaultneutral-300neutral-700
--color-border-checkbox-hoverborder-border-checkbox-hoverneutral-400neutral-500
--color-border-checkbox-activeborder-border-checkbox-activeneutral-400neutral-500
--color-border-component-detail-containerborder-border-component-detail-containerneutral-200neutral-800
--color-border-ai-profile-cardborder-border-ai-profile-cardneutral-200neutral-800
--color-border-tableborder-border-tableneutral-200neutral-800
--color-border-button-groupborder-border-button-groupneutral-200neutral-600 / 60%
--color-border-sidebar-profile-hoverborder-border-sidebar-profile-hoverneutral-300neutral-600
--color-separator-borderborder-separator-borderneutral-200neutral-800
--color-separator-border-strongborder-separator-border-strongneutral-200neutral-700 / 60%
--color-border-focus-ringring-border-focus-ringblue-500blue-500

图表

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.

Token顺风级浅色深色
--color-chart-trackbg-chart-trackneutral-200neutral-800
--color-chart-cursorbg-chart-cursorneutral-300neutral-700
--color-chart-neutralbg-chart-neutralneutral-300neutral-800
--color-chart-1bg-chart-1teal-400teal-400
--color-chart-1-activebg-chart-1-activeteal-500teal-500
--color-chart-2bg-chart-2lime-400lime-400
--color-chart-2-activebg-chart-2-activelime-500lime-500
--color-chart-3bg-chart-3pink-400pink-400
--color-chart-3-activebg-chart-3-activepink-500pink-500
--color-chart-4bg-chart-4sky-400sky-400
--color-chart-4-activebg-chart-4-activesky-500sky-500
--color-chart-5bg-chart-5purple-400purple-400
--color-chart-5-activebg-chart-5-activepurple-500purple-500
--color-chart-6bg-chart-6blue-400blue-400
--color-chart-6-activebg-chart-6-activeblue-500blue-500
--color-chart-7bg-chart-7emerald-400emerald-400
--color-chart-7-activebg-chart-7-activeemerald-500emerald-500
--color-chart-8bg-chart-8yellow-400yellow-400
--color-chart-8-activebg-chart-8-activeyellow-500yellow-500
--color-chart-agents-barbg-chart-agents-barpurple-300purple-500
--color-chart-agents-bar-activebg-chart-agents-bar-activepurple-400purple-600

状态

语义反馈颜色的含义在不同主题中保持稳定。

Token顺风级浅色深色
--color-state-success-texttext-state-success-textlime-800lime-800
--color-state-success-basebg-state-success-baselime-200lime-200
--color-button-ghost-backgroundbg-button-ghost-backgroundblue-100blue-900
--color-button-ghost-hoverbg-button-ghost-hoverblue-200blue-800
--color-button-ghost-activebg-button-ghost-activeblue-300blue-700
--color-button-ghost-foregroundtext-button-ghost-foregroundblue-700blue-300
--color-notification-information-backgroundbg-notification-information-backgroundblue-100blue-800 / 50%
--color-notification-success-backgroundbg-notification-success-backgroundlime-100lime-800 / 50%
--color-notification-error-backgroundbg-notification-error-backgroundrose-100rose-800 / 50%
--color-badge-neutral-backgroundbg-badge-neutral-backgroundneutral-200neutral-800
--color-team-menu-count-backgroundbg-team-menu-count-backgroundneutral-200neutral-700
--color-team-menu-count-foregroundtext-team-menu-count-foregroundneutral-500neutral-400
--color-tab-count-selected-backgroundbg-tab-count-selected-backgroundblue-100blue-800 / 60%
--color-status-lime-backgroundbg-status-lime-backgroundlime-200lime-950 / 60%
--color-status-lime-texttext-status-lime-textlime-800lime-500
--color-status-yellow-backgroundbg-status-yellow-backgroundyellow-200yellow-950 / 60%
--color-status-yellow-texttext-status-yellow-textyellow-800yellow-500
--color-status-rose-backgroundbg-status-rose-backgroundrose-200rose-950 / 60%
--color-status-rose-texttext-status-rose-textrose-800rose-500
--color-status-cyan-backgroundbg-status-cyan-backgroundcyan-200cyan-950 / 60%
--color-status-cyan-texttext-status-cyan-textcyan-800cyan-400
--color-status-blue-backgroundbg-status-blue-backgroundblue-200blue-950 / 60%
--color-status-blue-texttext-status-blue-textblue-800blue-300
--color-status-purple-backgroundbg-status-purple-backgroundpurple-100purple-900 / 50%
--color-status-purple-texttext-status-purple-textpurple-600purple-300
--color-status-dot-green-halobg-status-dot-green-halogreen-100green-800 / 40%
--color-status-dot-yellow-halobg-status-dot-yellow-haloyellow-200yellow-800 / 40%
--color-status-dot-indigo-halobg-status-dot-indigo-haloindigo-100indigo-800 / 40%