Debug Your App

"Gemini is loading forever"

The AI is thinking. Sometimes it takes time.

→ Wait 30 seconds. If still stuck, refresh the page and paste your prompt again.

"The PRD looks too complicated"

PRDs have technical sections that are not for you to read.

→ Focus only on "Features" and "Design" sections. The technical parts are for the AI in Station 4.

"Gemini changed my idea too much"

The AI sometimes adds features you did not ask for.

→ Tell it: "Go back to my original idea. I want [paste your one-sentence idea from Station 0]."

"Gemini says it can't help with this"

Some prompts trigger safety filters.

→ Rephrase your idea. Remove words like "hack", "exploit", or anything that sounds harmful.

"Red error text appeared"

Errors are normal. They tell the AI what to fix.

→ Copy the entire error message and paste it to the AI. Say: "I see this error. Please fix it."

"The screen is blank/white"

Something crashed before the app could show.

→ Tell the AI: "The preview shows a blank white screen. Please check for errors and fix them."

"It doesn't look right"

The design does not match what you wanted.

→ Use the formula: "The [element] on [screen] looks [current state] but should be [expected state]."

"The AI is very slow"

Building an app takes time. The AI is writing many files.

→ Wait. A complete build can take 2-5 minutes. If it stops moving for 3+ minutes, refresh and try again.

"The AI keeps making the same mistake"

Sometimes the AI gets stuck in a loop.

→ Start a new chat. Paste your PRD again with the Magic Prompt. Fresh context helps.

"Authentication required"

Your tool needs permission to access GitHub.

→ Click the blue link in the message. It opens GitHub sign-in. After signing in, try again.

"Repository already exists"

You already have a project with that name.

→ Pick a different name. Add a number: "my-app-2" or "my-first-app-v2".

"Permission denied"

Your GitHub session may have expired.

→ Open github.com in a new tab. Look for your profile picture in the top-right. If you do not see it, click "Sign in".

"Deploy failed"

Vercel tried to build your app but something broke.

→ Click "View Build Logs" on Vercel. Copy the red error text and paste it to your AI tool to fix.

"Can't find my project"

Vercel does not see your GitHub repository.

→ Click "Adjust GitHub App Permissions" and add access to your repository. Then refresh the page.

"Build timed out"

The build took too long (over 10 minutes).

→ Click "Redeploy" and try again. If it keeps timing out, your app may be too complex for the free plan.

"Site shows 404 error"

The URL works but shows "Page not found".

→ Wait 1-2 minutes. Vercel needs time to spread your site worldwide. If still broken, check that your app has an index page.

"No install option appears"

The browser does not show "Add to Home Screen".

→ On iPhone: tap the Share button (square with arrow), then scroll down to "Add to Home Screen". On Android: tap the menu (three dots), then "Add to Home screen".

"App icon is wrong or blank"

The manifest.json file may be missing icons.

→ Tell the AI: "The PWA icon is not showing. Please check manifest.json and add proper icon files."