write-flow

To create and deploy a Windmill flow, make a folder ending with .flow and add a YAML flow definition file. Deploy by running wmill flow generate-locks --yes followed by wmill sync push.

Add inline scripts to a Windmill flow by using the rawscript property with the !inline tag. Point it to your script file path, like !inline path/to/script.ts, to embed code directly within the YAML flow structure.

The OpenFlow schema, specifically openflow.openapi.yaml, is the authoritative source of truth for defining Windmill flow structure. It governs the rules for module IDs, input transforms, and resource references.

Generating lock files with wmill flow generate-locks --yes validates your flow structure deterministically before deployment. Running it before wmill sync push prevents manual errors and ensures a reliable Windmill deployment.

Windmill flow deployment works without external dependencies by using the core wmill CLI tooling. You can author YAML definitions, generate lock files, and push changes using only standard Windmill workflow components.

The best way to structure a Windmill flow for deployment is to create a dedicated folder ending with .flow. Place your YAML flow definition file inside this folder to ensure deterministic validation and syncing with wmill sync push.