最近同步 2 分钟前 · new-york

shadcn/ui 组件,从这里更快拉取

位于洛杉矶的 registry 镜像,缓存 ui.shadcn.com 的组件索引与源码。 命令和官方完全一致,只需要把 registry 指向这里。

pnpm dlx shadcn@latest add button --registry https://usame.cfd/r

常用组件

点击卡片复制安装命令

以下组件均从本镜像返回,内容与上游 registry 一致,可直接写入项目。

button

基础按钮,含 default / outline / ghost 变体

add button

input

单行输入框与禁用态样式

add input

dialog

模态对话框,基于 radix-ui

add dialog

dropdown-menu

下拉菜单与子菜单

add dropdown-menu

table

数据表格,含表头与行状态

add table

tabs

标签页切换

add tabs

form

与 react-hook-form 组合的表单

add form

card

内容卡片容器

add card

select

下拉选择器

add select

sheet

侧边抽屉面板

add sheet

toast

轻提示与排队显示

add toast

tooltip

悬浮提示气泡

add tooltip

接入 Registry

components.json

在项目根目录的 components.json 中声明命名空间,之后即可按 @mirror/组件名 引用。

components.json
{
  "registries": {
    "@mirror": "https://usame.cfd/r/{name}.json"
  }
}
Terminal
pnpm dlx shadcn@latest add @mirror/button

常见问题

镜像多久同步一次?

索引每 5 分钟增量拉取一次,组件源码按需回源并缓存 1 小时。命中缓存时不再回源。

和官方 registry 的组件会不一致吗?

不会。镜像只做转发和缓存,返回值与 ui.shadcn.com 逐字节一致;组件的版本仍由你项目里的 shadcn CLI 决定。

会修改我的依赖或 lockfile 吗?

不会。镜像只提供 JSON,安装动作仍由 shadcn CLI 在你本地执行。

为什么有时比直连还慢?

首次回源需要走一次上游,之后命中缓存;冷启动通常出现在新组件或上游更新后的前几分钟。