InsForge/insforge-templates：InsForge 官方全栈模板仓库，提供生产级 Next.js/React 启动器与应用模板，开箱即用集成认证、数据库、存储与 AI 服务，助你本页整理它解决什么问题、适用场景、安装方式和使用方法。
InsForge 官方全栈模板仓库，提供生产级 Next.js/React 启动器与应用模板，开箱即用集成认证、数据库、存储与 AI 服务，助你快速构建可部署产品。
InsForge Templates 是 InsForge 官方提供的全栈应用模板仓库，定位为生产级项目启动器与完整应用范例。仓库包含两类模板：框架启动器（Next.js 和 React）帮助开发者从干净起点学习 InsForge 集成；应用模板（chatbot、crm、e-commerce）则提供功能完整的业务场景解决方案。所有模板均预置与 InsForge 平台（认证、数据库、存储、AI）的深度集成，旨在让开发者能跳过基础架构配置，直接聚焦业务逻辑开发，快速构建可部署的真实产品。
该仓库解决开发者从零搭建全栈应用时重复进行后端服务集成（用户认证、数据库设计及安全策略、文件存储、AI 接口）的痛点。通过提供经过验证的模板，它消除了初始项目配置的繁琐工作，确保遵循安全最佳实践（如行级安全策略 RLS），并统一了与 InsForge 平台的交互模式。这大幅缩短了项目启动时间，降低了集成风险，使团队能直接进入功能开发阶段。
主要适用场景包括：1）学习目的：通过 Next.js 或 React 启动器了解如何将 InsForge 认证、数据库服务集成到现代前端框架中；2）快速原型：需要具备用户系统、持久化聊天记录和文件上传功能的 AI 对话应用（chatbot 模板）；3）内部工具：构建包含销售管道、线索管理和客户数据的 CRM 系统（crm 模板）；4）电商项目：启动带有商品目录、购物车、结算流程和用户账户的在线商店（e-commerce 模板）。所有场景均设计为可直接投入生产使用。
推荐安装方式为使用 InsForge CLI 一键创建：执行命令 `npx @insforge/cli create`，跟随交互式指引选择模板并自动链接 InsForge 项目。手动安装步骤为：克隆本仓库，进入目标模板目录（如 `chatbot/`），运行 `npm install` 安装依赖；复制该模板的 `.env.example` 文件为 `.env`，并填入从 InsForge 控制台获取的项目 URL、匿名密钥等环境变量；最后根据模板 README 执行数据库迁移（如 `npx @insforge/cli db import migrations/db_init.sql`）以初始化表结构和种子数据。
本地开发时，配置好环境变量后运行 `npm run dev` 启动开发服务器。各模板提供特定功能配置：chatbot 模板需在 `.env` 中设置 `AI_PROVIDER`（`insforge` 或 `vercel`）及对应 API 密钥以启用 AI 对话；crm 模板可通过界面中的“Seed Defaults”按钮或 API 端点加载初始演示数据。所有模板均设计为可直接部署至 Vercel，需在 Vercel 项目设置中配置相同的环境变量。详细步骤请参考各模板目录下的 `README.md` 文件。
每个模板目录均为独立项目，拥有自己的 `package.json`、依赖和设置说明，互不干扰。技术实现上，UI 层基于 Tailwind CSS 和 shadcn/ui 构建一致设计系统；数据层通过 InsForge 客户端封装访问 PostgreSQL，并在 CRM、电商等模板中显式实施行级安全策略（RLS）保障数据隔离；chatbot 模板抽象了 AI 提供商接口，支持切换 InsForge AI 或 Vercel AI Gateway。部署方面，模板配置与 Vercel 环境高度兼容，且提供 `migrations/db_init.sql` 用于标准化数据库初始化。
InsForge 官方全栈模板仓库，提供生产级 Next.js/React 启动器与应用模板，开箱即用集成认证、数据库、存储与 AI 服务，助你快速构建可部署产品。
InsForge Templates 是 InsForge 官方提供的全栈应用模板仓库，定位为生产级项目启动器与完整应用范例。仓库包含两类模板：框架启动器（Next.js 和 React）帮助开发者从干净起点学习 InsForge 集成；应用模板（chatbot、crm、e-commerce）则提供功能完整的业务场景解决方案。所有模板均预置与 InsForge 平台（认证、数据库、存储、AI）的深度集成，旨在让开发者能跳过基础架构配置，直接聚焦业务逻辑开发，快速构建可部署的真实产品。
推荐安装方式为使用 InsForge CLI 一键创建：执行命令 `npx @insforge/cli create`，跟随交互式指引选择模板并自动链接 InsForge 项目。手动安装步骤为：克隆本仓库，进入目标模板目录（如 `chatbot/`），运行 `npm install` 安装依赖；复制该模板的 `.env.example` 文件为 `.env`，并填入从 InsForge 控制台获取的项目 URL、匿名密钥等环境变量；最后根据模板 README 执行数据库迁移（如 `npx @insforge/cli db import migrations/db_init.sql`）以初始化表结构和种子数据。
本地开发时，配置好环境变量后运行 `npm run dev` 启动开发服务器。各模板提供特定功能配置：chatbot 模板需在 `.env` 中设置 `AI_PROVIDER`（`insforge` 或 `vercel`）及对应 API 密钥以启用 AI 对话；crm 模板可通过界面中的“Seed Defaults”按钮或 API 端点加载初始演示数据。所有模板均设计为可直接部署至 Vercel，需在 Vercel 项目设置中配置相同的环境变量。详细步骤请参考各模板目录下的 `README.md` 文件。