Troubleshooting

Quick answers to the things people actually hit.

My preview isn’t showing

The first build takes 1–2 minutes. While it runs, the Preview tab shows “Building your app — the first build usually takes 1–2 min…” — switch to the Logs tab to watch progress.

If the build has finished but the preview looks blank or shows an error, the container may still be booting — click Reload in the preview header. If you see “No preview yet. Send a message to build this project,” the project hasn’t built successfully yet; send a message to kick off a build.

My build failed / the project shows ERROR

A project shows ERROR when its last build didn’t finish — the agent hit its time limit, or the run ended with an error. The error appears in the chat. Just send another message (for example, “try again” or a more specific instruction) to queue a fresh build on top of your existing repo.

I hit my daily prompt limit

Each plan has a daily allowance — Free 5 / Pro 20 / Max 100 prompts, where a prompt is one build (creating an app or sending a chat message). You’ll see:

You’ve used all 5 prompts for today on the Free plan. Upgrade for more, or come back tomorrow.

The count resets at 00:00 UTC. To keep building now, upgrade — see Plans & limits.

My magic link didn’t work

Sign-in links expire after 15 minutes and are single-use. If yours has expired or was already clicked, head back to the login page and request a new one.

I got a validation error

Lyvica needs a little to work with:

• Project name — at least 2 characters (“Give your project a name (2+ chars).”)
• Brief — a sentence or two (“Describe what to build in a sentence or two.”)
• Chat message — at least 2 characters (“Message must be at least 2 characters.”)

Can I build something other than Next.js?

Not yet — Lyvica builds Next.js apps today. Other frameworks aren’t selectable.

Can I rename a project?

Yes. Renaming changes the display name only — the project’s URL, GitHub repo, and preview address stay the same.

Where’s my code / preview?

Every project has a private GitHub repo in the Lyvica organization (open it with the Repo button) and a public preview at https://<your-project>.preview.lyvica.com (the Open button).

API errors

When using the API, errors come back as { "error": { "code", "message" } } with these statuses:

Code	What it means	Fix
401	Missing/invalid API key	Check the Authorization: Bearer lyv_live_… header; create a key in Settings
404	No project with that id/slug	Verify the id or slug
422	Validation failed	Lengthen the brief / message
429	Daily limit reached	Wait for the 00:00 UTC reset, or upgrade
400	Body wasn’t valid JSON	Send valid JSON with Content-Type: application/json

Still stuck? Ask in the Lyvica Discord.