FAQ
Troubleshooting by symptom (start from environment and last change).
Triage
Answer these first:
- preview (dev) or production?
- started after Chat change or secrets change?
- exact URL + time + screenshot?
GitHub import fails
- verify connection:
/settings?tab=github - accept bot invitation
- ensure repo is writable
Preview works, production fails
- Callback URLs differ (auth provider settings).
- Secrets differ (test vs live keys).
- Redeploy after updating secrets.
Paid but not unlocked / duplicates
- rely on webhook-confirmed state
- implement idempotency (store processed event ids)
- verify signatures
Logo/image changes do not show up
- Hard refresh to bypass cache.
- Confirm UI references the correct
public/path. - Prefer SVG paste or GitHub-committed assets over brittle external URLs.