docs/ai_builder/overview/what_is_reflex_build.md
Reflex Build is an AI app builder for creating full-stack web apps with natural language and Python. It combines an AI agent, a running preview, a code workspace, testing, integrations, and deployment in one browser-based workflow.
The result is a standard Reflex app with source code you can inspect, edit, connect to Git, download, and deploy.
Start with a prompt that describes the app or change you need. Builder can then plan the work, update the source, run the app, and show the result in Preview.
When a task needs more context, the agent can search the web, run Python, or generate an image. See Agent Tools for when and how those tools are used.
A typical workflow is:
For a guided example, follow Your First Reflex Build App. For prompting and review guidance, see Reflex Build Best Practices.
Builder generates a regular Reflex project rather than an opaque hosted artifact. The project contains the Python application code, assets, dependency definitions, and Reflex configuration needed to run it.
Use Code to browse, search, and edit the source. You can also:
See Code and Review, Connecting to GitHub, and Download App for the relevant workflows.
Ask the agent to create unit or browser tests in plain language. You can run one test or the full suite, inspect failures, and ask the agent to fix the underlying behavior.
Tests help catch regressions as the app changes, but they do not replace checking the primary workflow with realistic data in Preview. See Automated Testing.
Before deployment, the Security Scanner can check the source and dependencies for common security issues.
Builder can work with databases, authentication providers, APIs, storage services, AI models, and other external systems.
Only enable the services an app needs. See Integrations, Installing External Packages, and Secrets.
An organization contains projects, and each project contains apps. This structure keeps apps, integrations, knowledge, repositories, deployments, and access controls together for a team.
Organizations and projects support members, teams, standard and custom roles, deployment approvals, and audit logs. Developers can work in Builder or through a connected repository while using the same app source.
Start with Organizations for the hierarchy, Project Overview for project-level resources, and Roles and Permissions for access control.
Use Preview after every meaningful step. When feedback applies to a specific part of the interface, use Review mode to draw on the page, add comments, and send the annotations to the agent.
For larger changes, review the plan before implementation. If a result moves in the wrong direction, inspect the changed files or restore an earlier checkpoint instead of asking the agent to rebuild the entire app.
See Planning, Generation Controls and Collaboration, and Restore a Checkpoint.
Deploy an app to Reflex Cloud from Builder, deploy from the command line, or follow the supported cloud and self-hosting workflows. After deployment, you can monitor status and logs, manage domains and settings, review deployment history, and roll back when necessary.
See Deploy an App, Manage a Deployed App, and Cloud Providers.