> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revolte.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Build Your First App with Interactive Chat

> Go beyond vibe coding and shape a reviewable, production-ready change in under five minutes using six guided chat steps.

No perfect prompt or prepared repository required—start with an idea and follow six guided steps.

Need more guidance? The detailed [Build an App with Interactive Chat](https://docs.revolte.ai/workflows/chat-feature.md) guide shows every screen and explains each action step by step.

> [!NOTE]
>
> **New to Revolte?** Start with a new application and connect a repository later. If you already have a codebase, connect it first so Revolte can follow its existing structure and patterns.

**1. Open Your First Chat**

Immediately after your first sign-up, Revolte opens this **Interactive** chat screen. You are ready when the prompt box appears. To work with an existing codebase, select **Connect** under **Connect your existing application**; otherwise, start with a prompt and connect a repository later.

![The first-time post-sign-up Interactive chat screen with a prompt composer and an option to connect an existing application.](https://mintcdn.com/poddle-54594c3d/N9EC7G0RQ7OPPMvN/image-v2/setup/new-user-post-signup-chat.png?fit=max\&auto=format\&n=N9EC7G0RQ7OPPMvN\&q=85\&s=11e8374cee3e12e9b80fc1e2e11d265e)

Working with an existing application? Go to **All Projects → Create Project** and connect its repository before starting the chat.

**2. Explain What You Want to Build**

Write your request as if you were explaining the task to a teammate. A few clear sentences are enough: describe the outcome, mention important constraints, and say what a successful result should include.

```text theme={"dark"}
Add a forgot-password flow that follows the existing authentication patterns.
Cover successful resets and invalid tokens, and preserve the current visual style.
```

Not sure how to phrase it? Choose an example from the [Prompt Library](https://docs.revolte.ai/get-started/prompt-library.md) and adapt it to your goal.

**3. Choose Where Revolte Will Work**

Select a model, then choose a sandbox size. A smaller sandbox suits focused changes; larger builds, dependency installation, and test suites may need more resources.

![Sandbox options: Starter, Builder, Power, and Custom. Builder is recommended for a first full-stack change.](https://mintcdn.com/poddle-54594c3d/N9EC7G0RQ7OPPMvN/image-v2/setup/interactive-chat-sandbox-sizes.png?fit=max\&auto=format\&n=N9EC7G0RQ7OPPMvN\&q=85\&s=924680a581041f74c90e99caf2a090b2)

The sandbox keeps this work separate from your local machine. Learn more in [Sandbox Environments](https://docs.revolte.ai/get-started/sandboxes.md).

**4. Send Your Request**

Submit the prompt and wait for the sandbox to become active. Revolte may ask a focused question before changing more code. Choose a suggested answer or respond in your own words.

![Revolte asking a focused follow-up question with suggested answers and space for a custom response.](https://mintcdn.com/poddle-54594c3d/rsn4aNVKS_FvNRWy/image-v2/agent/dev-agent/chat/addition-requirements.png?fit=max\&auto=format\&n=rsn4aNVKS_FvNRWy\&q=85\&s=1003dfd3893a015b624cc86e27b2e405)

It is okay if your first prompt was incomplete—the conversation is where you refine the result together.

**5. Watch the App Take Shape**

Follow the progress in chat without needing to understand every command. When you are ready, use these views to check the work in plain sight:

![The secure built-in VS Code workspace showing the file explorer, source control, editor, and chat together.](https://mintcdn.com/poddle-54594c3d/rsn4aNVKS_FvNRWy/image-v2/agent/dev-agent/chat/secure-vscode.png?fit=max\&auto=format\&n=rsn4aNVKS_FvNRWy\&q=85\&s=dd4ace84a1b0f744fa60f97c3d9fe001)

* **Look at the files.** Open **Code** to see what Revolte created or changed. You can edit any file yourself.
* **Review what changed.** Open **Diff** to compare the previous code with the new version and spot anything unexpected.
* **Try the app.** Open **Live Preview** to use the running application. The preview refreshes as changes are made.

#### What happens before your review

Before the work reaches your repository, Revolte takes it through five clear stages:

1. **Understand your request.** Revolte turns your message and follow-up answers into clear requirements.
2. **Learn the codebase.** It identifies the existing structure and patterns to follow.
3. **Build the change.** It creates or updates the files needed for your request.
4. **Run checks.** It tests the relevant behavior and reports any issues it finds.
5. **Prepare for your review.** The files, comparison view, and live app are ready for you to inspect.

**6. Save and Share Your Work**

If you started without a repository, [connect GitHub](https://docs.revolte.ai/integrations/repository/github.md) before continuing.

When the result looks right, open the **Commit** panel and review the changed files one final time. Enter a clear commit message, then select **Commit and Push**.

![The Commit panel showing a commit message field, Commit and Push action, and the changed files.](https://mintcdn.com/poddle-54594c3d/rsn4aNVKS_FvNRWy/image-v2/agent/dev-agent/chat/github-config.png?fit=max\&auto=format\&n=rsn4aNVKS_FvNRWy\&q=85\&s=d3f8b8e1a0ed6437016c4dd5d1bee909)

If your repository workflow creates a pull request, share it with your team for review before merging.

✓ **Your first change is ready.** Review the pull request with your team, then use the deployment preview to validate the change live before merging.

## Next steps

> [card] [Deploy from Interactive Chat](https://docs.revolte.ai/deploy-operate/from-interactive-chat.md)
>
> Generate deployment configuration, commit it, and launch a managed Preview environment from your completed Chat work.

* [See every Interactive Chat screen](https://docs.revolte.ai/workflows/chat-feature.md)
* [Find a prompt for your next task](https://docs.revolte.ai/get-started/prompt-library.md)
* [Learn how your sandbox works](https://docs.revolte.ai/get-started/sandboxes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.