Troubleshooting
Quick fixes for the most common issues.
Preview not loading
The canvas preview runs in a cloud sandbox. If it is blank, stuck, or showing a connection error, try these in order.
Build errors
When the dev server hits a build error, the preview shows an error overlay.
Authentication problems
Sign-up, sign-in, or session issues usually come from Supabase Auth configuration.
Database sync issues
Supabase connection problems
General tips
When to revert
If you have been debugging the same issue for more than 10 minutes and it was working before a specific change, revert. Use Git to go back to the last known-good state.
- Check the terminal first. Most issues produce an error message there. Read it before trying anything else.
- One change at a time. Make one fix, check if it worked, then move on. Stacking changes makes it impossible to tell what helped.
- Search the error message. Many Lyna errors come from underlying frameworks (Next.js, React, Supabase) that have well-documented solutions.
- Use Ask mode. Switch to Ask Mode and describe the problem. The AI can read your code and suggest fixes without making changes.