> ## Documentation Index
> Fetch the complete documentation index at: https://help.helloazhenweb.top/llms.txt
> Use this file to discover all available pages before exploring further.

# Birthday Wall：个性化生日庆祝应用

> Birthday Wall 是一款可自托管的 Web 应用，用实时倒计时、匿名祝福墙、音乐电台、年度回顾报告和小游戏来庆祝某人的生日。

Birthday Wall 是一款开源 Web 应用，你可以为某一位寿星单独部署一份。访客打开站点会看到实时倒计时页面、留下祝福、收听精心挑选的音乐电台、玩小游戏，并浏览年度回顾报告。所有内容均可配置：姓名、日期、问候语、音乐。部署与数据都由你掌控。

## 核心功能

<CardGroup cols={2}>
  <Card title="生日倒计时" icon="timer">
    全屏实时计时器显示距离生日的天、时、分、秒。当生日当天到来时，倒计时会自动切换为庆祝信息。
  </Card>

  <Card title="祝福墙" icon="heart">
    访客可以写下匿名生日祝福，并保存到你的 Supabase 数据库中。你可以在管理后台审阅和管理提交内容。
  </Card>

  <Card title="音乐电台" icon="music">
    精选歌单页面，访客可以收听你为寿星挑选的歌曲，主页还会有歌词作为氛围装饰漂浮飘过。
  </Card>

  <Card title="年度回顾报告" icon="chart-bar">
    可分享的年度回顾页面，总结寿星的一年 — 一份个人版的"Spotify Wrapped"式生日报告。
  </Card>

  <Card title="小游戏" icon="gamepad-2">
    一个小游戏房间，访客可以在等待生日来临或当天庆祝时玩耍。
  </Card>

  <Card title="可自托管" icon="server">
    几分钟即可部署到 Vercel。你掌控数据、域名和所有配置，不被任何第三方平台锁定。
  </Card>
</CardGroup>

## 适合谁用

Birthday Wall 适合任何想要做出比群聊祝福更用心的人。如果你想在生日当天送给某人一个专属空间 — 带有定制的倒计时、好友们的祝福，以及一份专为他/她准备的歌单 — Birthday Wall 就是一个很好的起点。

你不必是开发者也能使用它，但你需要克隆仓库、设置一些环境变量，并部署到 Vercel。[快速开始](/zh/quickstart) 会一步步引导你完成整个过程。

## 工作原理

访客在 Birthday Wall 的浏览路径遵循 `lib/nav-config.ts` 中定义的五个页面：

1. **首页（`/`）** — 倒计时页面。访客会看到寿星的姓名、实时计时器，以及从音乐配置中提取的歌词在背景中漂浮。生日当天，计时器会被庆祝信息和一个跳转到 `/write` 的祝福链接替代。
2. **电台（`/radio`）** — 音乐页面。访客可以浏览并播放你配置的精选歌单中的歌曲。
3. **写祝福（`/write`）** — 祝福墙提交表单。访客输入一段生日祝福并提交，留言会被保存到 Supabase。
4. **报告（`/report`）** — 年度回顾。一份关于寿星这一年的可视化总结，可作为生日纪念分享出去。
5. **游戏（`/games`）** — 游戏房间。包含一组小游戏，访客可以玩着庆祝。

站点名称和所有寿星信息分别在两个配置文件中设置：`lib/site-config.ts` 控制站点身份，`lib/birthday-config.ts` 控制寿星姓名、生日日期与问候语。

<Note>
  倒计时、电台和游戏页面无需数据库即可运行。只有当你希望祝福墙保存留言时，才需要 Supabase。
</Note>

## 下一步

<Card title="快速开始：10 分钟内完成部署" icon="rocket" href="/zh/quickstart">
  Fork 仓库、配置环境，让 Birthday Wall 在本地和 Vercel 上跑起来。
</Card>