Troubleshooting
Fix common Buxmate issues — auth, email, invites, payments, and photos.
Sign up / login
"Invalid origin" on signup
Cause: Production auth URLs do not match the site you are visiting.
Fix (organiser hosting): In Vercel, set both to your real app URL:
NEXT_PUBLIC_APP_URL=https://app.buxmate.comBETTER_AUTH_URL=https://app.buxmate.com
Redeploy after changing env vars.
Redirect loop after login
Cause: BETTER_AUTH_URL or NEXT_PUBLIC_APP_URL mismatch.
Fix: Both must match the URL in your browser exactly (including https).
"Check your email" but no email arrives
- Check spam/junk
- Click Resend verification on the check-email page
- Confirm
EMAIL_FROMuses a verified domain in Resend - Confirm
RESEND_API_KEYis set in production
Invites
Guest sees "Invite not available"
| Reason | Fix |
|---|---|
| Guest archived | Organiser un-archives or creates new guest |
| Event archived, guest never joined | Cannot join; organiser shares info manually |
| Link expired or regenerated | Organiser sends new link from guest profile |
| Wrong / old link | Copy fresh link from guest profile |
Guest lands on "Open your invite link" empty state
They opened /e/{slug} without joining first. Send the /join/... link, not only the hub URL.
Payments
Splits look wrong after RSVP changes
- Open Payments → Recalculate payments
- Check needs review banner
- Verify activity cost type and who is marked Going
Payment details not showing for guests
Organiser must fill in Payment details for guests on the Payments page and save.
Photos
Photo upload fails
- Check file size (max 10 MB for covers; similar limits for photos)
- Confirm Supabase storage bucket exists and
SUPABASE_SECRET_KEYis set (hosting) - Try a different image format (JPG, PNG, WebP)
Copied photo URL does not open elsewhere
Expected behaviour. Photos require an organiser or guest session. Use the guest hub to view photos.
Database / hosting (organisers self-hosting)
Prisma errors on Vercel
- Runtime: use pooler URL (
DATABASE_URL, port 6543) - Migrations: use direct URL (
DIRECT_URL, port 5432) - Run
npx prisma db pushagainst production before deploying schema changes
App crashes on startup
Check Vercel logs for missing env vars. See Production launch checklist in the app repo docs/PRODUCTION-LAUNCH.md.
Still stuck?
Email hello@buxmate.com with:
- What you were trying to do
- Organiser or guest role
- Browser and device
- Screenshot of the error (if any)
- Event name (no need to share guest personal data)