Skip to content

fix(builders) - support explicit project roots in swc transforms#1399

Open
AndrewBarba wants to merge 3 commits intomainfrom
barba/codex/builder-explicit-project-root
Open

fix(builders) - support explicit project roots in swc transforms#1399
AndrewBarba wants to merge 3 commits intomainfrom
barba/codex/builder-explicit-project-root

Conversation

@AndrewBarba
Copy link

@AndrewBarba AndrewBarba commented Mar 16, 2026 •
edited
Loading

Summary

  • add an optional projectRoot to builder config so SWC/module-specifier resolution does not have to rely on global cwd
  • thread that root through discovery, SWC transforms, and the Next deferred builder while preserving existing defaults
  • add focused builders tests that prove workspace package ids can be resolved from a consuming app root

Why

[secret framework] currently has to temporarily mutate process.cwd() when invoking Workflow builders so package-owned workflows resolve to stable package ids from the app root. This change makes that root explicit and keeps the current behavior as the fallback when projectRoot is omitted.

Validation

  • pnpm exec vitest run packages/builders/src/module-specifier.test.ts packages/builders/src/swc-esbuild-plugin.test.ts packages/builders/src/discover-entries-esbuild-plugin.test.ts
  • pnpm --filter @workflow/builders typecheck
  • pnpm --filter @workflow/builders build
  • pnpm --filter @workflow/next build

@AndrewBarba AndrewBarba requested review from a team and ijjk as code owners March 16, 2026 16:49
@changeset-bot
Copy link

changeset-bot bot commented Mar 16, 2026 •
edited
Loading

⚠️ No Changeset found

Latest commit: 42a1d11

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link
Contributor

vercel bot commented Mar 16, 2026 •
edited
Loading

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Mar 16, 2026 10:52pm
example-nextjs-workflow-webpack Ready Ready Preview, Comment Mar 16, 2026 10:52pm
example-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workbench-astro-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workbench-express-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workbench-fastify-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workbench-hono-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workbench-nitro-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workbench-nuxt-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workbench-sveltekit-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workbench-vite-workflow Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workflow-docs Ready Ready Preview, Comment, Open in v0 Mar 16, 2026 10:52pm
workflow-nest Ready Ready Preview, Comment Mar 16, 2026 10:52pm
workflow-swc-playground Ready Ready Preview, Comment Mar 16, 2026 10:52pm

@github-actions
Copy link
Contributor

github-actions bot commented Mar 16, 2026 •
edited
Loading

🧪 E2E Test Results

❌ Some tests failed

Summary

Passed Failed Skipped Total
✅ ▲ Vercel Production 560 0 67 627
✅ 💻 Local Development 600 0 84 684
✅ 📦 Local Production 600 0 84 684
❌ 🐘 Local Postgres 551 1 75 627
✅ 🪟 Windows 54 0 3 57
❌ 🌍 Community Worlds 116 55 15 186
✅ 📋 Other 144 0 27 171
Total 2625 56 355 3036

❌ Failed Tests

🐘 Local Postgres (1 failed)

nitro-stable (1 failed):

  • webhookWorkflow
🌍 Community Worlds (55 failed)

mongodb (3 failed):

  • hookWorkflow is not resumable via public webhook endpoint
  • webhookWorkflow
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously

redis (2 failed):

  • hookWorkflow is not resumable via public webhook endpoint
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously

