Fluid Widget CLI

@fluid-app/fluid-cli-widget provides the dedicated workflow for standalone Fluid 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 widget package project.
• fluid widget link — link the current project to an existing Droplet and package name.
• pnpm dev — run the generated project's local Vite preview for widget development.
• 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.

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.