Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/content/docs/v5/internal/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,4 +16,6 @@ This page is only visible on preview deployments and local development. It does

Changelog entries staged here for review before publishing to the Vercel website.

- [Local web UI in Nitro dev](/docs/internal/nitro-web-ui) — unreleased (next beta)
- [Native Nitro v3 bundling for workflows](/docs/internal/nitro-native-build) — May 22, 2026
- [Serializable AbortController and AbortSignal](/docs/internal/serializable-abort-controller) — March 12, 2026
7 changes: 6 additions & 1 deletion docs/content/docs/v5/internal/meta.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
{
"title": "Internal",
"pages": ["index", "serializable-abort-controller"],
"pages": [
"index",
"nitro-web-ui",
"nitro-native-build",
"serializable-abort-controller"
],
"defaultOpen": false
}
38 changes: 38 additions & 0 deletions docs/content/docs/v5/internal/nitro-native-build.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: Native Nitro v3 bundling for workflows
description: Workflow routes are now bundled by Nitro v3, so steps run in your app's runtime and can call any server-side Nitro API.
type: overview
---

# Native Nitro v3 bundling for workflows

<span className="text-sm text-fd-muted-foreground">May 22, 2026</span>

Workflow routes are now handled as Nitro v3 handlers and bundled by Nitro, rather than built separately for the Vercel Build Output API. Your workflows are part of the same bundle as the rest of your app.

## What's new

- **Call any server-side Nitro API from a step.** Workflow steps now run inside the same bundled runtime as the rest of your Nitro app, so you can call `useStorage()`, `useDatabase()`, `useRuntimeConfig()`, virtual imports, and any other server-side Nitro API directly from a `"use step"` function.
- **Workflows are part of your Nitro bundle.** Workflow routes are bundled by Nitro alongside your application code, instead of being built into a separate output. There's nothing extra to configure.
- **Minimal runtime output.** During bundling, Nitro automatically traces native dependencies and tree-shakes unused code to produce a minimal runtime output.
- **Nitro v2 is unchanged.** This applies to Nitro v3. Apps on Nitro v2 keep their existing behavior.

## Using Nitro APIs from a step

Because steps run inside your Nitro runtime, server-side utilities work directly inside a `"use step"` function:

```typescript
export async function cacheResult(key: string, value: string) {
"use step";

const storage = useStorage("cache");
await storage.setItem(key, value);

return { cached: true };
}
```

## Learn more

- [Nitro](/docs/getting-started/nitro) — Set up Workflow SDK in a Nitro v3 app
- [Deploying](/docs/deploying) — How workflow bundles are deployed
24 changes: 24 additions & 0 deletions docs/content/docs/v5/internal/nitro-web-ui.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
title: Local web UI in Nitro dev
description: Inspect, monitor, and debug your workflow runs from the /_workflow route during Nitro development.
type: overview
---

# Local web UI in Nitro dev

{/* TODO: unreleased — changeset .changeset/nitro-dashboard-route.md is pending; ships in the next @workflow/nitro beta (5.0.0-beta.12). Update this date on publish. */}
<span className="text-sm text-fd-muted-foreground">June 2, 2026</span>

The Workflow SDK web UI is now built into the Nitro dev server. During development, open `/_workflow` in your browser to inspect, monitor, and debug your workflow runs.

## What's new

- **Built-in `/_workflow` route in development.** The route starts the local web UI and redirects to it — no separate command or process required.
- **Inspect runs in place.** Inspect, monitor, and debug your workflow runs directly from the dev server you're already running.

![Workflow SDK web UI on the /_workflow route](/local-web-ui.png)

## Learn more

- [Observability](/docs/observability) — Inspect runs with the web UI and CLI
- [Nitro](/docs/getting-started/nitro) — Set up Workflow SDK in a Nitro v3 app
Binary file added docs/public/local-web-ui.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading