cloudflare-workflows:setup

Workflow Setup Wizard

Overview

Complete interactive setup wizard for Cloudflare Workflows: project initialization, configuration, class scaffolding, and deployment preparation.

Prerequisites

Check before starting:

• Cloudflare account with wrangler authenticated (wrangler whoami)
• Node.js/Bun installed
• Existing Worker project OR willingness to create one
• Write access to wrangler.jsonc

Steps

Step 1: Project Detection

Check if this is a new or existing project:

# Check for wrangler.jsonc
if [ -f "wrangler.jsonc" ]; then
  EXISTING_PROJECT=true
else
  EXISTING_PROJECT=false
fi

# Check for package.json
if [ -f "package.json" ]; then
  HAS_PACKAGE_JSON=true
else
  HAS_PACKAGE_JSON=false
fi

If new project ($EXISTING_PROJECT == false):

Use AskUserQuestion:

• Question: "No Worker project detected. Create new project?"
• Options:
  • "Yes - Create new Worker project" → Run npm create cloudflare@latest
  • "No - I'll set up manually" → Exit with setup instructions

If existing project: Continue to Step 2

---

Step 2: Gather Workflow Requirements

Use AskUserQuestion to collect setup preferences.

Question 1: Workflow Name

• Header: "Workflow Name"
• Question: "What should your workflow be named?"
• multiSelect: false
• Options:
  • label: "Custom name (I'll type it)"
  • description: "Enter a unique workflow name (e.g., order-processing, user-onboarding)"

Capture input: Ask user to provide workflow name

• Validation: Must be lowercase, alphanumeric + hyphens only (^[a-z0-9-]+$)
• Store as: workflowName
• Generate: className = PascalCase version (e.g., "order-processing" → "OrderProcessing")

---

Question 2: Workflow Purpose

• Header: "Workflow Type"
• Question: "What type of workflow are you building?"
• multiSelect: false
• Options:
  • label: "Sequential Processing"
  • description: "Multi-step data processing with automatic retries"