FAQ
Troubleshooting by symptom. Start from environment and the last change.
Triage
Answer these first:
- Is the issue in preview (dev) or production?
- Did it start after a Chat change or a secrets/config change?
- What is the exact URL, time, and screenshot?
GitHub import fails
- verify connection:
/settings?tab=github - accept bot invitation
- ensure the repo is writable
Preview works, production fails
- Callback URLs differ between environments.
- Secrets differ (test keys vs live keys).
- Redeploy after updating secrets.
Paid but not unlocked / duplicate orders
- rely on webhook-confirmed state
- implement idempotency by storing processed event ids
- verify webhook signatures
Logo or image updates do not appear
- Hard refresh to bypass cache.
- Confirm the UI references the correct
public/path. - Prefer SVG paste or GitHub-managed assets over brittle external URLs.