Troubleshooting

Quick Outcome

Use this page when platform management, event runtime, auth, payment, or storage workflows fail.

Do This

1. Isolate failing subsystem: platform UI, event resolution, auth, payment, or storage.
2. Reproduce with explicit route/action and capture logs.
3. Verify environment variables (PLATFORM_OPERATOR_EMAILS, PLATFORM_DOMAIN_SUFFIX) and CI workflow wiring.
4. Verify DB bindings/migrations and runtime secrets.
5. Re-run end-to-end flow after fix.

Important inputs:

• Runtime bindings: apps/event-site/wrangler.toml
• Event settings: apps/event-site/src/lib/server/settings.ts
• Platform logic: apps/event-site/src/lib/server/platform/
• Hostname resolution: apps/event-site/src/hooks.server.ts
• CI workflow: .github/workflows/apps-ci.yml

Check + Fix

• Event not resolving: verify platform_event_domains table has the correct hostname and DNS is configured.
• Platform UI inaccessible: confirm operator email is in PLATFORM_OPERATOR_EMAILS or platform_users table.
• Wrong event branding/content: verify event settings in the database via /admin/settings.
• Payment issues: validate Stripe webhook secret and endpoint delivery.
• Mail issues: validate Mailgun key/domain pair.

Next Move

Continue to Community.