📝教程

快速开始使用全栈脚手架

了解如何快速配置和启动这个现代化的全栈开发脚手架,几分钟内开始您的项目开发。

D
开发团队
5 分钟

# 快速开始使用全栈脚手架

欢迎使用我们的现代化全栈开发脚手架!这个脚手架集成了 Next.js、Fastify、Prisma 等现代技术栈,让您能够快速开始全栈应用开发。

## 环境要求

在开始之前,请确保您的开发环境满足以下要求:

- Node.js 18.0 或更高版本
- npm 或 yarn 包管理器
- Git 版本控制

## 安装步骤

### 1. 克隆项目

```bash
git clone
cd webWithNode_framework
```

### 2. 安装依赖

```bash
npm install
# 或
yarn install
```

### 3. 配置环境变量

复制环境变量模板文件:

```bash
cp .env.example .env.local
```

编辑 `.env.local` 文件,配置必要的环境变量:

```env
# 数据库配置
DATABASE_URL="postgresql://username:password@localhost:5432/database_name"

# NextAuth 配置
AUTH_SECRET="your-auth-secret"
NEXTAUTH_URL="http://localhost:3000"

# 后端服务配置
BACKEND_PORT=4000
BFF_JWT_SECRET="your-jwt-secret"
```

### 4. 初始化数据库

```bash
npx prisma migrate dev
npx prisma generate
```

### 5. 启动开发服务器

```bash
# 启动前端开发服务器
npm run dev

# 在另一个终端启动后端服务器
npm run dev:server
```

## 项目结构

```
src/
├── app/ # Next.js App Router
│ ├── [locale]/ # 国际化路由
│ │ ├── blog/ # 博客页面
│ │ ├── features/ # 功能页面
│ │ └── ...
│ └── api/ # API 路由
├── components/ # React 组件
│ └── ui/ # UI 组件库
├── lib/ # 工具函数
└── messages/ # 国际化文件

server/ # Fastify 后端
├── routes/ # API 路由
├── services/ # 业务逻辑
└── plugins/ # 插件
```

## 下一步

现在您已经成功启动了开发环境,可以开始:

1. 查看 [功能页面](/features) 了解脚手架的核心功能
2. 阅读 [开发流程](/workflow) 了解开发流程
3. 查看 [技术栈](/pricing) 了解使用的技术

## 常见问题

### Q: 如何添加新的页面?
A: 在 `src/app/[locale]/` 目录下创建新的文件夹和 `page.jsx` 文件。

### Q: 如何添加新的 API 路由?
A: 在 `src/app/api/` 目录下创建新的路由文件。

### Q: 如何自定义主题?
A: 修改 `tailwind.config.cjs` 文件中的主题配置。

## 总结

这个脚手架为您提供了完整的全栈开发环境,包括前端、后端、数据库、认证等核心功能。通过遵循最佳实践和现代化的技术栈,您可以快速构建高质量的应用。

如果您有任何问题,请查看我们的 [FAQ](/faq) 或 [联系我们](/contact)。
#快速开始#配置#开发环境
D

开发团队

全栈开发工程师,专注于现代化 Web 技术