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

# create-ui

> Author and verify a custom UI for a workflow against a running Gateway.

`create-ui` is the hidden system workflow behind the Smithers Monitor's
**Create UI** action. One agent reads a target workflow, writes its convention-based
`.smithers/ui/<workflow>.tsx` view, and verifies that both the workflow route and
compiled UI bundle return HTTP 200 from the running Gateway.

The workflow deliberately does not edit the target workflow. Adding a `<UI>` node
would change its resume hash; the Gateway discovers the new file by convention and
picks it up without a restart.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bunx smithers-orchestrator workflow run create-ui --input '{
  "targetWorkflow": "release-train",
  "gatewayUrl": "http://127.0.0.1:7331",
  "exampleRunId": ""
}'
```

## Inputs

| Input            | Type   | Default                                                     |
| ---------------- | ------ | ----------------------------------------------------------- |
| `targetWorkflow` | string | Required workflow key.                                      |
| `gatewayUrl`     | string | `http://127.0.0.1:7331`                                     |
| `exampleRunId`   | string | `""`; when supplied, the result links directly to that run. |

## Result

The `author-and-verify` task returns the target workflow, the generated UI path,
whether both live routes verified successfully, and a summary. It may only set
`verified: true` after the Gateway serves both routes with HTTP 200.

This workflow writes only `.smithers/ui/<targetWorkflow>.tsx`. It requires a
running Gateway and is hidden from default workflow listings because it is
monitor plumbing; pass `--system` when listing system workflows.