本地开发

如果你需要改代码，建议前后端分开启动。

1. 准备环境变量

cp .env.example .env

默认配置下：

• 后端端口是 8080
• 前端端口是 3000
• SQLite 数据库是 data/infinite-canvas.db

2. 启动后端

在仓库根目录执行：

go run .

后端会读取根目录 .env，并监听：

http://127.0.0.1:8080

3. 启动前端

在 web 目录执行：

bun run dev

前端默认访问：

http://localhost:3000

开发代理默认转发到 http://127.0.0.1:8080。如果你的后端端口不同，启动前设置 API_BASE_URL。

4. 启动文档站

如果需要单独调整文档站，在 docs 目录执行：

bun run dev

常见场景

• 改画布、页面和交互：主要看 web/
• 改接口、业务逻辑和数据库：主要看仓库根目录下的 Go 代码
• 改文档站内容：主要看 docs/content/docs/