# Devtools Sandbox

The sandbox is an interactive development surface for reviewing shared admin UI components and composed form controls. Each example renders the real component and exposes a copyable usage snippet.

## Routes and Source

| Route                     | Source                                            | Coverage                                      |
| ------------------------- | ------------------------------------------------- | --------------------------------------------- |
| `/devtools/sandbox/ui`    | `apps/admin/src/devtools/pages/SandboxUIPage/`    | Shared UI primitives and composed UI behavior |
| `/devtools/sandbox/forms` | `apps/admin/src/devtools/pages/SandboxFormsPage/` | Shared composed form controls                 |

## Maintenance Rules

- Use real shared components; do not duplicate their implementation in devtools.
- Keep examples small enough to show one API or behavior clearly.
- Keep rendered examples and source snippets synchronized.
- Prefer adding edge-state examples when a component has loading, empty, error, disabled, or destructive behavior.
- Do not add backend dependencies to the sandbox unless the example explicitly documents and isolates them.
- Remove sandbox examples when the underlying shared API is removed.