turso (50 failed):

  • addTenWorkflow
  • addTenWorkflow
  • wellKnownAgentWorkflow (.well-known/agent)
  • should work with react rendering in step
  • promiseAllWorkflow
  • promiseRaceWorkflow
  • promiseAnyWorkflow
  • importedStepOnlyWorkflow
  • hookWorkflow
  • hookWorkflow is not resumable via public webhook endpoint
  • webhookWorkflow
  • sleepingWorkflow
  • parallelSleepWorkflow
  • nullByteWorkflow
  • workflowAndStepMetadataWorkflow
  • fetchWorkflow
  • promiseRaceStressTestWorkflow
  • error handling error propagation workflow errors nested function calls preserve message and stack trace
  • error handling error propagation workflow errors cross-file imports preserve message and stack trace
  • error handling error propagation step errors basic step error preserves message and stack trace
  • error handling error propagation step errors cross-file step error preserves message and function names in stack
  • error handling retry behavior regular Error retries until success
  • error handling retry behavior FatalError fails immediately without retries
  • error handling retry behavior RetryableError respects custom retryAfter delay
  • error handling retry behavior maxRetries=0 disables retries
  • error handling catchability FatalError can be caught and detected with FatalError.is()
  • hookCleanupTestWorkflow - hook token reuse after workflow completion
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously
  • hookDisposeTestWorkflow - hook token reuse after explicit disposal while workflow still running
  • stepFunctionPassingWorkflow - step function references can be passed as arguments (without closure vars)
  • stepFunctionWithClosureWorkflow - step function with closure variables passed as argument
  • closureVariableWorkflow - nested step functions with closure variables
  • spawnWorkflowFromStepWorkflow - spawning a child workflow using start() inside a step
  • health check (queue-based) - workflow and step endpoints respond to health check messages
  • pathsAliasWorkflow - TypeScript path aliases resolve correctly
  • Calculator.calculate - static workflow method using static step methods from another class
  • AllInOneService.processNumber - static workflow method using sibling static step methods
  • ChainableService.processWithThis - static step methods using this to reference the class
  • thisSerializationWorkflow - step function invoked with .call() and .apply()
  • customSerializationWorkflow - custom class serialization with WORKFLOW_SERIALIZE/WORKFLOW_DESERIALIZE
  • instanceMethodStepWorkflow - instance methods with "use step" directive
  • crossContextSerdeWorkflow - classes defined in step code are deserializable in workflow context
  • stepFunctionAsStartArgWorkflow - step function reference passed as start() argument
  • cancelRun - cancelling a running workflow
  • cancelRun via CLI - cancelling a running workflow
  • pages router addTenWorkflow via pages router
  • pages router promiseAllWorkflow via pages router
  • pages router sleepingWorkflow via pages router
  • hookWithSleepWorkflow - hook payloads delivered correctly with concurrent sleep
  • sleepWithSequentialStepsWorkflow - sequential steps work with concurrent sleep (control)

Details by Category

✅ ▲ Vercel Production
App Passed Failed Skipped
✅ astro 50 0 7
✅ example 50 0 7
✅ express 50 0 7
✅ fastify 50 0 7
✅ hono 50 0 7
✅ nextjs-turbopack 55 0 2
✅ nextjs-webpack 55 0 2
✅ nitro 50 0 7
✅ nuxt 50 0 7
✅ sveltekit 50 0 7
✅ vite 50 0 7
✅ 💻 Local Development
App Passed Failed Skipped
✅ astro-stable 48 0 9
✅ express-stable 48 0 9
✅ fastify-stable 48 0 9
✅ hono-stable 48 0 9
✅ nextjs-turbopack-canary 54 0 3
✅ nextjs-turbopack-stable 54 0 3
✅ nextjs-webpack-canary 54 0 3
✅ nextjs-webpack-stable 54 0 3
✅ nitro-stable 48 0 9
✅ nuxt-stable 48 0 9
✅ sveltekit-stable 48 0 9
✅ vite-stable 48 0 9
✅ 📦 Local Production
App Passed Failed Skipped
✅ astro-stable 48 0 9
✅ express-stable 48 0 9
✅ fastify-stable 48 0 9
✅ hono-stable 48 0 9
✅ nextjs-turbopack-canary 54 0 3
✅ nextjs-turbopack-stable 54 0 3
✅ nextjs-webpack-canary 54 0 3
✅ nextjs-webpack-stable 54 0 3
✅ nitro-stable 48 0 9
✅ nuxt-stable 48 0 9
✅ sveltekit-stable 48 0 9
✅ vite-stable 48 0 9
❌ 🐘 Local Postgres
App Passed Failed Skipped
✅ astro-stable 48 0 9
✅ express-stable 48 0 9
✅ fastify-stable 48 0 9
✅ hono-stable 48 0 9
✅ nextjs-turbopack-canary 54 0 3
✅ nextjs-turbopack-stable 54 0 3
✅ nextjs-webpack-canary 54 0 3
✅ nextjs-webpack-stable 54 0 3
❌ nitro-stable 47 1 9
✅ nuxt-stable 48 0 9
✅ vite-stable 48 0 9
✅ 🪟 Windows
App Passed Failed Skipped
✅ nextjs-turbopack 54 0 3
❌ 🌍 Community Worlds
App Passed Failed Skipped
✅ mongodb-dev 3 0 2
❌ mongodb 51 3 3
✅ redis-dev 3 0 2
❌ redis 52 2 3
✅ turso-dev 3 0 2
❌ turso 4 50 3
✅ 📋 Other
App Passed Failed Skipped
✅ e2e-local-dev-nest-stable 48 0 9
✅ e2e-local-postgres-nest-stable 48 0 9
✅ e2e-local-prod-nest-stable 48 0 9

