Fluid Widget CLI

@fluid-app/fluid-cli-widget provides the dedicated workflow for standalone Remote DOM widget packages owned by existing Droplets.

Droplets are not created by this CLI. Create and approve the Droplet first, then pass its UUID with --droplet or save it in fluid.widget.config.ts with fluid widget link.

Commands

fluid widget create my-widget --droplet <uuid>
fluid widget link --droplet <uuid>
pnpm dev
fluid widget build
fluid widget publish
fluid widget status
fluid widget logs

• fluid widget create <project-name> — scaffold a standalone worker-only widget package from the bundled canonical template. Pass --remote-template only to opt into the GitHub mirror, or --skip-install for scaffold-only output.
• fluid widget link — link the current project to an existing Droplet and package name.
• pnpm dev — run the generated project's local Remote DOM development endpoints.
• fluid widget build — validate and build runtime artifacts into .fluid/widget-dist.
• fluid widget publish — publish a droplet-owned widget package version.
• fluid widget status — show published widget package status for a Droplet.
• fluid widget logs — show recent widget package publish logs for a Droplet.

fluid widget validate is also available for checking package metadata without building.

The dev server exposes canonical package descriptors at /__widget-packages__ and the worker at /__runtime-entry__. Portal and builder hosts consume those Remote DOM endpoints; this package does not ship a parallel iframe preview app.

Typical workflow

fluid login
fluid widget create reviews-widget --droplet <existing-droplet-uuid>
cd reviews-widget
pnpm dev
fluid widget build
fluid widget publish
fluid widget status

Use --dry-run with fluid widget publish to build and inspect the upload payload without creating a widget package version.