Deploying Shelfie to shelfiebook.com

One-time setup

Vercel

1. https://vercel.com -> Sign in with GitHub (ERoske).
2. Add New -> Project, import ERoske/shelfie from the GitHub list.
3. Framework: Next.js (auto-detected). Root directory: leave blank.
4. Environment variables (Project Settings -> Environment Variables, all three environments):
   • SHELFIE_DB_MODE=supabase
   • NEXT_PUBLIC_SUPABASE_URL=https://wvuctaabeoncnptuourd.supabase.co
   • NEXT_PUBLIC_SUPABASE_ANON_KEY=<anon JWT>
   • SUPABASE_SERVICE_ROLE=<service_role JWT> (server-only)
   • SUPABASE_DB_URL=postgresql://postgres.wvuctaabeoncnptuourd:<password>@aws-1-us-east-1.pooler.supabase.com:6543/postgres (server-only)
   • ANTHROPIC_API_KEY=<sk-ant-...>
5. Click Deploy. Wait for the first build. Vercel gives you a *.vercel.app URL. Verify /library loads.

Domain

1. Domains tab in the Vercel project. Add shelfiebook.com and www.shelfiebook.com.
2. Vercel shows the DNS records you need:
   • A record on apex shelfiebook.com pointing to 76.76.21.21 (or the IP Vercel shows).
   • CNAME record on www pointing to cname.vercel-dns.com.
3. Copy those into your registrar's DNS panel. Propagation: 5-30 minutes.
4. Vercel issues SSL automatically once DNS resolves.

Supabase site URL

1. Supabase dashboard -> Authentication -> URL Configuration.
2. Set Site URL to https://shelfiebook.com.
3. Add https://shelfiebook.com/auth/callback to Redirect URLs.
4. Save.

Per-deploy

• Push to main -> Vercel auto-deploys.
• Roll back: Vercel Deployments tab -> previous deploy -> Promote to Production.
• Logs: Vercel Logs tab.

Database migrations

• New SQL files in supabase/migrations/ are not auto-applied by Vercel. Run locally:

  npm run migrate
  

• After a successful migration, push the SQL file. The migration runner records what's applied in public._migrations so re-running is safe.

Pre-launch checklist

• Supabase upgraded to Pro (daily backups, PITR).
• R2 bucket created with versioning enabled.
• DNS records resolve (dig shelfiebook.com).
• SSL active (https://shelfiebook.com returns 200).
• https://shelfiebook.com/library requires login (middleware gating).
• Magic-link email lands within 30 seconds.
• Username claim flow works for a fresh account.
• First-login localStorage migration uploads existing client data.
• Restore drill from RUNBOOK.md completes in under 30 minutes.
• CSP headers, rate limits, and __Host- cookies verified in browser devtools.