Preview won't start

The progress panel names the step that's stuck. Find it below.

Stuck on "Installing dependencies"

The template's packages are pre-installed, so a long install means you've added packages (or the model did). A large dependency can take a couple of minutes on the first start. If it exceeds the startup budget, the panel shows the install log — look for the failing package.

Common causes:

• A package that needs native build tools (sharp, bcrypt, canvas) — ask the model for a pure-JS alternative (bcryptjs, jimp).
• A typo in package.json from a manual edit — check the JSON is valid.

"The app exited during startup"

The dev server crashed immediately. The panel shows the last lines of the log. Typical:

• Module not found — a file imports something that doesn't exist. Paste the error into the chat; the model will fix the import or create the file.
• A syntax error in a file you edited by hand — open it in the editor.
• Port already in use inside the container — Stop and Run again.

"Did not respond within 7 minutes"

The process is running but the first page never answered. Usually the first compile is hung on a bad file. Open the preview URL in a new tab: if Next shows an error overlay, that's the file. Otherwise Stop, Run again, and if it repeats, revert to the last version that worked.

Preview loads but shows an error page

That's your app's own error — the Next.js overlay shows the stack trace. The most common one on a fresh project is a database query failing because a table doesn't exist yet; the template creates tables on first use, but code the model wrote may not. Ask it to add the CREATE TABLE IF NOT EXISTS for the new table.

Preview loads but is blank

Check the browser console (F12 → Console). A client-side exception in a component leaves the page empty. Paste the message into the chat.

"Sign in to view this preview"

You're opening the preview from a browser or profile where you're not signed in to Qyant, or as a different user. Previews are owner-only. Sign in in that browser, or deploy to share.

Still stuck

Stop preview → Run preview restarts the whole container. If a restart doesn't help and the last change is suspect, revert to the previous version. If neither works, contact support with the project name and the text from the progress panel.