关于UI Registry
SSP UI Registry 是基于 Shadcn/UI 扩展的组件库,用于构建 Web 应用程序用户界面的 UI 组件、模板和设计系统的集合
Registry 目前以
React模块为主,Theme 导出可独立适配任何 Tailwind CSS 项目。
SSP UI Registry 以 shadcn/ui 为基础,将能力拆分为可按需引入的 Registry 项。每个模块都包含 index.json 元数据、示例代码与 README,助力在单体或多项目之间复用 UI 与工程能力。
目录概览
全部模块集中在 registry/ssp 目录,按输出形态划分为五类:
theme/
Tailwind v4 主题资产,包含 _theme.json、style.json 与 _metadata 下的构建产物。用于注入统一的 Design Token、配色体系与暗色模式策略。
ui/
shadcn/ui 适配后的基础组件集合,现已覆盖 accordion、alert、badge、button、tooltip 等常用组件。目录内的 index.tsx、example.tsx 可直接复制到页面或二次封装。
block/
复合场景组件,例如 gh-stargazers-button。通过组合多个 UI 单元与交互逻辑,提供可复用的特效、营销或仪表盘模块。
hook/
共享逻辑模块,如 use-cancelable-swr、use-gh-repo。提供状态管理、数据请求与副作用处理的标准实现,方便在应用层快速复用。
item/
工程与脚手架能力,包括 make-api-request(标准化 API 请求模板)、zustand(状态库集成示例)、biome(统一的静态检查配置)。适合在初始搭建或增量重构时统一工程规范。
使用方式
- 浏览 registry.json —
registry.json聚合全部模块的元数据,适合脚本与 CLI 查询。 - 按需拉取模块 — 使用 Registry CLI 或
npx shadcn@latest search @ssp-ui获取对应能力,导入时会同步 README 与示例。 - 落地集成 — Theme 写入 Tailwind 配置;UI/Block 组件直接按需引用;Hook/Item 模块辅助构建网络层、状态层及工程基建。
更多实现细节可参考 shadcn/ui Registry 文档。