cms0.config.* not found

Symptoms

• CLI warns no config file was discovered.

Fix

• Add a supported config file at project root.
• Or pass an explicit path:

cms0 build --config ./cms0.config.ts

Descriptor generation fails

Symptoms

• cms0 build exits with type-analysis errors.

Fix

• Verify entry path is correct.
• Verify TypeScript config resolves your schema files.
• Start with a minimal schema and add complexity incrementally.

Database connection failures

Symptoms

• Admin fails at startup with connection errors.

Fix

• Validate DATABASE_URL format and credentials.
• Confirm database host/network access.
• Confirm database exists and accepts connections.

Authentication or origin errors

Symptoms

• Login/callback requests fail or are blocked.

Fix

• Verify BETTER_AUTH_URL.
• Verify TRUSTED_ORIGINS includes active app origins.
• Verify OAuth credentials if social sign-in is enabled.

API key unauthorized responses

Symptoms

• Requests return 401 or 403 with API keys.

Fix

• Verify key is active and not expired.
• Verify key permissions include required scopes.
• Verify header format (Authorization or x-api-key).