AI Studio → Android

Troubleshooting

Diagnose and fix the most common deployment issues.

8 Issues

Reviewed September 2026

  1. Is the page blank?Check index.html and add the <script> tag. See issue 1.
  2. Page loads, but AI features fail?Check the Vercel environment variables (all 4). See issue 2.
  3. Can't install on Android?Check that manifest.json exists and is valid. See issue 4.
  4. Still stuck?Check the browser console for other errors.
Issue 1Blank white page on deployed app
Symptoms
  • App works in AI Studio's preview but shows a blank page on Vercel
  • Browser console: "Failed to load resource" errors
Fix
  • Go to GitHub → open index.html → check that <script type="module" src="/index.tsx"></script> is inside <body>
  • If missing, edit on GitHub, add it back, and commit
  • Verify index.tsx or main.tsx exists in the repo root
  • Check Vercel's build logs (Deployments tab) for the specific error
Issue 2API key invalid / Unauthorized errors
Symptoms
  • App loads but AI features don't work
  • Error messages about the API key in the browser console or network tab
Fix
  • Vercel → Your Project → Settings → Environment Variables
  • Verify the variables your code actually reads exist — commonly GEMINI_API_KEY, API_KEY, VITE_API_KEY, and GOOGLE_GENERATIVE_AI_API_KEY
  • Regenerate the key in AI Studio if needed, and update every variable that holds it
  • Redeploy: Vercel → Deployments → ⋯ → Redeploy
Issue 3Vercel build fails
Common Errors
  • "Cannot find module 'vite'" → ensure package.json includes all dependencies
  • "Build command failed" → build command must match your project, usually npm run build
  • "Memory limit exceeded" → simplify the app or remove large dependencies
Fix
  • Click the failed deployment in Vercel and read the error log carefully
  • Fix the specific error in your GitHub repository and commit — Vercel auto-redeploys
Issue 4App not installable on Android
Symptoms
  • No "Install app" prompt appears in Chrome
  • "Add to Home Screen" is greyed out
Fix
  • Verify manifest.json exists in the root of your GitHub repo
  • Confirm index.html has <link rel="manifest" href="/manifest.json">
  • Use Chrome specifically — support is most consistent there
  • Check Chrome DevTools → Application → Manifest tab for errors
  • Your deployment URL must use HTTPS — Vercel, Replit, Netlify, Cloudflare Pages, and Cloud Run all provide this by default
Issue 5Updates not showing on installed app
Fix
  • Force refresh: open app → pull down to refresh, or close and reopen
  • Clear app cache: Android Settings → Apps → Your App → Storage → Clear Cache
  • Reinstall: uninstall, visit the Vercel URL in Chrome, reinstall a fresh copy
Issue 6Can't connect Vercel to GitHub
Fix
Issue 7API key shows as "Blocked" in AI Studio
Symptoms
  • A key you haven't used in a while shows a "Blocked" tag on the AI Studio API Keys page
  • Requests using that key start failing with an authorization error
Fix
  • Google now blocks unrestricted API keys that sit dormant for an extended period as a security measure
  • Open the AI Studio API Keys page and click Create API key to generate a new one — new keys are created with the current recommended restrictions automatically
  • Update every environment variable that referenced the old key, in Vercel and anywhere else it's used, then redeploy
Issue 8"Failed to create Cloud Run service: quota exceeded" when using AI Studio's Publish button
Symptoms
  • Clicking Publish → Get started in Build mode (see Part 2) fails with a quota or provisioning error on the Google Cloud Starter Tier
Fix
  • The Starter Tier caps you at two deployed apps on a single Cloud Run region — delete or unpublish an old test app from the Publish panel if you're at the limit
  • If you've ever set up Google Cloud billing on any project, even a different one, you're not eligible for the Starter Tier and will need to link a billing account instead
  • If neither applies, this is usually a temporary provisioning issue — wait a few minutes and retry, or fall back to the GitHub + Vercel/Replit path in Parts 3–4B, which has no such cap