Troubleshooting

The build screen shows 'Build failed' with a reason

1. Read the error reason shown on screen — it usually describes the specific stage that failed.
2. Click 'Rebuild' to try again. Most failures are transient (model timeouts, temporary API issues) and succeed on a second attempt.
3. If the same stage keeps failing, simplify your idea: remove one or two features on the scope screen before rebuilding.
4. Credits are automatically refunded for failed builds. Check your credit balance on the account page.

Build stuck on the same stage for more than 8 minutes

1. The system detects stuck builds automatically and will cancel + refund within 8 minutes of inactivity.
2. If the page still shows 'Building' after 10 minutes, try a hard refresh (Ctrl+Shift+R / Cmd+Shift+R). The build may have already completed.
3. Go to Dashboard and check the project's status. If it shows 'Failed', your credits have already been refunded.

'Conflict detected' error

1. The conflict-detection agent found an internal contradiction in the plugin design — two features that use the same hook, option key, or table name.
2. Go back and deselect one of the conflicting features, or rewrite your idea to make the two features more distinct.
3. The error message will name the specific features involved.

'Internal server error' when pressing Analyze

1. This was a known issue that has been fixed. If you still see it, try signing out and back in, then submit your idea again.
2. Make sure your idea is at least a few words long — a single word or fragment may fail validation.

The clarifying questions don't make sense for my idea

1. You can leave any question blank — the AI will make a reasonable default for unanswered questions.
2. If a question is genuinely irrelevant, skip it and continue. Blank answers are treated as 'use the most common option'.
3. Alternatively, start over with a clearer, more specific idea description. The questions are derived from the idea, so a more detailed idea produces better questions.

I want to skip the questions and go straight to building

1. If your idea is clear and specific enough, the AI will automatically skip the clarify step (zero questions returned).
2. Otherwise, you can leave all questions blank and click 'Continue to Features' — every question is optional.

The download button does nothing / download fails

1. Try right-clicking and 'Save link as…' to force the download.
2. Disable browser extensions (especially ad-blockers) and try again.
3. If the problem persists, go to Dashboard → Project → Details. The download link is also shown there for completed builds.

WordPress shows 'The package could not be installed' when uploading

1. The ZIP may be corrupt if the download was interrupted. Try downloading again.
2. WordPress sometimes rejects ZIPs that don't follow its expected structure. The generated ZIP should be correct — if this happens, try re-downloading.
3. Check that the ZIP wasn't extracted and re-zipped before upload. Upload the original downloaded file.

The plugin is installed but doesn't appear in the WP admin menu

1. Make sure the plugin is activated — go to Plugins → Installed Plugins and activate it.
2. Some plugins only add a menu item under Settings, Tools, or WooCommerce rather than as a top-level menu. Check there.
3. If the plugin has a settings page, it will appear at the location described in the UX spec (visible in the project spec JSON in Dashboard → Project → Details).

PHP fatal error after activating the plugin

1. Check your PHP version — the generated plugin requires PHP 7.4 or higher.
2. Check your WordPress version — the plugin targets the version shown in readme.txt under 'Requires at least'.
3. If you're on a compatible version and still get errors, paste the PHP error message into a new project idea and rebuild with the fix described. Alternatively, contact support with the error.

My credits weren't refunded after a failed build

1. Refunds are automatic but can take up to 5 minutes to appear.
2. Refresh the account page — credits may have been refunded but the display is cached.
3. If more than 10 minutes have passed, contact support with your project ID and we'll investigate.

'Couldn't create the project (HTTP 404)'

1. This was a routing issue on the published site that has been fixed. Try signing out and back in.
2. Clear your browser cache and try again.

I'm logged in but the builder says I need to sign in

1. Your session may have expired. Sign out and sign back in.
2. If using a work or school network, a firewall may be blocking the authentication cookies. Try a personal network or a private/incognito browser window.