Hono

This guide shows you how to install Workflow DevKit in a Hono application using Nitro as the build system.

Install dependencies

Install the required packages:

npm install workflow hono nitro rollup

yarn add workflow hono nitro rollup

pnpm add workflow hono nitro rollup

Nitro provides the build system needed to compile workflows. Learn more at nitro.build.

Configure Nitro

Create a nitro.config.ts file with the Workflow module:

nitro.config.ts

import { defineConfig } from 'nitro';

export default defineConfig({
  modules: ['workflow/nitro'],
  routes: {
    '/**': './src/index.ts',
  },
});

This configuration:

Enables the Workflow Nitro module
Routes all requests to your Hono app

Create your Hono app

Create src/index.ts with your Hono application:

src/index.ts

import { Hono } from 'hono';
import { start } from 'workflow/api';
import { handleUserSignup } from '../workflows/user-signup.js';

const app = new Hono();

app.post('/api/signup', async (c) => {
  const { email } = await c.req.json();
  await start(handleUserSignup, [email]);
  return c.json({ message: "User signup workflow started" });
});

export default app;

Update package.json scripts

Add development and build scripts:

package.json

{
  "type": "module",
  "scripts": {
    "dev": "nitro dev",
    "build": "nitro build",
    "start": "node .output/server/index.mjs"
  }
}

Enable TypeScript support (Optional)

Add the Workflow TypeScript plugin to your tsconfig.json for IntelliSense:

tsconfig.json

{
  "compilerOptions": {
    "plugins": [
      {
        "name": "workflow"
      }
    ]
  }
}

How it works

The Hono + Nitro integration:

Uses Nitro’s build system to compile workflows
Generates workflow route handlers at .well-known/workflow/v1/*
Supports both development (with HMR) and production builds
Routes all non-workflow requests to your Hono app
Automatically handles workflow execution and resumption
Uses native Web API Request and Response objects

Example workflow

workflows/user-signup.ts

import { sleep } from "workflow";

export async function handleUserSignup(email: string) {
  "use workflow";

  const user = await createUser(email);
  await sendWelcomeEmail(user);
  await sleep("1 day");
  await sendOnboardingEmail(user);

  return { userId: user.id, status: "onboarded" };
}

async function createUser(email: string) {
  "use step";
  console.log(`Creating user with email: ${email}`);
  return { id: crypto.randomUUID(), email };
}

async function sendWelcomeEmail(user: { id: string; email: string }) {
  "use step";
  console.log(`Sending welcome email to user: ${user.id}`);
}

async function sendOnboardingEmail(user: { id: string; email: string }) {
  "use step";
  console.log(`Sending onboarding email to user: ${user.id}`);
}

Development

Run the development server:

npm run dev

Trigger a workflow:

curl -X POST --json '{"email":"hello@example.com"}' http://localhost:3000/api/signup

Production

Build and start the production server:

npm run build
npm start

Getting Started

Installation

Core Concepts

Building AI Agents

How It Works

Deployment

Observability

Testing

Error Reference

How it works

Example workflow

Development

Production

Next steps

Core Concepts

Nitro Integration

​How it works

​Example workflow

​Development

​Production

​Next steps

Core Concepts

Nitro Integration

How it works

Example workflow

Development

Production

Next steps