flowchart TD
A[Deploy failed] --> B{Error type?}
B -->|Missing envs| C[Add env vars in Settings → Environments]
B -->|Build failed| D[Check build logs and lockfiles]
B -->|Runtime not reachable| E[Verify PORT and 0.0.0.0]
C --> F[Redeploy]
D --> F
E --> F
Decision tree: domain issues
flowchart TD
A[Domain not working] --> B{DNS updated?}
B -->|No| C[Fix DNS records]
B -->|Yes| D{SSL pending?}
D -->|Yes| E[Wait for verification]
D -->|No| F{Routing correct?}
F -->|No| G[Check domain environment mapping]
F -->|Yes| H[Check runtime status]
Decision tree: database failures
flowchart TD
A[DB provisioning failed] --> B{Plan eligible?}
B -->|No| C[Upgrade to Pro/Enterprise]
B -->|Yes| D{Quota exceeded?}
D -->|Yes| E[Reduce usage or increase quota]
D -->|No| F[Retry provisioning]
Common error strings
missing required environment variables → add env vars for the target env
Quota limit exceeded → upgrade plan or reduce usage
Domain not found → ensure domain is attached to the correct environment