📋 View full workflow run

❌ Some E2E test jobs failed:

  • Vercel Prod: success
  • Local Dev: success
  • Local Prod: success
  • Local Postgres: failure
  • Windows: success

Check the workflow run for details.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 16, 2026 •
edited
Loading

📊 Benchmark Results

📈 Comparing against baseline from main branch. Green 🟢 = faster, Red 🔺 = slower.

workflow with no steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Nitro 0.042s (-3.6%) 1.006s (~) 0.963s 10 1.00x
💻 Local Express 0.045s (+19.1% 🔺) 1.005s (~) 0.960s 10 1.06x
💻 Local Next.js (Turbopack) 0.047s 1.006s 0.959s 10 1.11x
🐘 Postgres Nitro 0.051s (-16.9% 🟢) 1.014s (~) 0.963s 10 1.20x
🌐 Redis Next.js (Turbopack) 0.053s 1.005s 0.953s 10 1.25x
🐘 Postgres Next.js (Turbopack) 0.059s 1.012s 0.953s 10 1.39x
🐘 Postgres Express 0.068s (+4.8%) 1.012s (~) 0.944s 10 1.61x
🌐 MongoDB Next.js (Turbopack) 0.090s 1.008s 0.918s 10 2.12x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 0.422s (-16.4% 🟢) 2.711s (+14.4% 🔺) 2.288s 10 1.00x
▲ Vercel Nitro 0.465s (-2.7%) 2.571s (-1.8%) 2.107s 10 1.10x
▲ Vercel Next.js (Turbopack) 0.642s (+1.7%) 2.574s (-4.1%) 1.932s 10 1.52x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

workflow with 1 step

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Next.js (Turbopack) 1.113s 2.006s 0.894s 10 1.00x
🌐 Redis Next.js (Turbopack) 1.121s 2.006s 0.885s 10 1.01x
🐘 Postgres Nitro 1.127s (-1.3%) 2.013s (~) 0.886s 10 1.01x
💻 Local Nitro 1.130s (~) 2.007s (~) 0.877s 10 1.02x
💻 Local Express 1.134s (+3.3%) 2.006s (~) 0.872s 10 1.02x
🐘 Postgres Express 1.153s (+0.7%) 2.012s (~) 0.859s 10 1.04x
🐘 Postgres Next.js (Turbopack) 1.158s 2.012s 0.855s 10 1.04x
🌐 MongoDB Next.js (Turbopack) 1.310s 2.009s 0.699s 10 1.18x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 2.046s (-2.8%) 3.801s (+2.5%) 1.756s 10 1.00x
▲ Vercel Nitro 2.057s (-3.0%) 4.018s (+1.1%) 1.961s 10 1.01x
▲ Vercel Next.js (Turbopack) 2.080s (-4.6%) 3.834s (-4.2%) 1.754s 10 1.02x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

