Can I wait for external events in a workflow?

Yes, using 'step.waitForEvent()', a workflow can pause execution until an external signal or webhook is received, with a configurable timeout of up to 30 days.

How does state persistence work in this skill?

Workflows automatically persist any JSON-serializable data returned from a 'step.do()' call. This ensures that even if a workflow is paused or retried, the data from previous steps remains available.

When should I use a NonRetryableError?

Use NonRetryableError for terminal failures where retrying will not help, such as invalid user input, authentication failures, or 404 errors for resources that will not be created.

How do I test my workflows locally?

This skill supports testing via the 'cloudflare:test' module and Vitest, allowing you to mock step results, disable sleeps for faster tests, and introspect workflow instances.

What is the primary benefit of Cloudflare Workflows?

Cloudflare Workflows allow you to build durable, multi-step processes that can run for hours or days with automatic state persistence, meaning they can survive restarts and handle long wait periods without manual intervention.

Cloudflare Workflows

Name: Cloudflare Workflows
Author: jezweb

byjezweb

•

Cloud Infrastructure

Builds and deploys durable, long-running serverless processes with automatic state persistence and retry logic on the Cloudflare platform.

About

This skill provides specialized guidance for architecting durable, multi-step workflows using Cloudflare Workflows. It helps developers implement complex orchestration patterns including relative and absolute delays, event-driven triggers with waitForEvent, and sophisticated retry configurations. By leveraging this skill, developers can ensure their workflows handle state persistence correctly, manage terminal failures via NonRetryableError, and maintain high observability through integrated CPU metrics and instance tracking. It is ideal for building resilient background tasks, payment pipelines, and multi-day automation sequences that require high concurrency and reliable execution.

Key Features

Durable execution with automatic state persistence and JSON serialization
Integrated testing support using Vitest and the cloudflare:test module
Advanced orchestration using step.do, step.sleep, and step.waitForEvent
Sophisticated retry logic with constant, linear, and exponential backoff
91 GitHub stars
High-scale instance management supporting up to 10,000 concurrent runs

Use Cases

Building multi-day payment processing and subscription lifecycle pipelines
Orchestrating complex, event-driven API integrations with external webhooks
Implementing reliable background jobs with automated retries and error handling

About

Key Features

Durable execution with automatic state persistence and JSON serialization
Integrated testing support using Vitest and the cloudflare:test module
Advanced orchestration using step.do, step.sleep, and step.waitForEvent
Sophisticated retry logic with constant, linear, and exponential backoff
91 GitHub stars
High-scale instance management supporting up to 10,000 concurrent runs

Use Cases

Building multi-day payment processing and subscription lifecycle pipelines
Orchestrating complex, event-driven API integrations with external webhooks
Implementing reliable background jobs with automated retries and error handling