WorkflowInstallation

Installation

Install @visulima/workflow and learn which parts run on which runtimes

Installation

npm install @visulima/workflow
yarn add @visulima/workflow
pnpm add @visulima/workflow

Dependencies

The engine ships with a small, fixed dependency set:

  • xstate — models the run lifecycle and produces the persisted snapshot.
  • croner — cron/interval math for delays (zero-dependency, edge-safe).
  • @standard-schema/spec — the types-only payload-validation contract.

unstorage is an optional peer, needed only if you use the UnstorageStore.

Runtime support

The engine core and the in-memory / unstorage stores are fetch + Web Crypto only — no node:* — so they run on:

RuntimeCore + MemoryStore / UnstorageStoreNotes
Node.js✅^22.14.0 || >=24.10.0
Cloudflare Workers✅back the store with KV / D1 / a Durable Object
Vercel Edge✅back the store with a KV/SQL driver
Deno✅
Bun✅

Node-only durability (Postgres, Redis) lives entirely behind your own WorkflowStore adapter — the engine itself stays edge-pure.

Edit on GitHub

On this page

InstallationDependenciesRuntime support
Support

Contribute to our work and keep us going

Community is the heart of open source. The success of our packages wouldn't be possible without the incredible contributions of users, testers, and developers who collaborate with us every day.Want to get involved? Here are some tips on how you can make a meaningful impact on our open source projects.

Ready to help us out?

Be sure to check out the package's contribution guidelines first. They'll walk you through the process on how to properly submit an issue or pull request to our repositories.

Submit a pull request

Found something to improve? Fork the repo, make your changes, and open a PR. We review every contribution and provide feedback to help you get merged.

Good first issues

Simple issues suited for people new to open source development, and often a good place to start working on a package.
View good first issues