workflow with 10 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🌐 Redis 🥇 Next.js (Turbopack) 10.721s 11.022s 0.301s 3 1.00x
💻 Local Next.js (Turbopack) 10.727s 11.023s 0.296s 3 1.00x
🐘 Postgres Nitro 10.734s (-1.9%) 11.043s (~) 0.310s 3 1.00x
🐘 Postgres Next.js (Turbopack) 10.875s 11.040s 0.165s 3 1.01x
💻 Local Nitro 10.914s (~) 11.023s (~) 0.110s 3 1.02x
🐘 Postgres Express 10.950s (~) 11.041s (-2.9%) 0.091s 3 1.02x
💻 Local Express 10.980s (+3.5%) 11.023s (~) 0.043s 3 1.02x
🌐 MongoDB Next.js (Turbopack) 12.259s 13.021s 0.762s 3 1.14x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Next.js (Turbopack) 17.113s (-3.3%) 19.380s (-2.8%) 2.267s 2 1.00x
▲ Vercel Nitro 17.238s (+3.6%) 18.776s (+3.3%) 1.539s 2 1.01x
▲ Vercel Express 17.735s (+4.6%) 19.363s (+5.2% 🔺) 1.628s 2 1.04x

🔍 Observability: Next.js (Turbopack) | Nitro | Express

workflow with 25 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 26.726s (-1.6%) 27.071s (-3.5%) 0.345s 3 1.00x
🌐 Redis Next.js (Turbopack) 26.761s 27.050s 0.289s 3 1.00x
💻 Local Next.js (Turbopack) 27.006s 27.051s 0.045s 3 1.01x
🐘 Postgres Next.js (Turbopack) 27.053s 27.396s 0.343s 3 1.01x
🐘 Postgres Express 27.127s (~) 28.056s (~) 0.929s 3 1.02x
💻 Local Nitro 27.442s (~) 28.052s (~) 0.611s 3 1.03x
💻 Local Express 27.693s (+3.8%) 28.055s (+3.7%) 0.362s 3 1.04x
🌐 MongoDB Next.js (Turbopack) 30.305s 31.033s 0.727s 2 1.13x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 43.519s (-4.3%) 45.100s (-5.2% 🟢) 1.581s 2 1.00x
▲ Vercel Next.js (Turbopack) 43.848s (-1.2%) 45.825s (-0.7%) 1.977s 2 1.01x
▲ Vercel Nitro 44.511s (+3.1%) 46.112s (+1.9%) 1.602s 2 1.02x

🔍 Observability: Express | Next.js (Turbopack) | Nitro

workflow with 50 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 53.319s (-1.6%) 54.101s (-1.8%) 0.782s 2 1.00x
🌐 Redis Next.js (Turbopack) 53.358s 54.095s 0.737s 2 1.00x
🐘 Postgres Next.js (Turbopack) 53.946s 54.099s 0.153s 2 1.01x
🐘 Postgres Express 54.153s (~) 55.083s (+0.9%) 0.931s 2 1.02x
💻 Local Next.js (Turbopack) 55.755s 56.099s 0.344s 2 1.05x
💻 Local Nitro 56.573s (~) 57.105s (~) 0.532s 2 1.06x
💻 Local Express 56.995s (+3.9%) 57.105s (+3.6%) 0.111s 2 1.07x
🌐 MongoDB Next.js (Turbopack) 60.764s 61.071s 0.307s 2 1.14x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Next.js (Turbopack) 93.851s (-3.9%) 95.723s (-4.0%) 1.872s 1 1.00x
▲ Vercel Nitro 95.595s (+2.1%) 96.956s (+1.3%) 1.361s 1 1.02x
▲ Vercel Express 98.680s (+5.1% 🔺) 100.323s (+4.9%) 1.643s 1 1.05x

