Skip to main content

Troubleshoot OXVO Builder

Use this page for the most common hosted OXVO Builder issues.

Builder does not open correctly​

Check the launch path first:

  1. Start from OXVO.
  2. Open OXVO Builder from the sidebar.
  3. Confirm you land back in the expected workspace.

If you try to open Builder directly while signed out, Builder routes you back through OXVO first.

No AI models are available​

If Builder says no models are enabled for the workspace:

  • open the current workspace in OXVO
  • ask the workspace owner or admin to enable a managed model provider
  • return to Builder and retry

In hosted Builder, this is usually a workspace configuration issue, not a per-user API-key issue.

The app needs auth, database, or uploads​

If the request depends on backend features, stop treating it as a frontend-only change.

Use Cloud and enable Builder Cloud for the app first.

Continue: Use Builder Cloud for backend features

Preview is blank, unhealthy, or stuck​

Work through the review surfaces in this order:

  1. Confirm the correct app is selected.
  2. Open Problems and look for build or runtime failures.
  3. Open Code if the failure looks structural.
  4. Open the System messages area for recent logs.

Builder usually refreshes preview automatically after significant changes. If the preview still does not recover, restart the app from the preview controls and re-check the failing route.

Visual editing controls are missing or locked​

Confirm all of the following:

  • preview is fully loaded
  • the correct app is selected
  • the preview toolbar shows Edit component or Select components
  • your workspace plan includes the save action you are trying to use

Inspection and component selection can still be useful even when editing save controls are limited by plan.

Vercel deployment is not available​

Check GitHub first.

The normal hosted flow is:

  1. connect GitHub
  2. reopen Publish
  3. connect Vercel

If GitHub is not linked, Builder does not expose the full Vercel deployment path.

Cloud usage or billing warnings appear​

Open the current workspace in OXVO and review billing there.

Workspace plan, included Cloud allowance, and payment-method state all affect Builder Cloud behavior.

Need human help​

Use the Builder Help dialog when you need a real support handoff.

In hosted Builder, help flows can:

  • prepare a support submission
  • submit an issue report
  • give you a reference to share with the OXVO team