快速开始
从零到运行 IndieStack 只需几分钟。
前置条件
- Node.js 18.17+(推荐使用 nvm 管理版本)
- npm 9+ 或 pnpm 8+
- Git
- Supabase CLI(可选,用于本地数据库管理)
- Docker Desktop(可选,用于本地 PostgreSQL)
克隆与安装
bash
git clone <repo-url> indiestack
cd indiestack
pnpm install配置环境变量
bash
cp .env.example .env.local编辑 .env.local,根据你的开发模式配置:
方式一:Mock 模式(推荐开发初期)
无需真实 Supabase 后端,所有数据使用 @faker-js/faker 生成:
bash
# Mock 模式:设为 true,无需配置 Supabase 即可开发
NEXT_PUBLIC_MOCK_ENABLED=true方式二:Supabase 真实后端
需要创建 Supabase 项目并获取配置:
bash
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIs...
NEXT_PUBLIC_MOCK_ENABLED=false启动开发服务器
bash
# 使用 Mock 模式启动(推荐开发初期)
pnpm dev:mock
# 或使用 Supabase 模式
pnpm dev:supabase
# 标准模式
pnpm dev快速体验
IndieStack 启动后,你可以:
- 浏览首页:营销着陆页,展示功能特性
- 查看定价:三档定价方案(Free / Pro / Enterprise)
- 登录体验:Mock 模式下,点击"登录"无需真实凭证即可进入仪表盘
- 探索仪表盘:项目管理、团队协作、分析图表、通知设置
- 切换主题:右上角切换浅色/深色/跟随系统
- 切换语言:右上角切换中文/英文
构建生产版本
bash
pnpm build
pnpm start数据库设置(Supabase 模式)
如使用 Supabase 模式,需初始化数据库:
bash
npx supabase login
npx supabase link --project-ref your-project-ref
pnpm db:migrate
pnpm db:types
npx supabase db seed验证安装
启动后访问以下页面确认一切正常:
| 页面 | 路径 | 说明 |
|---|---|---|
| 首页 | / | 营销着陆页 |
| 功能 | /features | 功能特性介绍 |
| 定价 | /pricing | 定价方案 |
| 登录 | /auth/login | 支持邮箱 + GitHub + Google |
| 注册 | /auth/register | 新用户注册 |
| 仪表盘 | /dashboard | 需要登录后访问 |
| 个人资料 | /dashboard/profile | 用户信息 |
| 团队管理 | /dashboard/team | 创建和邀请团队 |
| 项目 | /dashboard/projects | 项目管理 |
| 分析 | /dashboard/analytics | 使用数据统计 |
| 设置 | /dashboard/settings | 账户和外观设置 |
| 账单 | /dashboard/billing | 订阅管理 |
| API Keys | /dashboard/api-keys | API 密钥管理 |
| 集成 | /dashboard/integrations | 第三方服务连接 |
| 管理后台 | /dashboard/admin | 用户管理(需要管理员角色) |