关于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.jsonstyle.json_metadata 下的构建产物。用于注入统一的 Design Token、配色体系与暗色模式策略。

ui/

shadcn/ui 适配后的基础组件集合,现已覆盖 accordionalertbadgebuttontooltip 等常用组件。目录内的 index.tsxexample.tsx 可直接复制到页面或二次封装。

block/

复合场景组件,例如 gh-stargazers-button。通过组合多个 UI 单元与交互逻辑,提供可复用的特效、营销或仪表盘模块。

hook/

共享逻辑模块,如 use-cancelable-swruse-gh-repo。提供状态管理、数据请求与副作用处理的标准实现,方便在应用层快速复用。

item/

工程与脚手架能力,包括 make-api-request(标准化 API 请求模板)、zustand(状态库集成示例)、biome(统一的静态检查配置)。适合在初始搭建或增量重构时统一工程规范。

使用方式

  1. 浏览 registry.jsonregistry.json 聚合全部模块的元数据,适合脚本与 CLI 查询。
  2. 按需拉取模块 — 使用 Registry CLI 或 npx shadcn@latest search @ssp-ui 获取对应能力,导入时会同步 README 与示例。
  3. 落地集成 — Theme 写入 Tailwind 配置;UI/Block 组件直接按需引用;Hook/Item 模块辅助构建网络层、状态层及工程基建。

更多实现细节可参考 shadcn/ui Registry 文档