@upmo-ai/theme

中文文档
1.0.0-rc.1发布于 2026/11/03AGPL-3.0-onlyTypeScriptES Module

Upmo的Mantine 9主题,由@upmo-ai/tokens构建。导出主题对象、将Mantine映射到Upmo令牌的css变量解析器以及配色方案连接。

中文使用文档
文档目录3 节
  1. 使用
  2. 深色初级填充
  3. 构建

@upmo-ai /主题

Upmo的Mantine 9主题,完全由 @upmo-ai/tokens。没有颜色, 间距或半径字面值:每个值读取一个标记。

它输出三样东西:

  • upmoTheme ——螳螂 createTheme 对象(原色,类型和 半径缩放,断点,组件默认为脆,锐,边框 看)。
  • cssVariablesResolver -将Mantine的内部颜色变量映射到 Upmo令牌变量。控件上的内联变量 文档,样式表无法覆盖,因此需要此解析器 页面背景,文本,边框和主要填充跟随标记。
  • tokenVariables -原始的名称到标记变量映射,用于测试和 用于文档预览管道。

使用

import '@mantine/core/styles.css';
import '@upmo-ai/tokens/tokens.css';
import { MantineProvider } from '@mantine/core';
import { upmoTheme, cssVariablesResolver } from '@upmo-ai/theme';

export function App({ children }) {
  return (
    <MantineProvider theme={upmoTheme} cssVariablesResolver={cssVariablesResolver}>
      {children}
    </MantineProvider>
  );
}

导入顺序很重要:首先是Mantine的CSS,然后是令牌CSS,然后是任何本地的 覆盖。

深色初级填充

深色原色按钮使用了比浅色更亮、饱和度更高的祖母绿 一个,所以它在黑暗的地面上保持生动。这有两种方法: Mantine的 primaryShade 是 { light: 7, dark: 5 },解析器将 填充初级到 --primary-fill 令牌(在 @upmo-ai/tokens). 盘旋的辉光(--glow-primary)只适用于夜间。

构建

pnpm --filter @upmo-ai/theme build   # tsup: ESM + d.ts

版本与发布记录

@upmo-ai/theme 共发布 2 个版本,首次发布于 2026/11/03;过去 12 个月发布了 2 个版本。

版本发布日期距今
1.0.0-rc.1latest2026/11/03今天
0.0.0-stage2026/11/03今天

关于 @upmo-ai/theme 的常见问题

@upmo-ai/theme 是什么?

Upmo的Mantine 9主题,由@upmo-ai/tokens构建。导出主题对象、将Mantine映射到Upmo令牌的css变量解析器以及配色方案连接。

如何安装 @upmo-ai/theme?

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

@upmo-ai/theme 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@upmo-ai/theme 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@upmo-ai/theme 可以商用吗?

@upmo-ai/theme 使用 AGPL-3.0-only 许可。最严格的 Copyleft:除分发外,通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括,不构成法律意见,请以许可原文为准。

@upmo-ai/theme 还在维护吗?

最新版本 1.0.0-rc.1 发布于 2026/11/03(今天);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。