Troubleshooting

​

I ran out of credits

• Free credits: Use the referral program to share your referral link and earn credits through referrals
• Pay-as-you-go: Buy extra credits anytime, or enable Auto reload for automatic top-ups when your balance runs low
• Upgrade: Higher plans include more credits each month

​

My app isn’t generating

1. Check your credits — generation requires credits. See your balance in the bottom left (web) or Profile (mobile)
2. Start a new chat — tap the ”+” button to start a fresh conversation
3. Simplify your prompt — try a shorter, clearer description of what you want
4. Check your internet connection — Vibecode requires an active connection

​

The preview isn’t loading

1. Wait a moment — complex apps may take a few seconds to load
2. Refresh the preview — tap the refresh button in the preview area
3. Check the deploy status — if your app is deployed, make sure the deployment is active
4. Try a different device — test on the web app or scan the QR code on your phone

​

Auth/login isn’t working

1. Check your auth configuration — ask the AI to “verify the auth configuration, especially cookie settings and trusted origins”
2. Check environment variables — make sure GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET are set in the Backend section of your ENV tab (not Frontend)
3. Check Google Cloud Console — verify your redirect URI matches exactly: https://YOUR_BACKEND_URL/api/auth/callback/google
4. Redeploy after changes — environment variable changes require a redeployment

​

My app looks broken on device

1. Check native UI components — use the Native iOS UI Components prompts to get proper native styling
2. Test on the actual device — the preview is an approximation; scan the QR code for a real test
3. Ask the AI to fix it — describe what looks wrong and share a screenshot if possible

​

Deployment isn’t working

1. Check environment variables — make sure you’re using production API keys, not test keys
2. Review build logs — check the Logs tab in your deployment dashboard for errors
3. Verify your app works locally — make sure everything works in the Vibecode preview before deploying
4. Check deployment billing — if your deployment is outside your included allowance, add or update your payment method

​

App Store submission failed

1. Check Expo token — make sure your access token hasn’t expired
2. Check the Expo Launch flow — if Expo Launch opened but stalled, complete any required Apple login or team selection steps there
3. Sign all agreements — go to App Store Connect and accept any pending terms
4. Check the bundle ID — it must be unique and follow the format com.company.appname

1. Check your App Store Connect API key: it needs the App Manager or Admin role
2. Check your Apple Developer membership: installs and App Store uploads need the paid Apple Developer Program
3. Deploy your backend if prompted: apps that use a backend need it deployed before installation or publication
4. Ask the agent: paste the build error into the chat and ask it to fix the Xcode build

​

Still stuck?