🔍 Observability: Next.js (Turbopack) | Nitro | Express

Promise.all with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🌐 Redis 🥇 Next.js (Turbopack) 1.334s 2.007s 0.673s 15 1.00x
🐘 Postgres Nitro 1.349s (-4.7%) 2.011s (~) 0.662s 15 1.01x
🐘 Postgres Express 1.415s (+0.7%) 2.010s (~) 0.595s 15 1.06x
🐘 Postgres Next.js (Turbopack) 1.448s 2.011s 0.562s 15 1.09x
💻 Local Next.js (Turbopack) 1.501s 2.006s 0.505s 15 1.13x
💻 Local Express 1.511s (+4.3%) 2.006s (~) 0.495s 15 1.13x
💻 Local Nitro 1.521s (+1.3%) 2.007s (~) 0.485s 15 1.14x
🌐 MongoDB Next.js (Turbopack) 2.147s 3.008s 0.860s 10 1.61x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 2.258s (-7.2% 🟢) 3.892s (-1.3%) 1.634s 8 1.00x
▲ Vercel Express 2.335s (-1.9%) 3.892s (~) 1.557s 8 1.03x
▲ Vercel Next.js (Turbopack) 2.711s (+17.1% 🔺) 4.136s (+7.5% 🔺) 1.424s 8 1.20x

🔍 Observability: Nitro | Express | Next.js (Turbopack)

Promise.all with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 2.534s (+1.3%) 3.014s (~) 0.480s 10 1.00x
🐘 Postgres Nitro 2.537s (-2.8%) 3.014s (~) 0.477s 10 1.00x
🌐 Redis Next.js (Turbopack) 2.562s 3.008s 0.446s 10 1.01x
🐘 Postgres Next.js (Turbopack) 2.627s 3.014s 0.386s 10 1.04x
💻 Local Next.js (Turbopack) 2.755s 3.007s 0.252s 10 1.09x
💻 Local Nitro 2.900s (+6.5% 🔺) 3.342s (+11.1% 🔺) 0.441s 9 1.14x
💻 Local Express 2.907s (+12.5% 🔺) 3.108s (+3.3%) 0.200s 10 1.15x
🌐 MongoDB Next.js (Turbopack) 4.712s 5.176s 0.465s 6 1.86x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Next.js (Turbopack) 2.615s (+6.1% 🔺) 3.810s (~) 1.195s 8 1.00x
▲ Vercel Express 3.619s (-7.7% 🟢) 5.100s (-5.3% 🟢) 1.481s 6 1.38x
▲ Vercel Nitro 3.805s (+48.4% 🔺) 5.262s (+27.2% 🔺) 1.457s 8 1.46x

🔍 Observability: Next.js (Turbopack) | Express | Nitro

Promise.all with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 3.895s (-1.1%) 4.442s (~) 0.547s 7 1.00x
🐘 Postgres Nitro 4.070s (~) 5.017s (+12.8% 🔺) 0.947s 6 1.04x
🌐 Redis Next.js (Turbopack) 4.090s 4.869s 0.779s 7 1.05x
🐘 Postgres Next.js (Turbopack) 4.253s 5.016s 0.763s 6 1.09x
💻 Local Next.js (Turbopack) 7.505s 7.768s 0.262s 4 1.93x
💻 Local Express 7.919s (+15.7% 🔺) 8.274s (+10.1% 🔺) 0.355s 4 2.03x
💻 Local Nitro 7.965s (+5.5% 🔺) 8.268s (+3.1%) 0.303s 4 2.04x
🌐 MongoDB Next.js (Turbopack) 10.024s 10.345s 0.321s 3 2.57x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 3.106s (+8.8% 🔺) 4.542s (+14.3% 🔺) 1.436s 7 1.00x
▲ Vercel Next.js (Turbopack) 4.945s (+51.3% 🔺) 6.555s (+28.6% 🔺) 1.610s 5 1.59x
▲ Vercel Express 5.246s (+77.7% 🔺) 6.749s (+52.2% 🔺) 1.504s 5 1.69x

