Yoyo 的生日留言簿

V0 是一个公开访问的生日留言簿，底层按通用留言小站设计。

项目维护说明见：docs/project-maintenance.md

本地运行前准备

1. 安装 Node.js。推荐安装 LTS 版本，安装后终端里需要能运行：

node -v
npm -v

2. 安装项目依赖：

npm install

3. 新建 .env.local 文件，填入 Supabase 项目信息：

NEXT_PUBLIC_SUPABASE_URL=https://dosaowsmgopkfnmcbymt.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=粘贴你的 Supabase anon key

不要把 .env.local 上传到代码仓库。

Supabase 初始化

当前项目的 Supabase 数据库已通过 MCP 初始化完成；如果你使用的是同一个项目，可以跳过本节。

1. 在 Supabase 后台打开 SQL Editor。
2. 按顺序复制并执行 supabase/migrations/ 里的 SQL。
3. 在 Authentication 里创建 Yoyo 的邮箱密码登录用户。
4. 复制这个 Auth 用户的 UUID。
5. 打开 supabase/seed/0001_yoyo_seed.sql，替换：
   • PASTE_YOYO_AUTH_USER_ID_HERE
   • PASTE_YOYO_LOGIN_EMAIL_HERE
6. 在 SQL Editor 执行替换后的 seed 脚本。

本地验证

启动项目：

npm run dev

打开：

http://localhost:3000/s/yoyo
http://localhost:3000/admin/login

Vercel 测试部署

推荐流程：

1. 把这个项目上传到 GitHub 仓库。
2. 打开 Vercel，选择 Add New... -> Project。
3. 选择刚上传的 GitHub 仓库并导入。
4. Framework Preset 选择或保持 Next.js。
5. 在 Environment Variables 里添加：

NEXT_PUBLIC_SUPABASE_URL=https://dosaowsmgopkfnmcbymt.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=你的 Supabase anon key

6. 点击 Deploy。
7. 部署完成后打开：

https://你的项目名.vercel.app/s/yoyo
https://你的项目名.vercel.app/admin/login

注意：不要把 .env.local 上传到 GitHub；它已经在 .gitignore 里。

V0 范围

已按文档范围实现公开留言、私密留言、后台审核、留言管理、站点配置和 cream_pixel 视觉风格。

V0 不包含图片上传、背景音乐、倒计时、多用户创建页面、主题选择器、模板切换器、自定义域名、防刷、留言导出和永久删除。