Troubleshooting and safety

Troubleshooting

Common issues and solutions when building with Rytora BuildLabs. If your problem is not listed here, reach out to support.

Preview is not loading

Check your browser console for errors — the preview panel shows error overlays automatically.
Try refreshing the preview using the reload button in the preview toolbar.
If using the browser preview (Free tier), ensure your browser supports Service Workers and SharedArrayBuffer.
Clear your browser cache and try again. Some browsers cache stale Service Worker states.

Complex apps may take up to 60 seconds to generate. Wait for the progress indicator to complete.
If generation fails, try simplifying your prompt and generating in smaller steps.
Check your internet connection — the AI Builder requires a stable connection to Claude API.
If the issue persists, try creating a new project and regenerating.

Use the built-in code editor to identify the error location.
Ask the AI to fix it: describe the error message and the expected behavior.
Check the browser console and terminal output for detailed error messages.
If the error is in the database schema, try regenerating the Supabase tables with a clearer data model description.

Be specific about visual requirements in your prompt — mention colors, layouts, and component styles.
Reference existing products: "styled like Notion" or "dashboard layout like Linear".
Use the code editor to fine-tune Tailwind classes directly.
Check responsive breakpoints — the preview defaults to desktop width.

Check that your Vercel account is properly connected in project settings.
Verify that all required environment variables are set.
Review the build logs for specific error messages.
Ensure your project builds successfully in the preview before attempting deployment.

Supabase databases may pause after inactivity on the free tier. The first connection may take a few seconds to resume.
Check that the DATABASE_URL environment variable is set correctly.
Run Supabase migrations if you have changed the schema: the deploy step handles this automatically.
If using connection pooling, ensure the pooled URL is used for queries and the direct URL for migrations.

Open the Terminal tab in the project editor and click the Shell tab.
The shell opens inside the preview container.
Important: use && to chain commands. The shell does not support multiple commands separated by spaces.
To run database seeds: cd /app && npx tsx supabase/seed.ts
To run Supabase migrations: cd /app && npx supabase db push
To run npm scripts: cd /app && npm run <script-name>
For frontend commands: cd /app/frontend && npm run <command>
Note: the Shell tab connects to the preview container, not the Rytora BuildLabs platform.

Still having issues?

Check the FAQ for more answers, or contact support through the Rytora BuildLabs dashboard. Pro plan users get priority support.