# Birthday Wall

> Documentation for Birthday Wall — a personalized birthday celebration web app.

## Docs

- [Configure the birthday celebrant and date](https://help.helloazhenweb.top/customization/birthday-config.md): Set the celebrant's name, birthday date, and countdown labels in lib/birthday-config.ts to personalize your Birthday Wall for any occasion.
- [Add songs and playlists to the music radio](https://help.helloazhenweb.top/customization/music-config.md): Curate playlists, add song metadata and lyrics, and configure radio playback behavior in lib/music-config.ts to build a personalized music experience.
- [Site identity, name, and navigation config](https://help.helloazhenweb.top/customization/site-config.md): Update your site's browser title, meta description, canonical URL, and navigation bar layout using lib/site-config.ts and lib/nav-config.ts.
- [Birthday countdown timer — live days to go](https://help.helloazhenweb.top/features/countdown.md): The home page countdown ticks down days, hours, minutes, and seconds to the next birthday, then transforms into a full celebration screen on the day itself.
- [Games room — birthday mini-games](https://help.helloazhenweb.top/features/games.md): The /games page is a full-screen carousel of birthday mini-games. Swipe or click the dot indicators to browse, then launch Cake Drop with a single tap.
- [Music radio — curated birthday playlists](https://help.helloazhenweb.top/features/radio.md): Browse playlists at /radio, pick a song, and watch the animated player show song details and a visualizer while lyrics float across the background.
- [Birthday recap report with music stats](https://help.helloazhenweb.top/features/report.md): The /report page combines your birthday countdown and music library into a three-tab recap, including a full-screen snap-scrollable song-by-song music report.
- [Anonymous wish wall for birthday messages](https://help.helloazhenweb.top/features/wish-wall.md): Visitors write anonymous birthday messages at /write. Wishes are stored in your database, color-coded automatically, and displayed on the home page wall.
- [Birthday Wall: personalized birthday celebration app](https://help.helloazhenweb.top/introduction.md): Birthday Wall is a self-hostable web app for celebrating a birthday with a live countdown, anonymous wish wall, music radio, recap report, and mini-games.
- [Get started with Birthday Wall](https://help.helloazhenweb.top/quickstart.md): Deploy a personalized birthday countdown, wish wall, and music radio in under 10 minutes by forking the repo, configuring Supabase, and deploying to Vercel.
- [Birthday Wall FAQ and troubleshooting guide](https://help.helloazhenweb.top/reference/faq.md): Answers to the most common questions about Birthday Wall features, database setup, self-hosting, wish wall behavior, and the admin panel.
- [Environment variables for Birthday Wall](https://help.helloazhenweb.top/self-hosting/environment.md): Reference for all five environment variables Birthday Wall requires, with a copy-paste .env.local template and guidance on where to set them in Vercel.
- [Self-host Birthday Wall on Vercel and Supabase](https://help.helloazhenweb.top/self-hosting/overview.md): Deploy your own Birthday Wall instance for free using Next.js on Vercel and a Supabase Postgres database — no DevOps experience required.
- [Set up Supabase for the Birthday Wall wish wall](https://help.helloazhenweb.top/self-hosting/supabase.md): Create a Supabase project, run the database migrations to create all required tables, and retrieve the API keys your deployment needs.
- [Deploy Birthday Wall to Vercel](https://help.helloazhenweb.top/self-hosting/vercel.md): Push your fork to GitHub, import the repo into Vercel, add environment variables, and go live — the entire process takes under ten minutes.