跳转到主要内容

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

核心功能

生日倒计时

全屏实时计时器显示距离生日的天、时、分、秒。当生日当天到来时,倒计时会自动切换为庆祝信息。

祝福墙

访客可以写下匿名生日祝福,并保存到你的 Supabase 数据库中。你可以在管理后台审阅和管理提交内容。

音乐电台

精选歌单页面,访客可以收听你为寿星挑选的歌曲,主页还会有歌词作为氛围装饰漂浮飘过。

年度回顾报告

可分享的年度回顾页面,总结寿星的一年 — 一份个人版的”Spotify Wrapped”式生日报告。

小游戏

一个小游戏房间,访客可以在等待生日来临或当天庆祝时玩耍。

可自托管

几分钟即可部署到 Vercel。你掌控数据、域名和所有配置,不被任何第三方平台锁定。

适合谁用

Birthday Wall 适合任何想要做出比群聊祝福更用心的人。如果你想在生日当天送给某人一个专属空间 — 带有定制的倒计时、好友们的祝福,以及一份专为他/她准备的歌单 — Birthday Wall 就是一个很好的起点。 你不必是开发者也能使用它,但你需要克隆仓库、设置一些环境变量,并部署到 Vercel。快速开始 会一步步引导你完成整个过程。

工作原理

访客在 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 控制寿星姓名、生日日期与问候语。
倒计时、电台和游戏页面无需数据库即可运行。只有当你希望祝福墙保存留言时,才需要 Supabase。

下一步

快速开始:10 分钟内完成部署

Fork 仓库、配置环境,让 Birthday Wall 在本地和 Vercel 上跑起来。