# 快速开始使用全栈脚手架
欢迎使用我们的现代化全栈开发脚手架!这个脚手架集成了 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)。