Troubleshooting

Common problems and how to recover from them.

Quick recovery guide

App won't load or Preview is blank

Check Connectors tab → connect Required services

Build stuck or never finished

Wait 60s → refresh → send follow-up in same project

Wrong features or plan doesn't match

Don't approve → type correction → re-review

Something broke after a change

Discuss mode → ask what changed → revert

Publish button greyed out

Connect all Required services → reload → retry

Typed in chatbox but Preview is blank

Check Connectors tab → connect Required services

Out of credits — build won't start

Upgrade your plan → Plans & Pricing

Still stuck

Discuss mode → describe the problem directly

Build issues

The plan doesn't match what I described

What's happening: The plan includes the wrong features or scope.

How to fix it:

1. Don't approve the plan.
2. Type a correction explaining what's wrong. For example: "The plan includes team features, but I only need single-user. Remove the team features and focus on personal habit tracking."
3. MonstarX will revise the plan.
4. Repeat until it matches your intent, then approve.

How to prevent it: Use the first prompt template from Prompting and include an explicit out-of-scope list.

The build hangs or never finishes

What's happening: MonstarX started building but the process appears stuck.

How to fix it:

1. Wait 60 seconds, complex builds take time.
2. Refresh the page.
3. Check if your project was saved (it usually is).
4. If it's still stuck, send a new message in the same project describing what's incomplete.

Preview is blank after building

What's happening: The Preview tab shows nothing, or an empty screen.

Most likely cause: A required service isn't connected.

How to fix it:

1. Click the Connectors tab.
2. Find any service marked Required.
3. Connect it following the steps in Integrations.
4. Return to Preview and reload.

Other possible causes:

• An error in the generated code. Use Discuss mode and ask: "The Preview is blank, is there an error in the code I should know about?"
• A network issue. Try reloading the page.

Typed into the chatbox but Preview is still blank

What's happening: You sent a message and the build completed, but the Preview tab shows an empty screen.

Most likely cause: A required connector wasn't set up before building.

How to fix it:

1. Click the Connectors tab.
2. Look for any service marked Required that isn't connected.
3. Connect it — see Integrations for step-by-step instructions.
4. Return to the Preview tab and reload.

If all required services are already connected, use Discuss mode and ask: "The Preview is blank after my last message. Is there an error in the code?"

Out of credits

What's happening: A message like "No credits remaining" appears and the build won't start.

How to fix it:

1. Go to your account settings and review your current plan.
2. Upgrade to a higher plan to get more monthly credits — see Plans & Pricing.
3. If you're on a paid plan, check whether your monthly credits have reset yet.

Credits are consumed when MonstarX builds or rebuilds your app. Discussing and reviewing the plan does not use credits.

A feature I asked for is missing

What's happening: Something you described isn't in the built app.

How to fix it:

1. Check the approved plan, was the feature included?
   • Yes: It was planned but not built. Send a follow-up message to add it.
   • No: It was never in the plan. Include it explicitly next time.
2. Send a focused follow-up using the format from Prompting.

How to prevent it: Read the full plan before approving. If something's missing, correct it before you approve.

Integration issues

A required service is blocking my app

What's happening: A connector shows as Required and the app won't work without it.

How to fix it:

1. Follow the setup guide for that service in Integrations.
2. If you don't have an account, check if a free alternative is listed.
3. To remove the integration entirely, use Discuss mode and ask: "Can I remove [service name] from this feature and use a simpler approach?"

Supabase connection fails

• Project is paused — Log into supabase.com and resume your project
• Wrong credentials — Check your project URL and anon key in the Supabase dashboard
• Migration fails — Check the SQL editor in Supabase for error details
• Project inactive — Free projects pause after 1 week of inactivity, log in to resume

Stripe keys not working

How to fix it:

1. Confirm you're using the correct key type:
   • Test mode: pk_test_ and sk_test_
   • Live mode: pk_live_ and sk_live_
2. Never mix test and live keys in the same project.
3. Check your Stripe dashboard for any account-level issues.

Emails aren't being sent (Resend)

What's happening: Password reset or confirmation emails aren't arriving.

How to fix it:

1. Check your Resend dashboard for send errors.
2. Verify your sending domain is set up and verified in Resend.
3. Check your spam or junk folder, emails from unverified domains often land there.
4. Confirm your Resend API key is still active.

Publish issues

The Publish button is greyed out

How to fix it:

1. Check that all Required services are connected.
2. Confirm the app loads correctly in Preview.
3. Refresh the page and try again.

The published link shows an error

How to fix it:

1. Wait 30-60 seconds, publishing may still be completing.
2. Open the link in a private or incognito browser window.
3. If the error persists, check the Connectors tab for any disconnected required services, then republish.

The app broke after a follow-up change

What's happening: A recent change caused something to stop working.

How to fix it:

1. Use Discuss mode immediately: "My last change broke [describe what's broken]. What changed?"
2. Ask MonstarX to revert: "Undo the last change to [section or feature]. Keep everything else the same."
3. Fix one thing at a time, don't try to repair everything in a single message.

How to prevent it: Use Discuss mode before any message that touches multiple parts of your app.

GitHub issues

Push to GitHub fails

How to fix it:

1. Verify your GitHub account is connected in the Connectors tab.
2. Check that the connected account has permission to create new repositories.
3. If the repository name is already taken, try a different name.
4. Disconnect and reconnect your GitHub account if the connection seems stale.

General tips

Build incrementally. Start simple. Add features one message at a time, don't try to describe everything at once.

Read the plan before approving. It's your only checkpoint before building starts.

Use Discuss mode freely. If you're unsure whether a message will trigger a large change, ask in Discuss mode first.

Use test credentials while developing. Switch to live keys only before your final publish.

Describe patterns, not individual fixes. If the same issue appears in multiple places, describe it once: "All buttons across the app should use #2563eb. Fix all instances."

Still stuck?

• Use Discuss mode and describe the problem directly to MonstarX.
• Review Integrations and Prompting for relevant guidance.