Quick start: from an idea to a live app

Quodara is a platform where you build software by talking to it: describe what you want, and an AI agent edits your repository and ships it.

You ask for a change in a chat, the agent works on your actual code, and one click each puts the result on a test URL and then on your production domain. This walkthrough covers the whole loop.

About five minutes to read. Every blue link opens the matching page, so you can try each step and come back.

The mental model

App (one code repository + one resident agent + a test and a production environment)
 │
 ├── App main version   ← the repo's default branch; production ships from here
 │
 └── Chat              ← one conversation with the agent, working on a temp branch
                          └─ Merge into main ─→ Preview (test) ─→ Publish (production)

Short version: an app is the project you want AI to work on, and a chat is what you want it to do this time.

Step 1 — Create an app

Open Apps and click + New app at the top left. The dialog offers three ways in:

Start from a blank app (marked Recommended, selected by default): give it a name, pick a platform domain, choose a production subdomain, and click Create. Quodara sets up the repository, domains and deployment for you.
Start from an open-source project: enter a name, a GitHub URL and a branch or ref, then click Create and let AI adapt it. Quodara creates the app and opens a chat with your adaptation request already sent.
Configure manually: goes straight to the setup wizard — for when you already have a repository, a domain and a database to plug in.

If you are new, take the blank app route. Once the status turns from Creating to Success, the app is ready.

Not sure how to phrase what you want? In Chat, switch the app selector to the official default assistant. It answers questions about the platform and helps turn a vague idea into a concrete plan.

Step 2 — Ask for your first change

Open Chat:

Pick the app you just created in the composer at the bottom
Describe what you want, for example "change the homepage title to What should I drink today and use a warm orange palette"
Press Ctrl + Enter to send

A new chat appears on the left and moves through Queued → Running → Done. While it runs, the message area shows the steps the agent is taking — which files it read, which commands it ran — so you are never staring at a blank screen.

The composer has two more tools: @ references an app or a file, and the paperclip attaches files (you can paste screenshots straight in).

Step 3 — Preview, then publish

When the agent finishes, a row of buttons appears under the message:

Preview deploys the change to your test environment so you can click through it for real
Publish ships it to your production domain

To get the change into the repository's default branch, use Merge into the app's main version next to the composer.

Code only goes live once you publish it. Merging just puts the change on the default branch — until you publish, your production domain still serves the previous release.

Step 4 — Keep iterating

A chat is not one question and one answer:

If something is off, follow up in the same chat: "make the title bigger", "move that button to the right"
If it goes the wrong way, hit Stop. Your original message drops back into the composer so you can rephrase and resend.
When the agent needs a decision from you, it renders an interactive card right in the message — tick the options and submit instead of writing prose

That is the core loop on Quodara: describe, watch the steps, preview, publish.