WDC SaaS Starter Kit 安装与配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00837/article/details/146810059

WDC SaaS Starter Kit 安装与配置指南

wdc-saas-starter-kit 项目地址: https://gitcode.com/gh_mirrors/wd/wdc-saas-starter-kit

1. 项目基础介绍

WDC SaaS Starter Kit 是一个开源项目，旨在为开发基于 SaaS 的应用程序提供一个起点。该项目使用 TypeScript 作为主要的编程语言，包含了 Next.js、Drizzle ORM、Tailwind CSS 等现代技术栈，可以帮助开发者快速搭建具有用户认证、订阅管理、文件上传等功能的 SaaS 应用。

2. 项目使用的关键技术和框架

Next.js: 用于构建服务端渲染的 React 应用程序。
TypeScript: 提供类型系统，增强代码的健壮性。
Drizzle ORM: 用于数据库交互的对象关系映射库。
Tailwind CSS: 实用第一的 CSS 框架，用于快速开发响应式设计。
Posthog Analytics: 用于追踪和分析用户行为。
Stripe: 用于处理支付和订阅管理。

3. 项目安装和配置准备工作及详细步骤

准备工作

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

Node.js: 运行 JavaScript 代码的服务器端运行时。
Docker: 容器化技术，用于运行数据库等依赖。
Git: 代码版本控制系统。

安装步骤

克隆项目

首先，在您的计算机上创建一个新的目录，然后使用 Git 克隆项目：

mkdir wdc-saas-starter-kit
cd wdc-saas-starter-kit
git clone https://github.com/webdevcody/wdc-saas-starter-kit.git .

配置环境变量

将 .env.sample 文件复制为 .env 文件，并填入您的环境变量，如数据库 URL、Stripe API 密钥等。
```
cp .env.sample .env
```
安装依赖

使用 npm 安装项目依赖：
```
npm i
```
运行 Docker

使用 Docker Compose 启动项目所需的服务，如数据库：
```
docker-compose up
```
迁移数据库

运行数据库迁移脚本，以确保数据库结构正确：
```
npm run db:migrate
```
启动开发服务器

运行以下命令启动开发服务器：
```
npm run dev
```
此时，项目应该会在 http://localhost:3000 上运行。
完成配置

根据项目需求，配置电子邮件服务、Stripe 设置、认证提供者（如 Google）等。
- 配置电子邮件服务，如 Resend。
- 在 Stripe 仪表板上设置产品、价格和订阅。
- 设置 Stripe Webhook 端点。
- 配置 OAuth 提供者，如 Google。