Next-Forge 项目安装与初始化指南

Next-Forge 项目安装与初始化指南

next-forge A production-grade boilerplate for modern Next.js apps. 项目地址: https://gitcode.com/gh_mirrors/ne/next-forge

项目概述

Next-Forge 是一个基于 Next.js 的全栈开发框架，它整合了现代 Web 开发所需的各种工具和功能模块。本文将详细介绍如何从零开始安装和初始化一个 Next-Forge 项目。

环境准备

在开始之前，请确保你的开发环境中已经安装了以下工具：

1. Node.js (建议使用 LTS 版本)
2. 你选择的包管理器 (npm/yarn/pnpm)
3. Git (用于版本控制)

项目初始化

第一步：创建新项目

打开终端，执行以下命令来初始化一个新的 Next-Forge 项目：

npx next-forge@latest init

执行此命令后，系统会引导你完成以下配置步骤：

1. 项目命名：输入你的项目名称（如 my-app）
2. 包管理器选择：选择你偏好的包管理器（npm/yarn/pnpm）

初始化完成后，系统会自动：

• 创建项目目录
• 克隆必要的仓库文件
• 运行安装脚本
• 设置基础环境变量文件

第二步：安装依赖

项目初始化完成后，进入项目目录并安装依赖：

cd my-app
npm install

数据库设置

Next-Forge 使用 Prisma 作为 ORM 工具，并默认配置了 Neon 数据库支持。

数据库迁移

执行以下命令来初始化数据库：

npm run migrate

这个命令会：

1. 读取 packages/database/prisma/schema.prisma 中的数据库模型定义
2. 生成迁移文件
3. 将模型同步到数据库

CMS 配置

Next-Forge 集成了 BaseHub CMS 系统，配置步骤如下：

1. 在 BaseHub 平台上创建项目模板
2. 获取 Read Token（从"Connect to Your App"页面）
3. 将获取的 BASEHUB_TOKEN 添加到项目的环境变量文件中

开发环境启动

完成上述配置后，可以启动开发服务器：

npm run dev

启动后，系统会运行多个服务，默认端口分配如下：

• 3000端口：主应用界面
• 3001端口：项目网站
• 3002端口：API 服务
• 3003端口：邮件预览服务
• 3004端口：文档服务

常见问题解决

1. 初始化失败：检查网络连接，确保能正常访问包管理仓库
2. 数据库连接问题：检查 .env 文件中的数据库连接配置
3. CMS 内容不显示：确认 BASEHUB_TOKEN 已正确配置且具有读取权限

后续步骤

完成基础安装后，你可以：

1. 修改 schema.prisma 文件来定义自己的数据模型
2. 定制 CMS 内容结构
3. 开始开发你的业务逻辑

通过以上步骤，你已经成功搭建了 Next-Forge 的开发环境，可以开始你的全栈开发之旅了。

next-forge A production-grade boilerplate for modern Next.js apps. 项目地址: https://gitcode.com/gh_mirrors/ne/next-forge