@eduzz/ui-tailwind-theme

中文文档
5.0.0发布于 2026/09/01MIT零依赖近 30 天下载 2300

Eduzz UI: Tailwind Theme

原始使用文档
文档目录9 节
  1. Instalação
  2. Importação
  3. Sem Preflight
  4. Prefixos
  5. Customização
  6. Tokens
  7. Cores que mudam de acordo com o tema (light e dark)
  8. Utilidades
  9. Belts

Eduzz UI: Tailwind Theme

version size

Aplica os Tokens de UI da Eduzz no Tailwind.

Instalação

pnpm add @eduzz/ui-tailwind-theme

Importação

No arquivo css principal do seu projeto adicione o código abaixo na primeira linha:

@import "@eduzz/ui-tailwind-theme";

Note que não é necessário importar o tailwind via @import "tailwindcss"; pois já é feito através do import do @eduzz/ui-tailwind-theme.

Com isso é só sair utilizando as classes =]

Sem Preflight

Se o Preflight do Tailwind conflitar com estilos base existentes, use a entrada sem Preflight:

@import "@eduzz/ui-tailwind-theme/no-preflight.css";

Prefixos

Para utilizar os prefixos basta adicionar prefix(nome) após a importação do @eduzz/ui-tailwind-theme

@import '@eduzz/ui-tailwind-theme' prefix(name);

Customização

Todos os tokens são configuráveis através do @theme então caso queira substituir uma cor basta apenas sobrescrever:

@import "@eduzz/ui-tailwind-theme";

@theme {
  --color-primary-500: #ff0000;
}

Tokens

A maior parte das tokens seguem os padrões do tailwind, abaixo é listado as cores que foram adicionadas para seguir os padrões Eduzz. Onde o * pode ser trocado pelos utilities do tailwind como bg-*, text-*, etc

Cores que mudam de acordo com o tema (light e dark)

ClasseDescrição
*-primaryCor primária
*-surface-defaultCor de fundo padrão
*-surface-subtleCor de fundo dos containers
*-surface-disabledCor de fundo desabilitado
*-outline-defaultCor de borda padrão
*-outline-disabledCor de borda sútil
*-outline-darkerCor de borda mais escura
*-content-titleCor de texto principal
*-content-bodyCor de texto secundário
*-content-subtitleCor de texto terciário
*-content-captionCor de texto quaternário
*-content-negativeCor de texto negativo
*-content-disabledCor de texto desabilitado

Utilidades

É recomendada a utilização *-primary-500 como cor primária no light mode

ClasseDescrição
rounded-defaultRaio de borda padrão
shadow-xsSombra sútil
shadow-smSombra média
shadow-mdSombra padrão
*-primary-400 #163E91
*-primary-500 #0D2772
*-primary-600 #0E2568
*-primary-700 #0F235C
*-primary-800 #102050
*-primary-900 #111F49
*-primary-950 #0A132C

Belts

ClasseCor
*--belt-white: #D9D9D9
*--belt-red #FF4141
*--belt-orange #FFA439
*--belt-green #33DB7A
*--belt-black #000000
*--belt-golden #FFCE00
*--belt-white-foreground #4D4D4D
*--belt-red-foreground #4D1414
*--belt-orange-foreground #4D3111
*--belt-green-foreground #124D2B
*--belt-black-foreground #FFFFFF
*--belt-golden-foreground #4D3E00

版本与发布记录

@eduzz/ui-tailwind-theme 共发布 56 个版本,首次发布于 2023/07/20;过去 12 个月发布了 25 个版本。

版本发布日期距今
5.0.0latest2026/09/012 个月前
5.0.0-rc.19rc2026/08/202 个月前
5.0.0-rc.182026/08/172 个月前
5.0.0-rc.172026/08/172 个月前
5.0.0-rc.162026/08/133 个月前
5.0.0-rc.152026/08/103 个月前

关于 @eduzz/ui-tailwind-theme 的常见问题

@eduzz/ui-tailwind-theme 是什么?

Eduzz UI: Tailwind Theme

如何安装 @eduzz/ui-tailwind-theme?

在项目目录运行 npm install @eduzz/ui-tailwind-theme,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:tailwindcss(^4.3.3)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@eduzz/ui-tailwind-theme 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/eduzz__ui-tailwind-theme 是否存在。

@eduzz/ui-tailwind-theme 可以商用吗?

@eduzz/ui-tailwind-theme 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@eduzz/ui-tailwind-theme 的下载量有多少?

根据 npm 官方下载统计,@eduzz/ui-tailwind-theme 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,300 次,日均约 77 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@eduzz/ui-tailwind-theme 还在维护吗?

最新版本 5.0.0 发布于 2026/09/01(2 个月前);至今共发布 56 个版本,其中过去 12 个月发布了 25 个;首次发布于 2023/07/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。