工作台共享 UI 包: shadcn/ui 官方 base-nova(Base UI)组件 50 个 + DatePicker/DateRangePicker + 总体样式 + 基准主题(tweakcn "Light Green")。上游版本见 src/UPSTREAM.json。升级: npm run sync → diff → tsc → 发版。发布在自建 Gitea npm registry,匿名可读——包内不得有任何敏感信息。

边界(硬规则)

本包只含: 主要组件(src/components/ui)、tokens.css、styles.css、cn 工具。
使用方仓库只允许覆盖品牌变量: --primary --primary-foreground --ring --accent --accent-foreground --chart-1 --sidebar-primary --sidebar-primary-foreground --sidebar-ring。
圆角、字体、间距、组件外观、新增组件、修 bug → 一律回本仓库改并发版。

使用方

# .npmrc (无需 token)
@koko:registry=https://git.colinx.one/api/packages/koko/npm/

npm i @koko/ui

/* app 全局 CSS */
@import "tailwindcss";
@import "@koko/ui/styles.css";
@source "../node_modules/@koko/ui/src";

/* 可选: 品牌覆盖(唯一允许的改动) */
:root { --primary: oklch(...); --ring: oklch(...); }

import { Button, Card } from "@koko/ui"

宿主需自备 react>=19、tailwindcss>=4。

发版(维护者)

npm version patch|minor      # 改版本
GITEA_NPM_TOKEN=... npm publish   # prepublishOnly 自动跑护栏

同名同版本不可重发。护栏: scripts/prepublish-check.mjs(白名单/敏感信息/体积)。