Skip to content

lijie1024512/json-to-ui

Repository files navigation

LowCode Pro - AI 表单生成器

English | 中文

一个基于 Next.js、CopilotKit 和 Formily 的智能表单生成器,通过自然语言描述快速创建和编辑表单。

✨ 项目功能

🤖 AI 驱动的表单生成

  • 智能表单生成:通过自然语言描述,AI 自动生成完整的 Formily JsonSchema 表单
  • 实时预览:表单修改后立即预览效果
  • 字段管理:支持添加、删除、修改表单字段
  • 验证规则:自动生成表单验证规则

🎨 丰富的组件支持

  • 基于 Formilyshadcn/ui 组件库
  • 支持多种表单组件:输入框、选择器、日期选择器、开关等
  • 支持自定义样式和布局

💬 AI 助手功能

  • 专业的表单设计助手,专注于 Formily JsonSchema 表单设计
  • 支持中文对话,友好的交互体验
  • 提供清晰的操作建议和实用的解决方案

🚀 快速开始

环境要求

  • Node.js 18+
  • pnpm(推荐)或 npm/yarn

安装依赖

# 使用 pnpm(推荐)
pnpm install

# 或使用 npm
npm install

# 或使用 yarn
yarn install

环境变量配置

在项目根目录创建 .env.local 文件,配置以下环境变量:

# CopilotKit 配置
NEXT_PUBLIC_COPILOTKIT_RUNTIME_URL=/api/copilotkit
NEXT_PUBLIC_COPILOT_API_KEY=your_copilot_api_key

# OpenAI 配置(用于 AI 功能)
OPENAI_API_KEY=your_openai_api_key
OPENAI_BASE_URL=https://api.openai.com/v1

环境变量说明:

  • NEXT_PUBLIC_COPILOTKIT_RUNTIME_URL: CopilotKit 运行时端点,默认为 /api/copilotkit
  • NEXT_PUBLIC_COPILOT_API_KEY: CopilotKit API Key(可选,如果使用 CopilotKit Cloud)
  • OPENAI_API_KEY: OpenAI API Key(必需,用于 AI 对话功能)
  • OPENAI_BASE_URL: OpenAI API 基础 URL(可选,默认使用官方 API,可配置为自定义端点如 DeepSeek)

启动开发服务器

# 使用 pnpm(推荐)
pnpm dev

# 或使用 npm
npm run dev

# 或使用 yarn
yarn dev

启动后,在浏览器中打开 http://localhost:3000 即可使用。

构建生产版本

pnpm build
pnpm start

📁 项目结构

lowcode-pro/
├── app/
│   ├── page.tsx              # 首页(表单生成器)
│   ├── layout.tsx            # 根布局(包含 CopilotKit 配置)
│   ├── form-builder/         # 表单构建器组件
│   └── api/
│       └── copilotkit/       # CopilotKit API 路由
├── components/               # UI 组件
├── contexts/                # React Context
├── lib/                     # 工具函数和配置
└── formily-schema-prompt-zh.md  # Formily Schema 提示词文档

🛠️ 技术栈

  • 框架: Next.js 15 (App Router)
  • UI 库: shadcn/ui + Radix UI
  • 表单引擎: Formily 2.x
  • AI 集成: CopilotKit
  • 样式: Tailwind CSS
  • 代码编辑器: CodeMirror
  • 语言: TypeScript

📖 使用指南

基础操作

  1. 打开页面后,点击右侧的 AI 助手图标
  2. 通过自然语言描述你想要的表单,例如:
    • "创建一个用户注册表单"
    • "添加一个邮箱输入框"
    • "修改密码字段为必填"
    • "删除用户名字段"

高级功能

  • 自定义样式:可以描述样式需求,如"蓝色边框的输入框"
  • 复杂布局:支持创建包含多个字段组合的表单
  • 表单验证:AI 会自动生成合适的验证规则

📝 开发说明

  • 项目使用 Next.js Turbopack 进行快速开发
  • 表单 Schema 基于 Formily JsonSchema 规范
  • AI 提示词配置在 formily-schema-prompt-zh.md 文件中

🔗 相关资源

📄 License

MIT

About

生成式UI:formily.js+shadcn生成json

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages