Skip to main content

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.

This page covers the questions that come up most often when setting up and running Birthday Wall. If you run into an issue not listed here, check the browser console and your Vercel deployment logs for specific error messages — they almost always point directly to the cause.
No. The radio feature is a visual music experience. It displays song metadata (title, artist, album), lyrics, and themed background imagery, but it does not stream or play any audio files. No music licensing or audio hosting is required to use it.
Yes. When a visitor submits a wish, Birthday Wall stores a hash of their IP address — not the IP address itself — for rate limiting purposes only. This hash cannot be reversed to recover the original IP. No name, email address, or other identifying information is collected or saved alongside a wish.
Edit the birthday date in lib/birthday-config.ts and then redeploy your site (or restart the local dev server with npm run dev if you are working locally). The countdown reads its target date from that config file at runtime, so a file edit followed by a redeploy is all that is needed.
Nothing is wrong — this is intentional. On the birthday itself the countdown reaches zero and stays there. The morning after the birthday, the countdown automatically resets and begins counting down to the same date in the following year. If you see zero on a day that is not the birthday, double-check the date value in lib/birthday-config.ts and confirm you are in the correct timezone.
There are two common causes:
  1. Missing or incorrect Supabase credentials — verify that NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, and SUPABASE_SERVICE_ROLE_KEY are set correctly in your environment. On Vercel, check Settings → Environment Variables and redeploy after making any changes.
  2. API error on submission — open your browser’s developer tools, go to the Console or Network tab, and resubmit the wish. Any error response from the /api/ routes will appear there with a specific message.
If the wish shows a success message but still does not appear, check the messages table directly in the Supabase Table Editor to confirm the row was inserted.
The games room is designed for future expansion. At the moment, only Cake Drop is available. New games are added as new routes under /games/ and linked from the games lobby. Adding a new game requires a code change and redeployment.
Birthday Wall is designed around a single celebrant at a time. The name, birthday date, and all personalized content are configured for one person. To celebrate multiple people, deploy separate instances of the app — each with its own Vercel project, Supabase project, and birthday configuration. Vercel’s free hobby plan allows multiple projects.
Navigate to /admin in your browser (or admin.<your-domain> if you have configured the admin subdomain). You will be redirected to /admin/login. Enter the email and password of your admin account. Once logged in, you can view all submitted messages and manage page visibility and registration codes from the admin panel.
Yes. The following pages work without any Supabase connection:
  • Home (/) — countdown timer
  • Radio — song metadata and lyrics display
  • Report (/report) — the annual report page
  • Games (/games) — Cake Drop and the games lobby
Only the wish wall requires a database: the /write page (submitting a wish) and the messages wall (displaying wishes) will both return errors if Supabase is not configured. You can safely deploy without Supabase if you do not need the wish wall feature.
You can delete messages directly from the Supabase dashboard without writing any code:
  1. Open your Supabase project and click Table Editor in the left sidebar.
  2. Select the messages table.
  3. To delete individual rows, select them and click the Delete button.
  4. To clear all wishes at once, open the SQL Editor and run:
DELETE FROM messages;
This action is irreversible. Make sure you have a backup or export if you want to preserve the data before clearing it.