CoolFace
Apppublic

duqing026/shadcn-forge-cn

sourceHugging Faceupdated 8mo agoView on Hugging Face
0likes
App README

Shadcn Forge CN

项目简介

这是一个基于 React + TypeScript + Tailwind CSS 的组件库生成器,旨在提供类似 shadcn/ui 的源码拷贝体验。 包含:

  • packages/ui: 核心组件库(12+ 组件,Radix UI 底层)
  • packages/cli: 命令行工具 (init/add/doctor)
  • apps/docs: 文档与组件展示站

架构

Monorepo 结构 (npm workspace):

  • apps/docs: Next.js 演示站点
  • packages/ui: 组件源码仓库
  • packages/cli: CLI 工具

快速开始

1. 安装依赖

bash
npm install

2. 启动文档站 (Showcase)

bash
npm run dev

3. 构建

bash
npm run build

3. 使用 CLI (本地测试)

bash
# 在 apps/docs 中测试添加组件
cd packages/cli
pnpm build
cd ../../apps/docs
# 模拟运行
node ../../packages/cli/dist/index.js add button

交付物清单

  • [x] Button, Input, Textarea, Label, Checkbox, RadioGroup, Switch, Select, Dialog, DropdownMenu, Tabs, Toast
  • [x] CLI (init, add, doctor)
  • [x] MDX/Showcase 文档站
  • [x] Dockerfile (Hugging Face Ready)
  • [x] Dark Mode 支持

验收测试

  1. 1.运行 pnpm test 执行组件测试。
  2. 2.运行 pnpm dev 查看文档站所有组件交互。
  3. 3.检查 Docker 构建 docker build -t shadcn-forge .