1.3 KiB
1.3 KiB
@koko/ui
工作台共享 UI 包: shadcn/ui(new-york-v4)组件 + 总体样式 + 基准主题(tweakcn "Light Green")。 发布在自建 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(白名单/敏感信息/体积)。