create-ui

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. Creation is a hard gate: the author must report the exact target and path with verified: true, the static design-system compliance scan must pass, and the workflow page plus compiled __smithers_ui/client.js bundle must independently return HTTP 200. Failed checks are sent back to the author. The loop allows three rounds; if it still has violations, the run fails with RALPH_MAX_REACHED instead of shipping the last attempt.

bunx smthrs 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.

Start

Articles

Learn

Capabilities

Build Workflows

Run and Operate

Workflow Pack

Components

Integrations

Agent Support

Examples

Contributing

Inputs

Result

​Inputs

​Result

Inputs

Result