Skip to main content
A standalone Widget Package belongs to an existing Droplet and publishes widget code and metadata for that Droplet. The generated project uses defineWidgetPackage and startWidgetPackage from the supported worker SDK.

​
Create the project

You can link an existing Droplet during creation:
If the project is not linked yet:
The command writes the selected Droplet ID to fluid.widget.config.ts. It does not change the package identity, version, or widget registrations in manifest.ts.

​
Start development

The development server normally runs at http://localhost:5174. Preview the package through a portal or builder. The command does not start a separate preview application.

​
Validate and build

Render the built package through a portal or builder. A successful build cannot verify appearance, accessibility, or theme behavior.

​
Publish

Increment the semantic version in manifest.ts, then run:
Publication creates an immutable Droplet widget version. Use a new version for every published change.