🔍 Observability: Nitro | Next.js (Turbopack) | Express

Promise.race with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🌐 Redis 🥇 Next.js (Turbopack) 1.265s 2.007s 0.741s 15 1.00x
🐘 Postgres Nitro 1.351s (-5.5% 🟢) 2.012s (~) 0.661s 15 1.07x
🐘 Postgres Express 1.399s (~) 2.010s (~) 0.611s 15 1.11x
🐘 Postgres Next.js (Turbopack) 1.426s 2.011s 0.584s 15 1.13x
💻 Local Next.js (Turbopack) 1.473s 2.006s 0.533s 15 1.16x
💻 Local Nitro 1.523s (+1.3%) 2.005s (~) 0.482s 15 1.20x
💻 Local Express 1.548s (+4.2%) 2.005s (~) 0.457s 15 1.22x
🌐 MongoDB Next.js (Turbopack) 2.194s 3.008s 0.813s 10 1.73x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Next.js (Turbopack) 2.143s (+2.1%) 3.774s (-3.6%) 1.631s 8 1.00x
▲ Vercel Nitro 2.174s (+3.6%) 4.467s (+23.6% 🔺) 2.293s 7 1.01x
▲ Vercel Express 2.257s (+5.7% 🔺) 3.893s (+7.5% 🔺) 1.636s 8 1.05x

🔍 Observability: Next.js (Turbopack) | Nitro | Express

Promise.race with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 2.502s (-4.4%) 3.013s (~) 0.511s 10 1.00x
🐘 Postgres Express 2.518s (-0.7%) 3.011s (~) 0.493s 10 1.01x
🌐 Redis Next.js (Turbopack) 2.550s 3.008s 0.458s 10 1.02x
🐘 Postgres Next.js (Turbopack) 2.577s 3.011s 0.434s 10 1.03x
💻 Local Next.js (Turbopack) 2.771s 3.008s 0.237s 10 1.11x
💻 Local Nitro 2.933s (-3.2%) 3.454s (-3.1%) 0.521s 9 1.17x
💻 Local Express 3.006s (+14.0% 🔺) 3.566s (+18.5% 🔺) 0.560s 9 1.20x
🌐 MongoDB Next.js (Turbopack) 4.662s 5.178s 0.516s 6 1.86x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 2.290s (-11.9% 🟢) 3.792s (-4.0%) 1.503s 8 1.00x
▲ Vercel Next.js (Turbopack) 2.786s (-10.8% 🟢) 4.589s (-2.7%) 1.803s 7 1.22x
▲ Vercel Nitro 2.972s (-3.5%) 4.511s (+1.5%) 1.539s 8 1.30x

🔍 Observability: Express | Next.js (Turbopack) | Nitro

Promise.race with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 3.996s (~) 4.447s (-3.1%) 0.451s 7 1.00x
🐘 Postgres Nitro 4.045s (-0.6%) 4.447s (-3.2%) 0.401s 7 1.01x
🌐 Redis Next.js (Turbopack) 4.152s 4.868s 0.716s 7 1.04x
🐘 Postgres Next.js (Turbopack) 4.327s 5.015s 0.687s 6 1.08x
💻 Local Next.js (Turbopack) 7.771s 8.516s 0.745s 4 1.94x
💻 Local Express 8.547s (+14.8% 🔺) 9.025s (+12.6% 🔺) 0.479s 4 2.14x
💻 Local Nitro 8.970s (+14.4% 🔺) 9.522s (+11.7% 🔺) 0.552s 4 2.24x
🌐 MongoDB Next.js (Turbopack) 9.784s 10.349s 0.565s 3 2.45x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 4.391s (+66.6% 🔺) 5.809s (+44.1% 🔺) 1.418s 6 1.00x
▲ Vercel Next.js (Turbopack) 6.390s (+111.3% 🔺) 8.071s (+58.6% 🔺) 1.681s 4 1.46x
▲ Vercel Nitro 7.394s (+154.5% 🔺) 8.752s (+88.7% 🔺) 1.358s 4 1.68x

