快速开始
5 分钟搭建本地开发环境
代码仓库
- 社区 Web（主仓库）：hackathonweekly/community
- 小程序端（WebView 容器）：hackathonweekly/mini-community
前置要求
快速启动
# 1. 克隆项目
git clone https://github.com/hackathonweekly/community.git
cd community
# 2. 安装依赖
pnpm install
# 3. 配置环境变量
cp apps/web/.env.example apps/web/.env.local
# 编辑 apps/web/.env.local，至少设置以下必填项必填环境变量
# 数据库连接
DATABASE_URL="postgresql://username:password@host:port/database"
# Better Auth 密钥（生成方式: openssl rand -base64 32）
BETTER_AUTH_SECRET="your-random-secret-key"
# 站点地址
NEXT_PUBLIC_SITE_URL="http://localhost:3000"# 4. 初始化数据库
pnpm db:push
# 5. 启动开发服务器
pnpm dev访问 http://localhost:3000 查看网站。
小程序端说明（WebView）
小程序端代码位于独立仓库 hackathonweekly/mini-community，主要通过 WebView 承载社区 H5 页面。
使用前请确认：
- 小程序主体为企业资质（WebView/业务域名配置通常需要企业主体）
- 已在微信小程序后台配置合法业务域名（HTTPS）
- Web 站点可正常访问（建议先完成本仓库部署）
开发工具入口
| 工具 | 地址 | 说明 |
|---|---|---|
| 网站首页 | http://localhost:3000 | 本地开发站点 |
| API 文档 | http://localhost:3000/api/docs | Scalar UI (OpenAPI) |
| Prisma Studio | http://localhost:5555 | 数据库可视化管理 |
启动 Prisma Studio：
pnpm db:studio常见首次运行问题
pnpm: command not found
npm install -g pnpm数据库连接失败
- 检查
DATABASE_URL格式是否正确 - 确认数据库服务正在运行
- 验证用户名和密码
端口 3000 被占用
pnpm dev -- -p 3001TypeScript 类型错误
pnpm db:generate # 重新生成 Prisma 客户端
pnpm type-check # 检查类型
rm -rf .next # 清除缓存后重试