⚠️ 本项目处于迭代开发阶段,代码与实现可能会有较大改动。
Compcraft 是一个 AI 驱动的前端组件生成平台,致力于通过大模型(LLM)能力自动生成、管理和渲染高质量的前端组件。平台集成了前端智能代码生成、技术栈模板配置、纯前端编译、实时预览等功能,提升前端开发效率。
本项目采用 monorepo 架构,涵盖前端、后端、数据库、渲染器、通用工具等多个模块。
compcraft/
├── packages/
│ ├── api/ # 后端 API 服务,trpc、LLM、业务逻辑
│ ├── apps/
│ │ └── web/ # 前端 Web 应用,Next.js + React + TailwindCSS
│ ├── client/ # 通用的 trpc 客户端封装
│ ├── configs/ # 统一的 ESLint/Prettier 配置
│ ├── db/ # 数据库 ORM、迁移、Redis 支持
│ ├── renderer/ # 组件渲染器
│ └── shared/ # 通用类型、工具、常量
├── package.json # 根依赖与脚本
├── pnpm-workspace.yaml # workspace 配置
├── tsconfig.json # 根 TypeScript 配置
└── ...
- api:后端 API 服务,基于 trpc,集成多种 LLM、S3、业务逻辑等。
- apps/web:主前端应用,Next.js 19,支持 SSR、TailwindCSS、React 19、Zustand、Shadcn/ui 等。
- client:trpc 客户端封装,便于前后端共享类型和调用。
- configs:统一的 ESLint/Prettier 配置,提升多包开发一致性。
- db:数据库 ORM(Drizzle ORM)、Redis 支持、数据迁移脚本。
- renderer:独立渲染器,基于 React + Vite。
- shared:通用类型、工具函数、常量、消息通信等。
- 前端:Next.js 19、React 19、TailwindCSS、Radix UI、Zustand、TanStack Query、Storybook
- 后端:trpc、LangChain、OpenAI/Anthropic/DeepSeek 等 LLM、S3、Zod
- 数据库:Drizzle ORM、PostgreSQL、Redis
- 工具链:pnpm、TypeScript、ESLint、Prettier、Husky
- 渲染:esbuild-wasm、Sass/Less
- 安装依赖
pnpm install- 启动开发环境
- 启动前端 Web 应用:
cd packages/apps/web pnpm dev - 启动渲染器:
cd packages/renderer pnpm dev