# Flowdular Sandbox

Source: https://sandbox.flowdular.com/

Describe a module. Watch it get built, checked and previewed.

Write a brief in business terms. The sandbox takes it through a specification you approve, a build by your coding agent behind the platform gates, and a live preview, all on your machine.

## Run it locally

```sh
npx @flowdular/sandbox
```

It creates or finds a Flowdular workspace, starts the app and serves the sandbox at http://127.0.0.1:4320.

## How it works

The sandbox waits for you where it matters. Nothing is built before you approve the specification, and nothing leaves the session before the gates pass.

1. **Brief**: Describe the module in business terms: what it records, who uses it, what needs approval. A planner names the modules it touches and the first specialist.
2. **Specification you approve**: The brief becomes a module specification: data, screens, permissions and endpoints. You read it, edit it and approve it. A later change asks for approval again.
3. **Build with gates**: Your coding agent writes the module in an isolated workspace. Every turn runs the gates (types, tests and security checks) and shows the full diff.
4. **Live preview**: The draft runs inside the real application shell, on its own throwaway database, with real permissions and no access to your data. Ask for changes or deliver it as code.

## What you need

- **Node 24 and pnpm 11**: And Git. The launcher generates and installs the workspace, with a local embedded database, so there is no server to set up.
- **Your coding agent or a model key**: Claude Code or Codex CLI, signed in the way you already use them, or an API key for the model you prefer. The sandbox ships no model of its own.
- **It runs on your machine**: The sandbox, the workspace and its data stay local. Nothing leaves your machine except the calls to the model you chose.

[Sandbox README](https://github.com/flowdular/flowdular/tree/main/packages/sandbox#readme) · [Flowdular](https://flowdular.com/) · [Source code](https://github.com/flowdular/flowdular)