Building & iterating
Every change to your app — the first build and every tweak after — runs as a build. Here’s what happens and what you’ll see.
What a build does
Section titled “What a build does”When you create a project or send a message, Lyvica queues a build. Behind the scenes it:
- Resolves your app’s GitHub repo (creates it on the first build, reuses it after).
- Runs an AI coding agent on the code in an isolated container.
- Commits and pushes the result to the repo.
- Starts (or refreshes) the live preview.
The first build usually takes 1–2 minutes; later edits are often faster.
Project & build states
Section titled “Project & build states”Your project moves through a few statuses, shown as a badge in the workspace:
| Project status | Meaning |
|---|---|
DRAFT | Created, not built yet |
BUILDING | A build is running |
READY | Built — preview is live |
ERROR | The last build failed |
Each individual build (a “run”) goes QUEUED → RUNNING → SUCCEEDED (or
FAILED). The workspace polls for updates automatically while a build is in
progress.
Watching progress
Section titled “Watching progress”The workspace has two tabs on the right:
- Logs — the agent’s output, streamed live and auto-scrolling. This is the place to watch a build in progress.
- Preview — your live app in an iframe once it’s ready. Before that you’ll see “Building your app — the first build usually takes 1–2 min…”. If a project has never built successfully, it shows “No preview yet. Send a message to build this project.”
Preview controls:
- Reload — re-fetch the preview (handy if it’s still booting and shows a 502).
- Device toggles — mobile / tablet / full width.
- Open — open the preview in a new tab.
- Repo — jump to the GitHub repository.
Iterating by chat
Section titled “Iterating by chat”To change your app, type an instruction in the chat input and press Enter (use Shift+Enter for a newline). Each message:
- queues a new build whose instruction is your message, and
- builds on top of your existing repo.
While a build is running, the input is disabled and shows “The agent is working…” — you can send the next change once it finishes.
Where your app lives
Section titled “Where your app lives”- Repo: a private repository in the Lyvica GitHub organization, named from your project. It contains the complete source — clone it, keep it, take it anywhere.
- Preview:
https://<your-project>.preview.lyvica.com, public so you can share it.
Renaming a project
Section titled “Renaming a project”You can rename a project’s display name anytime. The URL, repo, and preview stay the same — only the label changes.