@geti-ui/ui

中文文档
1.7.1发布于 2026/11/05Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 6217

Geti UI component design system

原始使用文档
文档目录5 节
  1. What this package includes
  2. Installation
  3. Quick start
  4. Examples and docs
  5. Development

@geti-ui/ui

Geti UI core design system package for React applications.

@geti-ui/ui provides accessible, production-ready UI primitives and patterns used across Geti products, with a dark-mode-first theme and typed APIs.

What this package includes

  • 80+ components across form, data, feedback, navigation, overlays, and layout
  • Theme integration via ThemeProvider and bundled stylesheet
  • Asset and icon subpath exports:
    • @geti-ui/ui/icons
    • @geti-ui/ui/assets
    • @geti-ui/ui/assets/images
    • @geti-ui/ui/assets/domains
    • @geti-ui/ui/assets/primary-tools

Installation

npm install @geti-ui/ui

Quick start

import '@geti-ui/ui/styles.css';
import { ThemeProvider, Button } from '@geti-ui/ui';

export function App() {
    return (
        <ThemeProvider>
            <Button variant="accent">Get started</Button>
        </ThemeProvider>
    );
}

Examples and docs

  • Installation: documentation/docs/components/installation.mdx
  • Component docs root: documentation/docs/components/
  • Asset docs: documentation/docs/assets/
  • Kitchen sink examples: documentation/docs/examples/

Development

From repository root:

npm run build --workspace=@geti-ui/ui
npm run test --workspace=@geti-ui/ui
npm run test:e2e --workspace=@geti-ui/ui
npm run type-check --workspace=@geti-ui/ui
npm run lint --workspace=@geti-ui/ui
npm run format:check --workspace=@geti-ui/ui

版本与发布记录

@geti-ui/ui 共发布 20 个版本,首次发布于 2026/03/29;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.7.1latest2026/11/0510 天前
1.7.02026/10/2224 天前
1.6.02026/08/202 个月前
1.5.42026/08/063 个月前
1.5.32026/07/104 个月前
1.5.22026/07/094 个月前

关于 @geti-ui/ui 的常见问题

@geti-ui/ui 是什么?

Geti UI component design system

如何安装 @geti-ui/ui?

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

@geti-ui/ui 支持 TypeScript 吗?

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

@geti-ui/ui 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@geti-ui/ui 可以商用吗?

@geti-ui/ui 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@geti-ui/ui 的下载量有多少?

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

@geti-ui/ui 还在维护吗?

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