Meet Blink Blink Docs
Troubleshooting Fix common issues fast — build errors, blank screens, broken features, and recovery strategies. Something not working? This guide helps you diagnose and fix the most common issues, organized by what you're seeing. First Steps: The Quick Fix Flow Before diving deep, try these in order: Click 'Try to Fix' When Blink shows an error, click the Try to Fix button. Blink analyzes the logs and attempts an automatic repair. Works ~70% of the time. Check the console Open browser DevTools (F12 or Cmd+Option+I) → Console tab.
Red errors often point directly to the problem. Describe what's wrong If auto-fix fails, tell Blink exactly what's happening: Rollback if needed Go to Workspace → Versions → Restore a working version. Then try a different approach. By Symptom: What Are You Seeing? Blank White Screen The app loads but shows nothing—just white.
Most common causes: - JavaScript error crashing the app - Broken import or missing component - Vite configuration issue - Security headers blocking content Fix it: Manual checks: If the root element is empty, something is crashing before render.
Preview Won't Load / "Spinning Up" The preview panel shows loading indefinitely or "Not Found." Most common causes: - Build error preventing compilation - Network connectivity issue - Temporary sandbox issue Fix it: - Hard refresh: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows) - Check for build errors: Look at the chat for red error messages - Try a different browser: Rule out browser-specific issues - Wait 30 seconds: Sometimes the sandbox needs time to spin up If persistent: Button/Form Does Nothing When Clicked You click something and nothing happens—no loading state, no error, no response.
Most common causes: - Event handler not connected - Async function not awaited - State not updating - Error being silently caught Fix it: Data Not Saving to Database Form submits but data doesn't appear in the database. Most common causes: - API route returning error (check Network tab) - Database permission issue (RLS) - Wrong table or column name - Data validation failing silently Fix it: Manual check: Data Shows But Won't Update You can see data, but changes don't reflect in the UI.
Most common causes: - Cache not invalidating after mutation - State not being updated - Optimistic update not implemented - Query key mismatch Fix it: Authentication Issues Can't log in, getting logged out randomly, or protected pages accessible without auth. Symptoms and fixes: Payment/Stripe Issues Checkout not working, webhooks not firing, or users not getting access after payment. Stripe Checkout must open in a new tab (window.open(url, '_blank') ) because Blink's preview runs in an iframe, and Stripe blocks iframes. Edge Function Errors Serverless functions failing or returning errors.
Common patterns: Styling/UI Issues Things look wrong, broken, or different than expected. Deployment Issues Published but something's wrong in production. Recovery Strategies When fixes aren't working and you're stuck: 1. Strategic Rollback Don't just rollback randomly—be strategic: 2. Isolate the Problem Narrow down what's causing the issue: 3. Fresh Component Approach Sometimes it's faster to rebuild than debug: 4.
Ask Blink to Explain Before more fixes, understand the problem: Error Message Reference Common error messages and what they mean: Debug Prompts Library Copy-paste these when you need help: General Debug After Multiple Failed Fixes Intermittent Bug Performance Issue When to Ask for Help If you've tried: - ✅ Auto-fix button - ✅ Reading the error message - ✅ Checking console and network tabs - ✅ Describing the issue clearly to Blink - ✅ Rolling back and trying different approach - ✅ Fresh component approach And it's still not working, it might be: - A platform issue (rare) - A complex edge case - Something outside Blink's control Get help: - In-App Chat (Recommended): Click your avatar → Help & Support for live support.
Our team typically responds within minutes. - Discord Community — for peer support and common issues - support@blink.new — for account or billing issues When asking for help, include: - What you're trying to do - What's happening instead - What you've already tried - Any error messages (screenshots help!)
People Also Asked
- Meet Blink - Blink Docs
- Welcome | Blink Documentation
- Welcome To Blink Docs
- Blink Documentation | Blink
- Blink Code - Blink Shell
- Blink - AI App Builder | Build Apps in Minutes with AI
- Blog | bLink Docs
Meet Blink - Blink Docs?
Red errors often point directly to the problem. Describe what's wrong If auto-fix fails, tell Blink exactly what's happening: Rollback if needed Go to Workspace → Versions → Restore a working version. Then try a different approach. By Symptom: What Are You Seeing? Blank White Screen The app loads but shows nothing—just white.
Welcome | Blink Documentation?
Our team typically responds within minutes. - Discord Community — for peer support and common issues - support@blink.new — for account or billing issues When asking for help, include: - What you're trying to do - What's happening instead - What you've already tried - Any error messages (screenshots help!)
Welcome To Blink Docs?
Red errors often point directly to the problem. Describe what's wrong If auto-fix fails, tell Blink exactly what's happening: Rollback if needed Go to Workspace → Versions → Restore a working version. Then try a different approach. By Symptom: What Are You Seeing? Blank White Screen The app loads but shows nothing—just white.
Blink Documentation | Blink?
Red errors often point directly to the problem. Describe what's wrong If auto-fix fails, tell Blink exactly what's happening: Rollback if needed Go to Workspace → Versions → Restore a working version. Then try a different approach. By Symptom: What Are You Seeing? Blank White Screen The app loads but shows nothing—just white.
Blink Code - Blink Shell?
Red errors often point directly to the problem. Describe what's wrong If auto-fix fails, tell Blink exactly what's happening: Rollback if needed Go to Workspace → Versions → Restore a working version. Then try a different approach. By Symptom: What Are You Seeing? Blank White Screen The app loads but shows nothing—just white.