🔍 Observability: Express | Next.js (Turbopack) | Nitro

Stream Benchmarks (includes TTFB metrics)
workflow with stream

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Next.js (Turbopack) 0.160s 1.002s 0.011s 1.016s 0.856s 10 1.00x
🐘 Postgres Nitro 0.167s (-22.2% 🟢) 0.999s (~) 0.002s (~) 1.013s (~) 0.846s 10 1.04x
🌐 Redis Next.js (Turbopack) 0.175s 1.000s 0.002s 1.008s 0.833s 10 1.09x
🐘 Postgres Next.js (Turbopack) 0.197s 1.001s 0.001s 1.012s 0.815s 10 1.23x
💻 Local Nitro 0.200s (-0.9%) 1.003s (~) 0.011s (+4.6%) 1.017s (~) 0.818s 10 1.25x
💻 Local Express 0.212s (+58.7% 🔺) 1.004s (~) 0.012s (+28.3% 🔺) 1.019s (~) 0.807s 10 1.32x
🐘 Postgres Express 0.223s (+6.4% 🔺) 0.995s (~) 0.002s (+6.7% 🔺) 1.012s (~) 0.789s 10 1.39x
🌐 MongoDB Next.js (Turbopack) 0.525s 0.925s 0.001s 1.008s 0.483s 10 3.29x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Express 1.698s (-4.3%) 2.295s (-20.0% 🟢) 0.004s (-17.8% 🟢) 2.826s (-81.6% 🟢) 1.128s 10 1.00x
▲ Vercel Nitro 1.770s (+5.1% 🔺) 2.700s (~) 0.006s (+22.4% 🔺) 3.304s (+1.2%) 1.533s 10 1.04x
▲ Vercel Next.js (Turbopack) 1.823s (+5.2% 🔺) 2.695s (-1.8%) 0.005s (+2.1%) 3.460s (+1.4%) 1.637s 10 1.07x

🔍 Observability: Express | Nitro | Next.js (Turbopack)

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World 🥇 Fastest Framework Wins
💻 Local Next.js (Turbopack) 11/12
🐘 Postgres Nitro 9/12
▲ Vercel Express 6/12
Fastest World by Framework

Winner determined by most benchmark wins

Framework 🥇 Fastest World Wins
Express 🐘 Postgres 8/12
Next.js (Turbopack) 🌐 Redis 9/12
Nitro 🐘 Postgres 10/12
Column Definitions
  • Workflow Time: Runtime reported by workflow (completedAt - createdAt) - primary metric
  • TTFB: Time to First Byte - time from workflow start until first stream byte received (stream benchmarks only)
  • Slurp: Time from first byte to complete stream consumption (stream benchmarks only)
  • Wall Time: Total testbench time (trigger workflow + poll for result)
  • Overhead: Testbench overhead (Wall Time - Workflow Time)
  • Samples: Number of benchmark iterations run
  • vs Fastest: How much slower compared to the fastest configuration for this benchmark

Worlds:

  • 💻 Local: In-memory filesystem world (local development)
  • 🐘 Postgres: PostgreSQL database world (local development)
  • ▲ Vercel: Vercel production/preview deployment
  • 🌐 Turso: Community world (local development)
  • 🌐 MongoDB: Community world (local development)
  • 🌐 Redis: Community world (local development)
  • 🌐 Jazz: Community world (local development)

📋 View full workflow run

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@ijjk ijjk Awaiting requested review from ijjk ijjk is a code owner

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@AndrewBarba @TooTallNate