Troubleshooting

This page covers the most common issues customers hit while building or sharing a game in Vibecade.

The preview is blank or stuck

Try these checks in order:

1. Wait a moment in case the game is still rebuilding.
2. Open the logs and look for a runtime error.
3. Ask Vibecade to fix the specific problem you see.
4. Refresh the project and reopen it from My Projects if needed.

Good prompt:

The preview is blank after the last change. Check the runtime issue, fix it, and keep the current design.

The game loads, but feels wrong

Do not ask for a full rebuild right away. Instead:

• identify the biggest problem
• describe what you observed
• ask for one focused change

Example:

Movement feels slippery and jumps are too floaty. Tighten both without changing the level art.

I cannot upload images

Image upload depends on the selected model. If image input is unavailable, switch to a model with vision support and try again.

Also make sure the file is:

• PNG
• JPEG
• WebP

A premium model is locked

If a model is locked, your current plan may not include premium model access. Check Plans and Limits or open the pricing flow in the app.

I cannot make my project private

Private projects require a paid plan with private-project access. If the option is unavailable, check your plan entitlement in the billing area.

Publishing is not ready yet

Before you publish, make sure:

• the game actually runs in the preview
• the latest turn is finished
• the project has the version you want to share

If you recently made a big change, test once more before publishing.

I exported a desktop zip. What now?

Desktop export gives you a project to continue locally. Unzip it, install dependencies, run it, and package it on the target operating system.

See Desktop Export for the expected commands and platform notes.

I exported a mobile zip. What now?

Mobile export gives you a Capacitor-ready project. You still finish the native packaging step locally with Xcode or Android Studio.

See Mobile Export.

The game idea is too big to land cleanly

Reduce scope and rebuild around the core loop first. Vibecade usually performs better when you ask for:

• one mode
• one level or arena
• one camera style
• one progression system

Then expand from there.