@nullplatform/plugin-dev-ui
v0.0.5
Published
<h2 align="center"> <a href="https://nullplatform.com" target="blank_"> <img height="100" alt="Nullplatform" src="https://nullplatform.com/favicon/android-chrome-192x192.png" /> </a> <br> <br> @nullplatform/plugin-dev-ui <b
Downloads
217
Readme
Local development UI for nullplatform plugins. Spawns a plugin process via gRPC, renders an interactive form from the plugin's schema, and streams execution events in real time.
Works with any plugin type (scope, simple, service) — it communicates through the standard gRPC ExecutorPlugin protocol.
Install
bun add -d @nullplatform/plugin-dev-uiUsage
# From a plugin directory
bunx @nullplatform/plugin-dev-ui --plugin .
# Or via mise (scaffolded plugins include this task)
mise run devOpen http://localhost:3847 in your browser.
Commands
plugin-dev [--plugin <path>] Full dev mode (default)
plugin-dev preview [--plugin <path>] Form preview only (no plugin process)
plugin-dev snapshot --scope-id <id> [--plugin <path>] Capture context as fixtureOptions
| Flag | Default | Description |
|---|---|---|
| --plugin <path> | cwd | Plugin directory |
| --port <number> | 3847 | Server port |
| --scope-id <id> | — | Scope ID for snapshot command |
How it works
- Runs
--describeon the plugin to get its manifest (schema, actions, metadata) - Renders a JSON Forms UI from the schema
- Spawns the plugin as a gRPC subprocess via
@nullplatform/plugin/testing - Sends
ExecuteRPCs when you trigger actions from the UI - Streams
ExecuteEventresponses (started, output, result) as Server-Sent Events
