Artifacts Builder 是一套用于创建复杂、多组件 claude.ai HTML artifact 的工具,采用现代前端技术栈:React 18 + TypeScript + Vite + Parcel(打包)+ Tailwind CSS + shadcn/ui。
主要用途与流程:先运行 bash scripts/init-artifact.sh <project-name> 初始化 React 项目并进入目录;随后编辑生成的代码开发 artifact;再用 bash scripts/bundle-artifact.sh 将所有代码打包成单一 HTML 文件,生成 bundle.html,其中 JavaScript、CSS 与依赖全部内联,可直接在 Claude 对话中作为 artifact 分享。
初始化脚本会创建已配置好的项目,包含 React + TypeScript(Vite)、Tailwind CSS 3.4.1 与 shadcn/ui 主题系统、路径别名(@/)、预装 40+ shadcn/ui 组件、全部 Radix UI 依赖、Parcel 打包配置(.parcelrc)以及 Node 18+ 兼容(自动检测并固定 Vite 版本)。打包脚本会安装打包依赖(parcel、@parcel/config-default、parcel-resolver-tspaths、html-inline),创建支持路径别名的 .parcelrc,用 Parcel 构建(无 source map),再通过 html-inline 内联全部资源为单一 HTML;要求项目根目录存在 index.html。
设计上特别提醒避免所谓“AI slop”,即避免过度使用居中布局、紫色渐变、统一圆角和 Inter 字体。测试/可视化 artifact 为可选步骤,仅在必要或用户要求时执行,可使用 Playwright、Puppeteer 等工具;一般建议先展示 artifact,之后再按需测试,以免增加延迟。
限制:资料未提供收费、价格、平台支持范围或效果保证等信息。shadcn/ui 组件参考文档见 https://ui.shadcn.com/docs/components。