# Troubleshooting

Solve common problems by symptom. Follow the quick checklist first.

### Quick checklist (2 min)

1. Reload the page and try again.
2. Test in an incognito window (no extensions).
3. Disable adblock/privacy extensions for the domain.
4. Confirm permissions and the correct environment (Dev/Staging/Prod).

### Choose the topic

<table data-view="cards"><thead><tr><th>Topic</th><th data-card-target data-type="content-ref">Open</th></tr></thead><tbody><tr><td><strong>AI generation failures</strong><br>Generation doesn't start, freezes, or delivers inconsistent results.</td><td><a href="https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas/problemas-de-deploy">Problemas de deploy</a></td></tr><tr><td><strong>Deployment issues</strong><br>Deployment failing, stuck, or app down after publishing.</td><td><a href="https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas/falhas-na-geracao-por-ia">Falhas na geração por IA</a></td></tr><tr><td><strong>SSO and login</strong><br>Login looping, callback error, or access denied after authenticating.</td><td><a href="https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas/sso-e-login">SSO e login</a></td></tr><tr><td><strong>Performance and slowness</strong><br>Slow UI, slow endpoints, or timeouts.</td><td><a href="https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas/performance-e-lentidao">Performance e lentidão</a></td></tr><tr><td><strong>Database, migrations and schema</strong><br>Migration fails, divergent schema, or connection error.</td><td><a href="https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas/banco-migrations-e-schema">Banco, migrations e schema</a></td></tr></tbody></table>

### How to escalate (open a ticket)