Troubleshooting

Keep any displayed error message when diagnosing a problem or contacting support.

Preview does not load

1. Wait for project workspace setup to complete, then select Refresh.
2. Open Project actions and show the console to inspect preview logs.
3. Return to the team project list, reopen the project, and wait for its local workspace to become ready.

Do not publish until the preview is working; publishing requires the local workspace.

Built-in editor cannot edit a file

The built-in editor only edits text files smaller than 10 MB. Binary files are previewed instead. Use Open in to edit other files in an installed editor or file manager.

GitHub asks you to connect an account

Open Account from the user menu and select Connect GitHub. Then return to the project and select its GitHub icon again. The project must also have a ready local workspace.

Publish is unavailable

Return to the local preview and wait for workspace setup to finish. Publishing is disabled while another publish is running. Up to date means the current local source already matches the last published revision.

For a failed deployment, confirm the local preview works, then select Retry from Release history.

Custom domain does not validate

Check the DNS record shown on the Custom domain page:

• Use CNAME for a subdomain such as app.example.com.
• Use ALIAS, ANAME, or CNAME flattening for an apex/root domain when your provider supports it.

Keep the Custom domain page open to inspect validation status and required records. DNS changes can take time to propagate.