Skip to content

docs: split v4/v5 content trees and fix version switcher end-to-end - #1948

Merged
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher
May 6, 2026
Merged

docs: split v4/v5 content trees and fix version switcher end-to-end#1948
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher

Conversation

@karthikscale3

Copy link
Copy Markdown
Contributor

Summary

Content restructuring

  • Split docs/content/docs/ into docs/content/docs/v4/ and docs/content/docs/v5/ — each version is now a fully independent content tree with no shared-file coupling or preRelease frontmatter filtering
  • v4 excludes the four v5-only pages (AbortController cancellation docs, abort-signal-timeout error, and serializable-abort-controller internal page)
  • v5 retains all pages; preRelease frontmatter field removed (no longer meaningful with separate folders)
  • Removed AbortController / AbortSignal from the v4 serialization page (moved to v5 only)

Fumadocs source split

  • Added v4docs and v5docs as separate defineDocs() collections in source.config.ts pointing to content/docs/v4 and content/docs/v5
  • source.ts now exports both source (v4) and v5Source (v5), both with baseUrl: /docs

Version routing fixes

  • version-source.ts simplified: removed filterPreReleaseFromNodes / isPreReleaseUrl logic; v4 sidebar uses source, v5 uses v5Source + existing rewriteNodeUrls
  • v4 page.tsx: removed the preRelease guard (v4Source simply doesn't contain those pages)
  • v5 page.tsx: uses v5Source for getPage, generateStaticParams, and generateMetadata; v5Link wrapper rewrites /docs/… hrefs to /v5/docs/… so inline MDX links stay in the v5 context
  • buildVersionUrl now handles /cookbook/… paths with the same version-prefix logic as /docs/…; non-versioned routes (worlds, api) return unchanged

Versioned cookbook

  • Added app/[lang]/v5/cookbook/ layout + page (mirrors v4, uses v5Source and rewriteCookbookUrlForVersion)
  • getCookbookTree accepts a versionPrefix parameter; sidebar URLs are prefixed accordingly (/v5/cookbook/…)
  • cookbook-tree.ts: added skipVersions?: string[] per-recipe field for version-specific exclusions; distributed-abort-controller marked skipVersions: ['v5'] so it shows in v4 but not v5

Version switcher — state & navigation

  • New VersionProvider context (hooks/geistdocs/use-version.tsx) backed by localStorage: URL is the source of truth on versioned pages; localStorage carries the preference across non-versioned pages (worlds, etc.)
  • VersionSwitcher uses useVersion() context; now visible on all pages including cookbook (no longer hidden on non-docs routes)
  • DesktopMenu and MobileMenu read activeVersion from context so "Docs" and "Cookbook" navbar links resolve to the correct version prefix on every page
  • switchVersion does a HEAD probe before navigating; falls back to the versioned cookbook or docs home if the target page doesn't exist in that version — handles both v4-only → v5 (distributed-abort-controller) and v5-only → v4 (cancellation docs) cases

Cookbook content (v5)

  • Rewrote agent-cancellation recipe using a single AbortController + hook pattern; removed the Hard Cancellation vs Stop Signal two-approach comparison and comparison table
  • Deleted distributed-abort-controller recipe from v5 (native AbortController serialization in v5 makes it unnecessary)
  • Removed all references to distributed-abort-controller from cookbook/index.mdx, common-patterns/timeouts.mdx, advanced/meta.json, and the agent-cancellation page

Test plan

  • /docs/… (v4) pages load correctly; v5-only pages (/docs/foundations/cancellation, etc.) return 404
  • /v5/docs/… pages load correctly including the four v5-only pages
  • Version switcher shows correct version on docs, cookbook, and worlds pages
  • Switching v4 → v5 on a docs page navigates to the same page under /v5/docs/…
  • Switching v5 → v4 on a v5-only page falls back to /docs/getting-started
  • Switching versions on /cookbook/… navigates to the same recipe under /v5/cookbook/… (or falls back if not present)
  • Switching v4 → v5 on /cookbook/advanced/distributed-abort-controller falls back to /v5/cookbook
  • Navbar "Docs" and "Cookbook" links resolve to the active version's prefix on all pages
  • Version preference is preserved when navigating from docs → cookbook → back to docs

Made with Cursor

@changeset-bot

changeset-botBot commented May 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b76034f

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

vercelBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

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

workflow with no steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro0.033s (-23.0% 🟢)1.006s (~)0.973s101.00x
💻 LocalExpress0.038s (-14.9% 🟢)1.008s (~)0.970s101.14x
🐘 PostgresNitro0.048s (-49.3% 🟢)1.013s (-2.9%)0.964s101.45x
💻 LocalNext.js (Turbopack)0.051s1.006s0.954s101.55x
🌐 RedisNext.js (Turbopack)0.053s1.005s0.952s101.58x
🐘 PostgresNext.js (Turbopack)0.060s1.013s0.953s101.81x
🌐 MongoDBNext.js (Turbopack)0.099s1.008s0.909s102.98x
🐘 PostgresExpress0.111s (+91.4% 🔺)1.063s (+5.2% 🔺)0.952s103.34x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro0.245s (-40.1% 🟢)2.147s (-14.4% 🟢)1.902s101.00x
▲ VercelExpress0.253s (+7.3% 🔺)2.140s (~)1.887s101.03x
▲ VercelNext.js (Turbopack)0.798s (+217.1% 🔺)2.773s (+18.9% 🔺)1.976s103.25x

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

workflow with 1 step

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.067s (-5.7% 🟢)2.007s (~)0.940s101.00x
💻 LocalExpress1.082s (-3.8%)2.008s (~)0.925s101.01x
🐘 PostgresNitro1.091s (-4.3%)2.009s (~)0.918s101.02x
🌐 RedisNext.js (Turbopack)1.109s2.006s0.898s101.04x
💻 LocalNext.js (Turbopack)1.115s2.006s0.891s101.05x
🐘 PostgresNext.js (Turbopack)1.128s2.009s0.881s101.06x
🐘 PostgresExpress1.130s (-1.4%)2.024s (+0.7%)0.894s101.06x
🌐 MongoDBNext.js (Turbopack)1.168s2.009s0.841s101.09x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express1.579s (-15.8% 🟢)3.777s (-0.8%)2.199s101.00x
▲ VercelNitro1.590s (-59.1% 🟢)3.673s (-37.8% 🟢)2.083s101.01x
▲ VercelNext.js (Turbopack)3.197s (+57.1% 🔺)4.489s (+17.2% 🔺)1.292s102.03x

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

workflow with 10 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro10.427s (-4.7%)11.021s (~)0.594s31.00x
💻 LocalExpress10.465s (-4.2%)11.025s (~)0.559s31.00x
🐘 PostgresNitro10.467s (-3.7%)11.019s (~)0.552s31.00x
🌐 RedisNext.js (Turbopack)10.655s11.023s0.368s31.02x
💻 LocalNext.js (Turbopack)10.666s11.022s0.356s31.02x
🐘 PostgresNext.js (Turbopack)10.756s11.015s0.260s31.03x
🌐 MongoDBNext.js (Turbopack)10.834s11.020s0.186s31.04x
🐘 PostgresExpress10.866s (-0.9%)11.400s (+3.4%)0.534s31.04x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro13.218s (-44.3% 🟢)14.916s (-40.6% 🟢)1.698s31.00x
▲ VercelExpress13.258s (-21.9% 🟢)15.627s (-21.9% 🟢)2.368s21.00x
▲ VercelNext.js (Turbopack)15.143s (-12.6% 🟢)16.855s (-13.1% 🟢)1.712s21.15x

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

workflow with 25 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro13.417s (-10.9% 🟢)14.027s (-12.5% 🟢)0.610s51.00x
🐘 PostgresNitro13.484s (-7.6% 🟢)14.019s (-6.7% 🟢)0.536s51.00x
💻 LocalExpress13.637s (-8.9% 🟢)14.030s (-6.7% 🟢)0.392s51.02x
🌐 RedisNext.js (Turbopack)14.069s14.828s0.759s51.05x
💻 LocalNext.js (Turbopack)14.090s15.031s0.941s41.05x
🌐 MongoDBNext.js (Turbopack)14.228s15.025s0.798s41.06x
🐘 PostgresNext.js (Turbopack)14.238s15.020s0.782s41.06x
🐘 PostgresExpress14.414s (-1.2%)15.017s (~)0.604s41.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro21.299s (-67.0% 🟢)23.458s (-64.8% 🟢)2.159s31.00x
▲ VercelExpress21.953s (-56.4% 🟢)24.119s (-54.1% 🟢)2.166s31.03x
▲ VercelNext.js (Turbopack)22.605s (-57.0% 🟢)24.322s (-55.5% 🟢)1.717s31.06x

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

workflow with 50 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro11.799s (-29.7% 🟢)12.022s (-29.4% 🟢)0.222s81.00x
🐘 PostgresNitro12.001s (-14.1% 🟢)12.392s (-13.4% 🟢)0.390s81.02x
💻 LocalExpress12.214s (-26.4% 🟢)13.027s (-23.5% 🟢)0.813s71.04x
🌐 RedisNext.js (Turbopack)12.955s13.311s0.355s71.10x
💻 LocalNext.js (Turbopack)13.113s14.026s0.913s71.11x
🐘 PostgresNext.js (Turbopack)13.257s14.016s0.759s71.12x
🌐 MongoDBNext.js (Turbopack)13.339s14.025s0.687s71.13x
🐘 PostgresExpress16.095s (+14.9% 🔺)16.539s (+13.3% 🔺)0.444s61.36x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro31.335s (-92.6% 🟢)33.852s (-92.0% 🟢)2.517s31.00x
▲ VercelExpress33.300s (-72.5% 🟢)35.430s (-71.3% 🟢)2.130s31.06x
▲ VercelNext.js (Turbopack)33.643s (-91.5% 🟢)35.813s (-90.9% 🟢)2.170s31.07x

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

Promise.all with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.151s (-9.7% 🟢)2.007s (~)0.856s151.00x
💻 LocalNitro1.170s (-28.3% 🟢)2.005s (-3.3%)0.836s151.02x
💻 LocalExpress1.182s (-20.6% 🟢)2.007s (~)0.825s151.03x
🐘 PostgresNext.js (Turbopack)1.220s2.007s0.786s151.06x
🌐 RedisNext.js (Turbopack)1.244s2.006s0.762s151.08x
💻 LocalNext.js (Turbopack)1.280s2.006s0.726s151.11x
🐘 PostgresExpress1.443s (+14.5% 🔺)2.184s (+8.7% 🔺)0.742s141.25x
🌐 MongoDBNext.js (Turbopack)2.044s2.918s0.874s111.78x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.481s (-13.2% 🟢)4.024s (-13.0% 🟢)1.543s81.00x
▲ VercelNitro2.531s (-10.2% 🟢)4.150s (-4.0%)1.619s81.02x
▲ VercelNext.js (Turbopack)3.892s (+14.6% 🔺)5.639s (+14.3% 🔺)1.747s61.57x

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

Promise.all with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.224s (-48.0% 🟢)2.007s (-33.3% 🟢)0.783s151.00x
🐘 PostgresNext.js (Turbopack)1.384s2.007s0.623s151.13x
💻 LocalExpress1.642s (-44.4% 🟢)2.007s (-41.9% 🟢)0.364s151.34x
🐘 PostgresExpress1.690s (-28.4% 🟢)2.263s (-24.8% 🟢)0.573s141.38x
💻 LocalNitro1.693s (-46.1% 🟢)2.005s (-48.4% 🟢)0.312s151.38x
💻 LocalNext.js (Turbopack)1.848s2.073s0.226s151.51x
🌐 RedisNext.js (Turbopack)2.359s3.008s0.649s101.93x
🌐 MongoDBNext.js (Turbopack)3.611s4.009s0.398s82.95x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.862s (-4.7%)5.659s (-4.4%)1.797s61.00x
▲ VercelExpress4.351s (+20.2% 🔺)5.741s (+12.3% 🔺)1.391s61.13x
▲ VercelNext.js (Turbopack)5.397s (-24.0% 🟢)7.101s (-20.3% 🟢)1.704s51.40x

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

Promise.all with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.372s (-60.6% 🟢)2.008s (-49.9% 🟢)0.636s151.00x
🐘 PostgresNext.js (Turbopack)1.764s2.074s0.310s151.29x
🐘 PostgresExpress2.273s (-34.8% 🟢)3.078s (-23.3% 🟢)0.805s101.66x
🌐 RedisNext.js (Turbopack)3.639s4.010s0.370s82.65x
💻 LocalNitro4.502s (-46.1% 🟢)5.011s (-44.4% 🟢)0.510s63.28x
💻 LocalExpress4.545s (-45.5% 🟢)5.014s (-44.5% 🟢)0.469s73.31x
💻 LocalNext.js (Turbopack)5.644s6.215s0.571s54.11x
🌐 MongoDBNext.js (Turbopack)6.310s7.015s0.705s54.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.332s (+51.2% 🔺)6.946s (+25.5% 🔺)1.614s51.00x
▲ VercelNext.js (Turbopack)6.496s (-27.1% 🟢)8.168s (-25.5% 🟢)1.672s41.22x
▲ VercelExpress7.267s (+71.4% 🔺)9.101s (+48.5% 🔺)1.834s41.36x

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

Promise.race with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.149s (-8.6% 🟢)2.007s (~)0.858s151.00x
🌐 RedisNext.js (Turbopack)1.228s2.006s0.778s151.07x
🐘 PostgresNext.js (Turbopack)1.246s2.008s0.762s151.08x
💻 LocalNext.js (Turbopack)1.328s2.006s0.678s151.16x
💻 LocalNitro1.387s (-25.7% 🟢)2.006s (-14.3% 🟢)0.619s151.21x
🐘 PostgresExpress1.481s (+17.8% 🔺)2.163s (+7.7% 🔺)0.682s141.29x
💻 LocalExpress1.482s (-21.7% 🟢)2.007s (-15.1% 🟢)0.525s151.29x
🌐 MongoDBNext.js (Turbopack)2.031s2.827s0.796s111.77x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro2.354s (-4.2%)3.765s (-9.7% 🟢)1.411s81.00x
▲ VercelExpress2.501s (-3.1%)3.783s (-13.0% 🟢)1.283s81.06x
▲ VercelNext.js (Turbopack)3.502s (+19.5% 🔺)5.206s (+12.1% 🔺)1.704s71.49x

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

Promise.race with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.223s (-47.7% 🟢)2.009s (-33.3% 🟢)0.785s151.00x
🐘 PostgresNext.js (Turbopack)1.405s2.008s0.603s151.15x
🐘 PostgresExpress1.673s (-28.6% 🟢)2.326s (-22.8% 🟢)0.653s131.37x
💻 LocalExpress1.769s (-43.5% 🟢)2.151s (-42.8% 🟢)0.381s141.45x
💻 LocalNitro1.856s (-39.4% 🟢)2.222s (-42.8% 🟢)0.366s141.52x
💻 LocalNext.js (Turbopack)2.011s2.591s0.579s121.64x
🌐 RedisNext.js (Turbopack)2.353s3.008s0.655s101.92x
🌐 MongoDBNext.js (Turbopack)3.583s4.010s0.428s82.93x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.537s (+9.4% 🔺)5.179s (+2.0%)1.642s61.00x
▲ VercelExpress3.550s (+11.2% 🔺)5.397s (+12.6% 🔺)1.847s61.00x
▲ VercelNext.js (Turbopack)5.661s (+80.1% 🔺)6.980s (+54.4% 🔺)1.319s51.60x

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

Promise.race with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.375s (-60.5% 🟢)2.008s (-49.9% 🟢)0.633s151.00x
🐘 PostgresNext.js (Turbopack)1.637s2.075s0.438s151.19x
🐘 PostgresExpress2.311s (-34.0% 🟢)3.176s (-20.8% 🟢)0.865s101.68x
🌐 RedisNext.js (Turbopack)3.594s4.010s0.416s82.61x
💻 LocalExpress4.730s (-46.3% 🟢)5.346s (-42.3% 🟢)0.616s63.44x
💻 LocalNitro5.397s (-41.0% 🟢)6.014s (-40.0% 🟢)0.617s53.92x
💻 LocalNext.js (Turbopack)5.562s6.014s0.453s54.04x
🌐 MongoDBNext.js (Turbopack)6.355s7.014s0.659s54.62x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro4.714s (-7.4% 🟢)6.592s (-3.3%)1.878s51.00x
▲ VercelNext.js (Turbopack)5.926s (-12.3% 🟢)8.154s (-4.6%)2.228s41.26x
▲ VercelExpress6.059s (-5.6% 🟢)8.015s (-2.0%)1.956s41.29x

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

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.437s (-46.7% 🟢)1.007s (~)0.569s601.00x
💻 LocalNitro0.459s (-53.2% 🟢)1.004s (-8.2% 🟢)0.544s601.05x
💻 LocalExpress0.567s (-42.4% 🟢)1.040s (-3.4%)0.473s581.30x
🌐 RedisNext.js (Turbopack)0.621s1.004s0.383s601.42x
🐘 PostgresNext.js (Turbopack)0.667s1.006s0.339s601.53x
🌐 MongoDBNext.js (Turbopack)0.730s1.006s0.276s601.67x
💻 LocalNext.js (Turbopack)0.737s1.005s0.268s601.68x
🐘 PostgresExpress0.905s (+7.9% 🔺)1.370s (+33.9% 🔺)0.465s452.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express4.958s (-73.9% 🟢)6.669s (-68.7% 🟢)1.711s91.00x
▲ VercelNitro5.116s (-76.8% 🟢)6.704s (-72.1% 🟢)1.588s101.03x
▲ VercelNext.js (Turbopack)7.017s (-51.6% 🟢)8.729s (-45.7% 🟢)1.711s71.42x

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

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.022s (-47.0% 🟢)1.585s (-24.5% 🟢)0.564s571.00x
💻 LocalNitro1.161s (-61.7% 🟢)2.005s (-46.6% 🟢)0.844s451.14x
💻 LocalExpress1.307s (-56.7% 🟢)2.006s (-44.0% 🟢)0.700s451.28x
🌐 RedisNext.js (Turbopack)1.492s2.006s0.514s451.46x
🐘 PostgresNext.js (Turbopack)1.604s2.008s0.404s451.57x
💻 LocalNext.js (Turbopack)1.792s2.006s0.214s451.75x
🌐 MongoDBNext.js (Turbopack)1.842s2.007s0.166s451.80x
🐘 PostgresExpress2.094s (+5.9% 🔺)2.560s (+13.4% 🔺)0.467s362.05x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro12.742s (-67.7% 🟢)14.987s (-63.7% 🟢)2.246s71.00x
▲ VercelExpress13.193s (-61.8% 🟢)14.863s (-59.6% 🟢)1.670s71.04x
▲ VercelNext.js (Turbopack)14.895s (-70.1% 🟢)16.716s (-67.7% 🟢)1.822s61.17x

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

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro2.012s (-51.0% 🟢)2.427s (-47.3% 🟢)0.416s501.00x
💻 LocalNitro2.667s (-71.3% 🟢)3.033s (-69.7% 🟢)0.366s401.33x
💻 LocalExpress2.912s (-68.4% 🟢)3.252s (-67.5% 🟢)0.340s371.45x
🌐 RedisNext.js (Turbopack)2.984s3.250s0.267s371.48x
🐘 PostgresNext.js (Turbopack)3.270s4.045s0.775s301.63x
💻 LocalNext.js (Turbopack)3.857s4.075s0.217s301.92x
🐘 PostgresExpress4.078s (+2.2%)4.502s (+3.0%)0.424s272.03x
🌐 MongoDBNext.js (Turbopack)4.220s5.012s0.792s242.10x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro38.819s (-59.9% 🟢)40.985s (-58.4% 🟢)2.166s31.00x
▲ VercelExpress39.658s (-69.5% 🟢)41.705s (-68.4% 🟢)2.048s31.02x
▲ VercelNext.js (Turbopack)46.146s (-56.9% 🟢)47.530s (-56.4% 🟢)1.383s31.19x

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

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.182s (-35.9% 🟢)1.006s (~)0.824s601.00x
🌐 RedisNext.js (Turbopack)0.237s1.004s0.767s601.30x
🐘 PostgresNext.js (Turbopack)0.241s1.006s0.765s601.33x
💻 LocalNitro0.447s (-26.1% 🟢)1.004s (-1.7%)0.557s602.46x
💻 LocalExpress0.478s (-14.7% 🟢)1.005s (~)0.527s602.63x
🐘 PostgresExpress0.511s (+80.8% 🔺)1.148s (+14.0% 🔺)0.637s532.81x
💻 LocalNext.js (Turbopack)0.581s1.005s0.423s603.20x
🌐 MongoDBNext.js (Turbopack)1.036s1.855s0.819s335.70x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.028s (+3.8%)3.796s (+4.4%)1.768s161.00x
▲ VercelNitro2.293s (+38.0% 🔺)4.077s (+21.7% 🔺)1.785s151.13x
▲ VercelNext.js (Turbopack)3.973s (+96.4% 🔺)5.530s (+45.8% 🔺)1.557s111.96x

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

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.310s (-37.4% 🟢)1.006s (~)0.696s901.00x
🌐 RedisNext.js (Turbopack)0.407s1.004s0.597s901.31x
🐘 PostgresNext.js (Turbopack)0.482s1.007s0.524s901.55x
🐘 PostgresExpress0.818s (+60.4% 🔺)1.341s (+33.3% 🔺)0.523s682.63x
💻 LocalExpress2.184s (-13.1% 🟢)3.010s (~)0.825s307.04x
💻 LocalNitro2.198s (-13.4% 🟢)2.944s (-2.2%)0.746s317.08x
🌐 MongoDBNext.js (Turbopack)2.606s3.007s0.400s308.39x
💻 LocalNext.js (Turbopack)2.614s3.149s0.535s298.42x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Next.js (Turbopack)6.797s (+92.3% 🔺)8.510s (+63.9% 🔺)1.713s111.00x
▲ VercelNitro7.928s (+145.8% 🔺)9.974s (+106.8% 🔺)2.046s101.17x
▲ VercelExpress8.062s (+164.6% 🔺)9.804s (+103.9% 🔺)1.742s101.19x

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

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.662s (-16.3% 🟢)1.006s (~)0.344s1201.00x
🌐 RedisNext.js (Turbopack)0.751s1.012s0.261s1191.14x
🐘 PostgresNext.js (Turbopack)0.981s1.521s0.539s801.48x
🐘 PostgresExpress1.706s (+108.3% 🔺)2.295s (+125.6% 🔺)0.589s532.58x
🌐 MongoDBNext.js (Turbopack)5.391s6.014s0.623s208.14x
💻 LocalNitro9.825s (-12.2% 🟢)10.446s (-10.4% 🟢)0.621s1214.85x
💻 LocalExpress10.179s (-9.0% 🟢)10.783s (-9.7% 🟢)0.604s1215.38x
💻 LocalNext.js (Turbopack)11.645s12.330s0.685s1017.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express18.117s (+144.2% 🔺)20.127s (+117.7% 🔺)2.009s61.00x
▲ VercelNext.js (Turbopack)19.231s (+86.2% 🔺)21.009s (+71.0% 🔺)1.778s71.06x
▲ VercelNitro23.043s (+198.4% 🔺)25.291s (+169.0% 🔺)2.248s51.27x

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

Stream Benchmarks(includes TTFB metrics)
workflow with stream

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.129s (+428.1% 🔺)2.005s (+99.6% 🔺)0.011s (-14.4% 🟢)2.018s (+98.0% 🔺)0.889s101.00x
🐘 PostgresNitro1.138s (+455.3% 🔺)2.001s (+100.2% 🔺)0.001s (-13.3% 🟢)2.010s (+98.7% 🔺)0.871s101.01x
💻 LocalExpress1.143s (+474.3% 🔺)2.006s (+99.7% 🔺)0.010s (-15.7% 🟢)2.019s (+98.3% 🔺)0.875s101.01x
💻 LocalNext.js (Turbopack)1.190s2.003s0.013s2.020s0.830s101.05x
🐘 PostgresNext.js (Turbopack)1.195s2.001s0.002s2.011s0.815s101.06x
🐘 PostgresExpress1.514s (+638.4% 🔺)2.094s (+109.7% 🔺)0.378s (+23500.0% 🔺)2.508s (+148.0% 🔺)0.994s101.34x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.104s (-16.0% 🟢)3.360s (-17.8% 🟢)1.769s (+84.1% 🔺)5.626s (+0.6%)3.521s101.00x
▲ VercelNitro2.336s (-39.0% 🟢)3.612s (-31.6% 🟢)1.861s (+150.7% 🔺)6.014s (-7.2% 🟢)3.678s101.11x
▲ VercelNext.js (Turbopack)5.134s (-25.1% 🟢)5.213s (-39.7% 🟢)1.098s (+73.8% 🔺)7.870s (-19.6% 🟢)2.735s102.44x

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

stream pipeline with 5 transform steps (1MB)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.538s (+146.5% 🔺)2.001s (+98.8% 🔺)0.004s (-12.1% 🟢)2.025s (+98.0% 🔺)0.487s301.00x
💻 LocalExpress1.588s (+109.7% 🔺)2.011s (+95.5% 🔺)0.012s (+25.7% 🔺)2.026s (+94.8% 🔺)0.438s301.03x
🐘 PostgresNext.js (Turbopack)1.705s2.010s0.004s2.026s0.321s301.11x
💻 LocalNext.js (Turbopack)1.866s2.011s0.010s2.203s0.337s281.21x
💻 LocalNitro2.164s (+158.1% 🔺)2.010s (+98.6% 🔺)0.009s (-4.0%)2.675s (+139.7% 🔺)0.510s231.41x
🐘 PostgresExpress2.444s (+288.0% 🔺)2.731s (+171.4% 🔺)0.003s (-19.3% 🟢)2.767s (+170.4% 🔺)0.322s221.59x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express5.877s (-9.6% 🟢)7.234s (-9.7% 🟢)0.232s (-43.4% 🟢)7.955s (-10.0% 🟢)2.078s81.00x
▲ VercelNitro5.894s (-80.0% 🟢)7.169s (-76.7% 🟢)0.258s (+130.4% 🔺)7.895s (-75.2% 🟢)2.001s81.00x
▲ VercelNext.js (Turbopack)13.642s (-19.4% 🟢)13.146s (-27.9% 🟢)0.318s (+50.3% 🔺)15.510s (-18.1% 🟢)1.868s42.32x

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

10 parallel streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.694s (-28.3% 🟢)1.030s (-17.5% 🟢)0.000s (-57.9% 🟢)1.060s (-15.7% 🟢)0.366s571.00x
🐘 PostgresNext.js (Turbopack)0.798s1.072s0.000s1.082s0.284s561.15x
💻 LocalNext.js (Turbopack)1.451s2.014s0.000s2.017s0.566s302.09x
💻 LocalExpress1.475s (+20.4% 🔺)2.015s (~)0.000s (~)2.018s (~)0.543s302.12x
💻 LocalNitro1.486s (+21.5% 🔺)2.014s (~)0.000s (+364.3% 🔺)2.195s (+8.6% 🔺)0.709s282.14x
🐘 PostgresExpress2.079s (+116.4% 🔺)2.453s (+92.0% 🔺)0.000s (-100.0% 🟢)2.522s (+93.1% 🔺)0.443s242.99x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express3.871s (+3.5%)5.345s (+4.7%)0.003s (+1500.0% 🔺)5.771s (+4.4%)1.900s111.00x
▲ VercelNitro3.911s (+28.2% 🔺)5.386s (+22.6% 🔺)0.000s (+254.5% 🔺)5.924s (+23.2% 🔺)2.013s111.01x
▲ VercelNext.js (Turbopack)6.210s (-39.0% 🟢)6.441s (-44.1% 🟢)0.001s (+Infinity% 🔺)7.762s (-35.6% 🟢)1.552s81.60x

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

fan-out fan-in 10 streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.461s (-18.5% 🟢)2.141s (~)0.000s (~)2.154s (-1.0%)0.693s281.00x
🐘 PostgresNext.js (Turbopack)1.801s2.348s0.000s2.356s0.554s261.23x
💻 LocalNext.js (Turbopack)2.779s3.293s0.001s3.298s0.519s191.90x
💻 LocalNitro2.995s (-11.6% 🟢)3.735s (-7.4% 🟢)0.000s (-89.0% 🟢)3.737s (-7.4% 🟢)0.743s172.05x
💻 LocalExpress3.279s (-5.4% 🟢)3.840s (-4.8%)0.001s (-21.9% 🟢)3.847s (-4.7%)0.568s162.24x
🐘 PostgresExpress3.897s (+119.9% 🔺)4.233s (+94.4% 🔺)0.000s (+Infinity% 🔺)4.354s (+98.0% 🔺)0.458s142.67x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.840s (+42.7% 🔺)7.408s (+37.8% 🔺)0.000s (-8.3% 🟢)7.847s (+35.4% 🔺)2.007s81.00x
▲ VercelExpress5.876s (+28.1% 🔺)7.054s (+17.1% 🔺)0.001s (+Infinity% 🔺)7.514s (+16.4% 🔺)1.638s81.01x
▲ VercelNext.js (Turbopack)8.242s (+46.7% 🔺)9.359s (+34.0% 🔺)0.000s (+33.3% 🔺)10.005s (+32.7% 🔺)1.763s61.41x

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

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World🥇 Fastest FrameworkWins
💻 LocalNitro13/21
🐘 PostgresNitro21/21
▲ VercelNitro12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework🥇 Fastest WorldWins
Express💻 Local15/21
Next.js (Turbopack)🌐 Redis11/21
Nitro🐘 Postgres15/21
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


⚠️Community world benchmarks failed (non-blocking):

  • Community Worlds: failure

Check the workflow run for details.

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

PassedFailedSkippedTotal
✅ ▲ Vercel Production120002191419
✅ 💻 Local Development158702191806
✅ 📦 Local Production158702191806
✅ 🐘 Local Postgres158702191806
✅ 🪟 Windows12900129
✅ 📋 Other7270176903
Total6817010527869

Details by Category

✅ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro103026
✅ example103026
✅ express103026
✅ fastify103026
✅ hono103026
✅ nextjs-turbopack12702
✅ nextjs-webpack12702
✅ nitro103026
✅ nuxt103026
✅ sveltekit12207
✅ vite103026
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🪟 Windows
AppPassedFailedSkipped
✅ nextjs-turbopack12900
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable104025
✅ e2e-local-dev-tanstack-start-104025
✅ e2e-local-postgres-nest-stable104025
✅ e2e-local-postgres-tanstack-start-104025
✅ e2e-local-prod-nest-stable104025
✅ e2e-local-prod-tanstack-start-104025
✅ e2e-vercel-prod-tanstack-start103026

📋 View full workflow run

@karthikscale3
karthikscale3force-pushed the karthik/fix-doc-switcher branch from 42d3fd0 to 4f0c239CompareMay 6, 2026 04:47
## Content restructuring
- Split `docs/content/docs/` into `docs/content/docs/v4/` and
`docs/content/docs/v5/` so each version is a fully independent
content tree with no shared-file coupling
- v4 excludes the four pages that are v5-only (AbortController
cancellation docs and the serializable-abort-controller internal page)
- v5 retains all pages; `preRelease` frontmatter field removed (no
longer needed now that each version is its own folder)
- Removed `AbortController` / `AbortSignal` from v4 serialization page
(section moved to v5 only)
## Fumadocs source
- Added `v4docs` and `v5docs` as separate `defineDocs()` collections in
`source.config.ts`; shared `docsSchema` (no more `preRelease` field)
- `source.ts` exports both `source` (v4, `baseUrl: /docs`) and
`v5Source` (v5, same base URL)
## Version routing
- `version-source.ts` simplified: `filterPreReleaseFromNodes` and
`isPreReleaseUrl` logic removed; v4 tree uses `source`, v5 tree uses
`v5Source` + `rewriteNodeUrls`
- v4 `page.tsx`: removed `preRelease` guard (v4Source has no such pages)
- v5 `page.tsx`: uses `v5Source` for `getPage` / `generateStaticParams`
/ `generateMetadata`; `v5Link` wrapper rewrites `/docs/…` hrefs to
`/v5/docs/…` so inline MDX links stay in the v5 context
## Versioned cookbook
- Added `app/[lang]/v5/cookbook/` layout + page (mirrors v4 but uses
`v5Source`, `rewriteCookbookUrlForVersion`, and `V5CookbookLink`)
- `getCookbookTree` accepts a `versionPrefix` parameter; sidebar URLs
are prefixed accordingly (`/v5/cookbook/…`)
- `cookbook-tree.ts`: added `skipVersions?: string[]` per-recipe field
for version-specific exclusions; `distributed-abort-controller` is
marked `skipVersions: ['v5']`
## Version switcher — state & navigation
- New `VersionProvider` context (`hooks/geistdocs/use-version.tsx`)
backed by `localStorage`: URL is source of truth on versioned pages,
`localStorage` carries the preference across non-versioned pages
(cookbook overview, worlds, etc.)
- `VersionSwitcher` uses `useVersion()` context instead of URL-only
detection; now visible on all pages including cookbook
- `DesktopMenu` and `MobileMenu` use `activeVersion` from context so
the "Docs" and "Cookbook" navbar links resolve to the correct version
prefix on every page
- `buildVersionUrl` expanded to handle `/cookbook/…` paths alongside
`/docs/…`; non-versioned routes (worlds, api) return unchanged
- `switchVersion` does a `HEAD` probe before navigating; falls back to
the versioned cookbook or docs home if the target page doesn't exist
in that version (handles v4-only → v5 and v5-only → v4 cases)
## Cookbook content (v5)
- Rewrote `agent-cancellation` recipe using a single `AbortController`
pattern; removed Hard Cancellation vs Stop Signal two-approach
comparison
- Deleted `distributed-abort-controller` recipe from v5 (native
`AbortController` serialization makes it unnecessary)
- Removed references to distributed-abort-controller from
`cookbook/index.mdx` and `common-patterns/timeouts.mdx`
Co-authored-by: Cursor <cursoragent@cursor.com>
Content moved from docs/content/docs/ to docs/content/docs/v5/ on main
(pre-release channel). Stable branch will use v4/ after backport.
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@karthikscale3@pranaygp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
docs: split v4/v5 content trees and fix version switcher end-to-end by karthikscale3 · Pull Request #1948 · vercel/workflow · GitHub
Skip to content

docs: split v4/v5 content trees and fix version switcher end-to-end - #1948

Merged
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher
May 6, 2026
Merged

docs: split v4/v5 content trees and fix version switcher end-to-end#1948
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher

Conversation

@karthikscale3

Copy link
Copy Markdown
Contributor

Summary

Content restructuring

  • Split docs/content/docs/ into docs/content/docs/v4/ and docs/content/docs/v5/ — each version is now a fully independent content tree with no shared-file coupling or preRelease frontmatter filtering
  • v4 excludes the four v5-only pages (AbortController cancellation docs, abort-signal-timeout error, and serializable-abort-controller internal page)
  • v5 retains all pages; preRelease frontmatter field removed (no longer meaningful with separate folders)
  • Removed AbortController / AbortSignal from the v4 serialization page (moved to v5 only)

Fumadocs source split

  • Added v4docs and v5docs as separate defineDocs() collections in source.config.ts pointing to content/docs/v4 and content/docs/v5
  • source.ts now exports both source (v4) and v5Source (v5), both with baseUrl: /docs

Version routing fixes

  • version-source.ts simplified: removed filterPreReleaseFromNodes / isPreReleaseUrl logic; v4 sidebar uses source, v5 uses v5Source + existing rewriteNodeUrls
  • v4 page.tsx: removed the preRelease guard (v4Source simply doesn't contain those pages)
  • v5 page.tsx: uses v5Source for getPage, generateStaticParams, and generateMetadata; v5Link wrapper rewrites /docs/… hrefs to /v5/docs/… so inline MDX links stay in the v5 context
  • buildVersionUrl now handles /cookbook/… paths with the same version-prefix logic as /docs/…; non-versioned routes (worlds, api) return unchanged

Versioned cookbook

  • Added app/[lang]/v5/cookbook/ layout + page (mirrors v4, uses v5Source and rewriteCookbookUrlForVersion)
  • getCookbookTree accepts a versionPrefix parameter; sidebar URLs are prefixed accordingly (/v5/cookbook/…)
  • cookbook-tree.ts: added skipVersions?: string[] per-recipe field for version-specific exclusions; distributed-abort-controller marked skipVersions: ['v5'] so it shows in v4 but not v5

Version switcher — state & navigation

  • New VersionProvider context (hooks/geistdocs/use-version.tsx) backed by localStorage: URL is the source of truth on versioned pages; localStorage carries the preference across non-versioned pages (worlds, etc.)
  • VersionSwitcher uses useVersion() context; now visible on all pages including cookbook (no longer hidden on non-docs routes)
  • DesktopMenu and MobileMenu read activeVersion from context so "Docs" and "Cookbook" navbar links resolve to the correct version prefix on every page
  • switchVersion does a HEAD probe before navigating; falls back to the versioned cookbook or docs home if the target page doesn't exist in that version — handles both v4-only → v5 (distributed-abort-controller) and v5-only → v4 (cancellation docs) cases

Cookbook content (v5)

  • Rewrote agent-cancellation recipe using a single AbortController + hook pattern; removed the Hard Cancellation vs Stop Signal two-approach comparison and comparison table
  • Deleted distributed-abort-controller recipe from v5 (native AbortController serialization in v5 makes it unnecessary)
  • Removed all references to distributed-abort-controller from cookbook/index.mdx, common-patterns/timeouts.mdx, advanced/meta.json, and the agent-cancellation page

Test plan

  • /docs/… (v4) pages load correctly; v5-only pages (/docs/foundations/cancellation, etc.) return 404
  • /v5/docs/… pages load correctly including the four v5-only pages
  • Version switcher shows correct version on docs, cookbook, and worlds pages
  • Switching v4 → v5 on a docs page navigates to the same page under /v5/docs/…
  • Switching v5 → v4 on a v5-only page falls back to /docs/getting-started
  • Switching versions on /cookbook/… navigates to the same recipe under /v5/cookbook/… (or falls back if not present)
  • Switching v4 → v5 on /cookbook/advanced/distributed-abort-controller falls back to /v5/cookbook
  • Navbar "Docs" and "Cookbook" links resolve to the active version's prefix on all pages
  • Version preference is preserved when navigating from docs → cookbook → back to docs

Made with Cursor

@changeset-bot

changeset-botBot commented May 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b76034f

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

vercelBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

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

workflow with no steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro0.033s (-23.0% 🟢)1.006s (~)0.973s101.00x
💻 LocalExpress0.038s (-14.9% 🟢)1.008s (~)0.970s101.14x
🐘 PostgresNitro0.048s (-49.3% 🟢)1.013s (-2.9%)0.964s101.45x
💻 LocalNext.js (Turbopack)0.051s1.006s0.954s101.55x
🌐 RedisNext.js (Turbopack)0.053s1.005s0.952s101.58x
🐘 PostgresNext.js (Turbopack)0.060s1.013s0.953s101.81x
🌐 MongoDBNext.js (Turbopack)0.099s1.008s0.909s102.98x
🐘 PostgresExpress0.111s (+91.4% 🔺)1.063s (+5.2% 🔺)0.952s103.34x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro0.245s (-40.1% 🟢)2.147s (-14.4% 🟢)1.902s101.00x
▲ VercelExpress0.253s (+7.3% 🔺)2.140s (~)1.887s101.03x
▲ VercelNext.js (Turbopack)0.798s (+217.1% 🔺)2.773s (+18.9% 🔺)1.976s103.25x

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

workflow with 1 step

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.067s (-5.7% 🟢)2.007s (~)0.940s101.00x
💻 LocalExpress1.082s (-3.8%)2.008s (~)0.925s101.01x
🐘 PostgresNitro1.091s (-4.3%)2.009s (~)0.918s101.02x
🌐 RedisNext.js (Turbopack)1.109s2.006s0.898s101.04x
💻 LocalNext.js (Turbopack)1.115s2.006s0.891s101.05x
🐘 PostgresNext.js (Turbopack)1.128s2.009s0.881s101.06x
🐘 PostgresExpress1.130s (-1.4%)2.024s (+0.7%)0.894s101.06x
🌐 MongoDBNext.js (Turbopack)1.168s2.009s0.841s101.09x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express1.579s (-15.8% 🟢)3.777s (-0.8%)2.199s101.00x
▲ VercelNitro1.590s (-59.1% 🟢)3.673s (-37.8% 🟢)2.083s101.01x
▲ VercelNext.js (Turbopack)3.197s (+57.1% 🔺)4.489s (+17.2% 🔺)1.292s102.03x

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

workflow with 10 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro10.427s (-4.7%)11.021s (~)0.594s31.00x
💻 LocalExpress10.465s (-4.2%)11.025s (~)0.559s31.00x
🐘 PostgresNitro10.467s (-3.7%)11.019s (~)0.552s31.00x
🌐 RedisNext.js (Turbopack)10.655s11.023s0.368s31.02x
💻 LocalNext.js (Turbopack)10.666s11.022s0.356s31.02x
🐘 PostgresNext.js (Turbopack)10.756s11.015s0.260s31.03x
🌐 MongoDBNext.js (Turbopack)10.834s11.020s0.186s31.04x
🐘 PostgresExpress10.866s (-0.9%)11.400s (+3.4%)0.534s31.04x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro13.218s (-44.3% 🟢)14.916s (-40.6% 🟢)1.698s31.00x
▲ VercelExpress13.258s (-21.9% 🟢)15.627s (-21.9% 🟢)2.368s21.00x
▲ VercelNext.js (Turbopack)15.143s (-12.6% 🟢)16.855s (-13.1% 🟢)1.712s21.15x

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

workflow with 25 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro13.417s (-10.9% 🟢)14.027s (-12.5% 🟢)0.610s51.00x
🐘 PostgresNitro13.484s (-7.6% 🟢)14.019s (-6.7% 🟢)0.536s51.00x
💻 LocalExpress13.637s (-8.9% 🟢)14.030s (-6.7% 🟢)0.392s51.02x
🌐 RedisNext.js (Turbopack)14.069s14.828s0.759s51.05x
💻 LocalNext.js (Turbopack)14.090s15.031s0.941s41.05x
🌐 MongoDBNext.js (Turbopack)14.228s15.025s0.798s41.06x
🐘 PostgresNext.js (Turbopack)14.238s15.020s0.782s41.06x
🐘 PostgresExpress14.414s (-1.2%)15.017s (~)0.604s41.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro21.299s (-67.0% 🟢)23.458s (-64.8% 🟢)2.159s31.00x
▲ VercelExpress21.953s (-56.4% 🟢)24.119s (-54.1% 🟢)2.166s31.03x
▲ VercelNext.js (Turbopack)22.605s (-57.0% 🟢)24.322s (-55.5% 🟢)1.717s31.06x

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

workflow with 50 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro11.799s (-29.7% 🟢)12.022s (-29.4% 🟢)0.222s81.00x
🐘 PostgresNitro12.001s (-14.1% 🟢)12.392s (-13.4% 🟢)0.390s81.02x
💻 LocalExpress12.214s (-26.4% 🟢)13.027s (-23.5% 🟢)0.813s71.04x
🌐 RedisNext.js (Turbopack)12.955s13.311s0.355s71.10x
💻 LocalNext.js (Turbopack)13.113s14.026s0.913s71.11x
🐘 PostgresNext.js (Turbopack)13.257s14.016s0.759s71.12x
🌐 MongoDBNext.js (Turbopack)13.339s14.025s0.687s71.13x
🐘 PostgresExpress16.095s (+14.9% 🔺)16.539s (+13.3% 🔺)0.444s61.36x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro31.335s (-92.6% 🟢)33.852s (-92.0% 🟢)2.517s31.00x
▲ VercelExpress33.300s (-72.5% 🟢)35.430s (-71.3% 🟢)2.130s31.06x
▲ VercelNext.js (Turbopack)33.643s (-91.5% 🟢)35.813s (-90.9% 🟢)2.170s31.07x

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

Promise.all with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.151s (-9.7% 🟢)2.007s (~)0.856s151.00x
💻 LocalNitro1.170s (-28.3% 🟢)2.005s (-3.3%)0.836s151.02x
💻 LocalExpress1.182s (-20.6% 🟢)2.007s (~)0.825s151.03x
🐘 PostgresNext.js (Turbopack)1.220s2.007s0.786s151.06x
🌐 RedisNext.js (Turbopack)1.244s2.006s0.762s151.08x
💻 LocalNext.js (Turbopack)1.280s2.006s0.726s151.11x
🐘 PostgresExpress1.443s (+14.5% 🔺)2.184s (+8.7% 🔺)0.742s141.25x
🌐 MongoDBNext.js (Turbopack)2.044s2.918s0.874s111.78x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.481s (-13.2% 🟢)4.024s (-13.0% 🟢)1.543s81.00x
▲ VercelNitro2.531s (-10.2% 🟢)4.150s (-4.0%)1.619s81.02x
▲ VercelNext.js (Turbopack)3.892s (+14.6% 🔺)5.639s (+14.3% 🔺)1.747s61.57x

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

Promise.all with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.224s (-48.0% 🟢)2.007s (-33.3% 🟢)0.783s151.00x
🐘 PostgresNext.js (Turbopack)1.384s2.007s0.623s151.13x
💻 LocalExpress1.642s (-44.4% 🟢)2.007s (-41.9% 🟢)0.364s151.34x
🐘 PostgresExpress1.690s (-28.4% 🟢)2.263s (-24.8% 🟢)0.573s141.38x
💻 LocalNitro1.693s (-46.1% 🟢)2.005s (-48.4% 🟢)0.312s151.38x
💻 LocalNext.js (Turbopack)1.848s2.073s0.226s151.51x
🌐 RedisNext.js (Turbopack)2.359s3.008s0.649s101.93x
🌐 MongoDBNext.js (Turbopack)3.611s4.009s0.398s82.95x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.862s (-4.7%)5.659s (-4.4%)1.797s61.00x
▲ VercelExpress4.351s (+20.2% 🔺)5.741s (+12.3% 🔺)1.391s61.13x
▲ VercelNext.js (Turbopack)5.397s (-24.0% 🟢)7.101s (-20.3% 🟢)1.704s51.40x

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

Promise.all with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.372s (-60.6% 🟢)2.008s (-49.9% 🟢)0.636s151.00x
🐘 PostgresNext.js (Turbopack)1.764s2.074s0.310s151.29x
🐘 PostgresExpress2.273s (-34.8% 🟢)3.078s (-23.3% 🟢)0.805s101.66x
🌐 RedisNext.js (Turbopack)3.639s4.010s0.370s82.65x
💻 LocalNitro4.502s (-46.1% 🟢)5.011s (-44.4% 🟢)0.510s63.28x
💻 LocalExpress4.545s (-45.5% 🟢)5.014s (-44.5% 🟢)0.469s73.31x
💻 LocalNext.js (Turbopack)5.644s6.215s0.571s54.11x
🌐 MongoDBNext.js (Turbopack)6.310s7.015s0.705s54.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.332s (+51.2% 🔺)6.946s (+25.5% 🔺)1.614s51.00x
▲ VercelNext.js (Turbopack)6.496s (-27.1% 🟢)8.168s (-25.5% 🟢)1.672s41.22x
▲ VercelExpress7.267s (+71.4% 🔺)9.101s (+48.5% 🔺)1.834s41.36x

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

Promise.race with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.149s (-8.6% 🟢)2.007s (~)0.858s151.00x
🌐 RedisNext.js (Turbopack)1.228s2.006s0.778s151.07x
🐘 PostgresNext.js (Turbopack)1.246s2.008s0.762s151.08x
💻 LocalNext.js (Turbopack)1.328s2.006s0.678s151.16x
💻 LocalNitro1.387s (-25.7% 🟢)2.006s (-14.3% 🟢)0.619s151.21x
🐘 PostgresExpress1.481s (+17.8% 🔺)2.163s (+7.7% 🔺)0.682s141.29x
💻 LocalExpress1.482s (-21.7% 🟢)2.007s (-15.1% 🟢)0.525s151.29x
🌐 MongoDBNext.js (Turbopack)2.031s2.827s0.796s111.77x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro2.354s (-4.2%)3.765s (-9.7% 🟢)1.411s81.00x
▲ VercelExpress2.501s (-3.1%)3.783s (-13.0% 🟢)1.283s81.06x
▲ VercelNext.js (Turbopack)3.502s (+19.5% 🔺)5.206s (+12.1% 🔺)1.704s71.49x

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

Promise.race with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.223s (-47.7% 🟢)2.009s (-33.3% 🟢)0.785s151.00x
🐘 PostgresNext.js (Turbopack)1.405s2.008s0.603s151.15x
🐘 PostgresExpress1.673s (-28.6% 🟢)2.326s (-22.8% 🟢)0.653s131.37x
💻 LocalExpress1.769s (-43.5% 🟢)2.151s (-42.8% 🟢)0.381s141.45x
💻 LocalNitro1.856s (-39.4% 🟢)2.222s (-42.8% 🟢)0.366s141.52x
💻 LocalNext.js (Turbopack)2.011s2.591s0.579s121.64x
🌐 RedisNext.js (Turbopack)2.353s3.008s0.655s101.92x
🌐 MongoDBNext.js (Turbopack)3.583s4.010s0.428s82.93x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.537s (+9.4% 🔺)5.179s (+2.0%)1.642s61.00x
▲ VercelExpress3.550s (+11.2% 🔺)5.397s (+12.6% 🔺)1.847s61.00x
▲ VercelNext.js (Turbopack)5.661s (+80.1% 🔺)6.980s (+54.4% 🔺)1.319s51.60x

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

Promise.race with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.375s (-60.5% 🟢)2.008s (-49.9% 🟢)0.633s151.00x
🐘 PostgresNext.js (Turbopack)1.637s2.075s0.438s151.19x
🐘 PostgresExpress2.311s (-34.0% 🟢)3.176s (-20.8% 🟢)0.865s101.68x
🌐 RedisNext.js (Turbopack)3.594s4.010s0.416s82.61x
💻 LocalExpress4.730s (-46.3% 🟢)5.346s (-42.3% 🟢)0.616s63.44x
💻 LocalNitro5.397s (-41.0% 🟢)6.014s (-40.0% 🟢)0.617s53.92x
💻 LocalNext.js (Turbopack)5.562s6.014s0.453s54.04x
🌐 MongoDBNext.js (Turbopack)6.355s7.014s0.659s54.62x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro4.714s (-7.4% 🟢)6.592s (-3.3%)1.878s51.00x
▲ VercelNext.js (Turbopack)5.926s (-12.3% 🟢)8.154s (-4.6%)2.228s41.26x
▲ VercelExpress6.059s (-5.6% 🟢)8.015s (-2.0%)1.956s41.29x

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

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.437s (-46.7% 🟢)1.007s (~)0.569s601.00x
💻 LocalNitro0.459s (-53.2% 🟢)1.004s (-8.2% 🟢)0.544s601.05x
💻 LocalExpress0.567s (-42.4% 🟢)1.040s (-3.4%)0.473s581.30x
🌐 RedisNext.js (Turbopack)0.621s1.004s0.383s601.42x
🐘 PostgresNext.js (Turbopack)0.667s1.006s0.339s601.53x
🌐 MongoDBNext.js (Turbopack)0.730s1.006s0.276s601.67x
💻 LocalNext.js (Turbopack)0.737s1.005s0.268s601.68x
🐘 PostgresExpress0.905s (+7.9% 🔺)1.370s (+33.9% 🔺)0.465s452.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express4.958s (-73.9% 🟢)6.669s (-68.7% 🟢)1.711s91.00x
▲ VercelNitro5.116s (-76.8% 🟢)6.704s (-72.1% 🟢)1.588s101.03x
▲ VercelNext.js (Turbopack)7.017s (-51.6% 🟢)8.729s (-45.7% 🟢)1.711s71.42x

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

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.022s (-47.0% 🟢)1.585s (-24.5% 🟢)0.564s571.00x
💻 LocalNitro1.161s (-61.7% 🟢)2.005s (-46.6% 🟢)0.844s451.14x
💻 LocalExpress1.307s (-56.7% 🟢)2.006s (-44.0% 🟢)0.700s451.28x
🌐 RedisNext.js (Turbopack)1.492s2.006s0.514s451.46x
🐘 PostgresNext.js (Turbopack)1.604s2.008s0.404s451.57x
💻 LocalNext.js (Turbopack)1.792s2.006s0.214s451.75x
🌐 MongoDBNext.js (Turbopack)1.842s2.007s0.166s451.80x
🐘 PostgresExpress2.094s (+5.9% 🔺)2.560s (+13.4% 🔺)0.467s362.05x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro12.742s (-67.7% 🟢)14.987s (-63.7% 🟢)2.246s71.00x
▲ VercelExpress13.193s (-61.8% 🟢)14.863s (-59.6% 🟢)1.670s71.04x
▲ VercelNext.js (Turbopack)14.895s (-70.1% 🟢)16.716s (-67.7% 🟢)1.822s61.17x

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

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro2.012s (-51.0% 🟢)2.427s (-47.3% 🟢)0.416s501.00x
💻 LocalNitro2.667s (-71.3% 🟢)3.033s (-69.7% 🟢)0.366s401.33x
💻 LocalExpress2.912s (-68.4% 🟢)3.252s (-67.5% 🟢)0.340s371.45x
🌐 RedisNext.js (Turbopack)2.984s3.250s0.267s371.48x
🐘 PostgresNext.js (Turbopack)3.270s4.045s0.775s301.63x
💻 LocalNext.js (Turbopack)3.857s4.075s0.217s301.92x
🐘 PostgresExpress4.078s (+2.2%)4.502s (+3.0%)0.424s272.03x
🌐 MongoDBNext.js (Turbopack)4.220s5.012s0.792s242.10x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro38.819s (-59.9% 🟢)40.985s (-58.4% 🟢)2.166s31.00x
▲ VercelExpress39.658s (-69.5% 🟢)41.705s (-68.4% 🟢)2.048s31.02x
▲ VercelNext.js (Turbopack)46.146s (-56.9% 🟢)47.530s (-56.4% 🟢)1.383s31.19x

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

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.182s (-35.9% 🟢)1.006s (~)0.824s601.00x
🌐 RedisNext.js (Turbopack)0.237s1.004s0.767s601.30x
🐘 PostgresNext.js (Turbopack)0.241s1.006s0.765s601.33x
💻 LocalNitro0.447s (-26.1% 🟢)1.004s (-1.7%)0.557s602.46x
💻 LocalExpress0.478s (-14.7% 🟢)1.005s (~)0.527s602.63x
🐘 PostgresExpress0.511s (+80.8% 🔺)1.148s (+14.0% 🔺)0.637s532.81x
💻 LocalNext.js (Turbopack)0.581s1.005s0.423s603.20x
🌐 MongoDBNext.js (Turbopack)1.036s1.855s0.819s335.70x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.028s (+3.8%)3.796s (+4.4%)1.768s161.00x
▲ VercelNitro2.293s (+38.0% 🔺)4.077s (+21.7% 🔺)1.785s151.13x
▲ VercelNext.js (Turbopack)3.973s (+96.4% 🔺)5.530s (+45.8% 🔺)1.557s111.96x

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

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.310s (-37.4% 🟢)1.006s (~)0.696s901.00x
🌐 RedisNext.js (Turbopack)0.407s1.004s0.597s901.31x
🐘 PostgresNext.js (Turbopack)0.482s1.007s0.524s901.55x
🐘 PostgresExpress0.818s (+60.4% 🔺)1.341s (+33.3% 🔺)0.523s682.63x
💻 LocalExpress2.184s (-13.1% 🟢)3.010s (~)0.825s307.04x
💻 LocalNitro2.198s (-13.4% 🟢)2.944s (-2.2%)0.746s317.08x
🌐 MongoDBNext.js (Turbopack)2.606s3.007s0.400s308.39x
💻 LocalNext.js (Turbopack)2.614s3.149s0.535s298.42x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Next.js (Turbopack)6.797s (+92.3% 🔺)8.510s (+63.9% 🔺)1.713s111.00x
▲ VercelNitro7.928s (+145.8% 🔺)9.974s (+106.8% 🔺)2.046s101.17x
▲ VercelExpress8.062s (+164.6% 🔺)9.804s (+103.9% 🔺)1.742s101.19x

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

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.662s (-16.3% 🟢)1.006s (~)0.344s1201.00x
🌐 RedisNext.js (Turbopack)0.751s1.012s0.261s1191.14x
🐘 PostgresNext.js (Turbopack)0.981s1.521s0.539s801.48x
🐘 PostgresExpress1.706s (+108.3% 🔺)2.295s (+125.6% 🔺)0.589s532.58x
🌐 MongoDBNext.js (Turbopack)5.391s6.014s0.623s208.14x
💻 LocalNitro9.825s (-12.2% 🟢)10.446s (-10.4% 🟢)0.621s1214.85x
💻 LocalExpress10.179s (-9.0% 🟢)10.783s (-9.7% 🟢)0.604s1215.38x
💻 LocalNext.js (Turbopack)11.645s12.330s0.685s1017.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express18.117s (+144.2% 🔺)20.127s (+117.7% 🔺)2.009s61.00x
▲ VercelNext.js (Turbopack)19.231s (+86.2% 🔺)21.009s (+71.0% 🔺)1.778s71.06x
▲ VercelNitro23.043s (+198.4% 🔺)25.291s (+169.0% 🔺)2.248s51.27x

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

Stream Benchmarks(includes TTFB metrics)
workflow with stream

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.129s (+428.1% 🔺)2.005s (+99.6% 🔺)0.011s (-14.4% 🟢)2.018s (+98.0% 🔺)0.889s101.00x
🐘 PostgresNitro1.138s (+455.3% 🔺)2.001s (+100.2% 🔺)0.001s (-13.3% 🟢)2.010s (+98.7% 🔺)0.871s101.01x
💻 LocalExpress1.143s (+474.3% 🔺)2.006s (+99.7% 🔺)0.010s (-15.7% 🟢)2.019s (+98.3% 🔺)0.875s101.01x
💻 LocalNext.js (Turbopack)1.190s2.003s0.013s2.020s0.830s101.05x
🐘 PostgresNext.js (Turbopack)1.195s2.001s0.002s2.011s0.815s101.06x
🐘 PostgresExpress1.514s (+638.4% 🔺)2.094s (+109.7% 🔺)0.378s (+23500.0% 🔺)2.508s (+148.0% 🔺)0.994s101.34x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.104s (-16.0% 🟢)3.360s (-17.8% 🟢)1.769s (+84.1% 🔺)5.626s (+0.6%)3.521s101.00x
▲ VercelNitro2.336s (-39.0% 🟢)3.612s (-31.6% 🟢)1.861s (+150.7% 🔺)6.014s (-7.2% 🟢)3.678s101.11x
▲ VercelNext.js (Turbopack)5.134s (-25.1% 🟢)5.213s (-39.7% 🟢)1.098s (+73.8% 🔺)7.870s (-19.6% 🟢)2.735s102.44x

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

stream pipeline with 5 transform steps (1MB)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.538s (+146.5% 🔺)2.001s (+98.8% 🔺)0.004s (-12.1% 🟢)2.025s (+98.0% 🔺)0.487s301.00x
💻 LocalExpress1.588s (+109.7% 🔺)2.011s (+95.5% 🔺)0.012s (+25.7% 🔺)2.026s (+94.8% 🔺)0.438s301.03x
🐘 PostgresNext.js (Turbopack)1.705s2.010s0.004s2.026s0.321s301.11x
💻 LocalNext.js (Turbopack)1.866s2.011s0.010s2.203s0.337s281.21x
💻 LocalNitro2.164s (+158.1% 🔺)2.010s (+98.6% 🔺)0.009s (-4.0%)2.675s (+139.7% 🔺)0.510s231.41x
🐘 PostgresExpress2.444s (+288.0% 🔺)2.731s (+171.4% 🔺)0.003s (-19.3% 🟢)2.767s (+170.4% 🔺)0.322s221.59x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express5.877s (-9.6% 🟢)7.234s (-9.7% 🟢)0.232s (-43.4% 🟢)7.955s (-10.0% 🟢)2.078s81.00x
▲ VercelNitro5.894s (-80.0% 🟢)7.169s (-76.7% 🟢)0.258s (+130.4% 🔺)7.895s (-75.2% 🟢)2.001s81.00x
▲ VercelNext.js (Turbopack)13.642s (-19.4% 🟢)13.146s (-27.9% 🟢)0.318s (+50.3% 🔺)15.510s (-18.1% 🟢)1.868s42.32x

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

10 parallel streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.694s (-28.3% 🟢)1.030s (-17.5% 🟢)0.000s (-57.9% 🟢)1.060s (-15.7% 🟢)0.366s571.00x
🐘 PostgresNext.js (Turbopack)0.798s1.072s0.000s1.082s0.284s561.15x
💻 LocalNext.js (Turbopack)1.451s2.014s0.000s2.017s0.566s302.09x
💻 LocalExpress1.475s (+20.4% 🔺)2.015s (~)0.000s (~)2.018s (~)0.543s302.12x
💻 LocalNitro1.486s (+21.5% 🔺)2.014s (~)0.000s (+364.3% 🔺)2.195s (+8.6% 🔺)0.709s282.14x
🐘 PostgresExpress2.079s (+116.4% 🔺)2.453s (+92.0% 🔺)0.000s (-100.0% 🟢)2.522s (+93.1% 🔺)0.443s242.99x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express3.871s (+3.5%)5.345s (+4.7%)0.003s (+1500.0% 🔺)5.771s (+4.4%)1.900s111.00x
▲ VercelNitro3.911s (+28.2% 🔺)5.386s (+22.6% 🔺)0.000s (+254.5% 🔺)5.924s (+23.2% 🔺)2.013s111.01x
▲ VercelNext.js (Turbopack)6.210s (-39.0% 🟢)6.441s (-44.1% 🟢)0.001s (+Infinity% 🔺)7.762s (-35.6% 🟢)1.552s81.60x

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

fan-out fan-in 10 streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.461s (-18.5% 🟢)2.141s (~)0.000s (~)2.154s (-1.0%)0.693s281.00x
🐘 PostgresNext.js (Turbopack)1.801s2.348s0.000s2.356s0.554s261.23x
💻 LocalNext.js (Turbopack)2.779s3.293s0.001s3.298s0.519s191.90x
💻 LocalNitro2.995s (-11.6% 🟢)3.735s (-7.4% 🟢)0.000s (-89.0% 🟢)3.737s (-7.4% 🟢)0.743s172.05x
💻 LocalExpress3.279s (-5.4% 🟢)3.840s (-4.8%)0.001s (-21.9% 🟢)3.847s (-4.7%)0.568s162.24x
🐘 PostgresExpress3.897s (+119.9% 🔺)4.233s (+94.4% 🔺)0.000s (+Infinity% 🔺)4.354s (+98.0% 🔺)0.458s142.67x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.840s (+42.7% 🔺)7.408s (+37.8% 🔺)0.000s (-8.3% 🟢)7.847s (+35.4% 🔺)2.007s81.00x
▲ VercelExpress5.876s (+28.1% 🔺)7.054s (+17.1% 🔺)0.001s (+Infinity% 🔺)7.514s (+16.4% 🔺)1.638s81.01x
▲ VercelNext.js (Turbopack)8.242s (+46.7% 🔺)9.359s (+34.0% 🔺)0.000s (+33.3% 🔺)10.005s (+32.7% 🔺)1.763s61.41x

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

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World🥇 Fastest FrameworkWins
💻 LocalNitro13/21
🐘 PostgresNitro21/21
▲ VercelNitro12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework🥇 Fastest WorldWins
Express💻 Local15/21
Next.js (Turbopack)🌐 Redis11/21
Nitro🐘 Postgres15/21
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


⚠️Community world benchmarks failed (non-blocking):

  • Community Worlds: failure

Check the workflow run for details.

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

PassedFailedSkippedTotal
✅ ▲ Vercel Production120002191419
✅ 💻 Local Development158702191806
✅ 📦 Local Production158702191806
✅ 🐘 Local Postgres158702191806
✅ 🪟 Windows12900129
✅ 📋 Other7270176903
Total6817010527869

Details by Category

✅ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro103026
✅ example103026
✅ express103026
✅ fastify103026
✅ hono103026
✅ nextjs-turbopack12702
✅ nextjs-webpack12702
✅ nitro103026
✅ nuxt103026
✅ sveltekit12207
✅ vite103026
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🪟 Windows
AppPassedFailedSkipped
✅ nextjs-turbopack12900
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable104025
✅ e2e-local-dev-tanstack-start-104025
✅ e2e-local-postgres-nest-stable104025
✅ e2e-local-postgres-tanstack-start-104025
✅ e2e-local-prod-nest-stable104025
✅ e2e-local-prod-tanstack-start-104025
✅ e2e-vercel-prod-tanstack-start103026

📋 View full workflow run

@karthikscale3
karthikscale3force-pushed the karthik/fix-doc-switcher branch from 42d3fd0 to 4f0c239CompareMay 6, 2026 04:47
## Content restructuring
- Split `docs/content/docs/` into `docs/content/docs/v4/` and
`docs/content/docs/v5/` so each version is a fully independent
content tree with no shared-file coupling
- v4 excludes the four pages that are v5-only (AbortController
cancellation docs and the serializable-abort-controller internal page)
- v5 retains all pages; `preRelease` frontmatter field removed (no
longer needed now that each version is its own folder)
- Removed `AbortController` / `AbortSignal` from v4 serialization page
(section moved to v5 only)
## Fumadocs source
- Added `v4docs` and `v5docs` as separate `defineDocs()` collections in
`source.config.ts`; shared `docsSchema` (no more `preRelease` field)
- `source.ts` exports both `source` (v4, `baseUrl: /docs`) and
`v5Source` (v5, same base URL)
## Version routing
- `version-source.ts` simplified: `filterPreReleaseFromNodes` and
`isPreReleaseUrl` logic removed; v4 tree uses `source`, v5 tree uses
`v5Source` + `rewriteNodeUrls`
- v4 `page.tsx`: removed `preRelease` guard (v4Source has no such pages)
- v5 `page.tsx`: uses `v5Source` for `getPage` / `generateStaticParams`
/ `generateMetadata`; `v5Link` wrapper rewrites `/docs/…` hrefs to
`/v5/docs/…` so inline MDX links stay in the v5 context
## Versioned cookbook
- Added `app/[lang]/v5/cookbook/` layout + page (mirrors v4 but uses
`v5Source`, `rewriteCookbookUrlForVersion`, and `V5CookbookLink`)
- `getCookbookTree` accepts a `versionPrefix` parameter; sidebar URLs
are prefixed accordingly (`/v5/cookbook/…`)
- `cookbook-tree.ts`: added `skipVersions?: string[]` per-recipe field
for version-specific exclusions; `distributed-abort-controller` is
marked `skipVersions: ['v5']`
## Version switcher — state & navigation
- New `VersionProvider` context (`hooks/geistdocs/use-version.tsx`)
backed by `localStorage`: URL is source of truth on versioned pages,
`localStorage` carries the preference across non-versioned pages
(cookbook overview, worlds, etc.)
- `VersionSwitcher` uses `useVersion()` context instead of URL-only
detection; now visible on all pages including cookbook
- `DesktopMenu` and `MobileMenu` use `activeVersion` from context so
the "Docs" and "Cookbook" navbar links resolve to the correct version
prefix on every page
- `buildVersionUrl` expanded to handle `/cookbook/…` paths alongside
`/docs/…`; non-versioned routes (worlds, api) return unchanged
- `switchVersion` does a `HEAD` probe before navigating; falls back to
the versioned cookbook or docs home if the target page doesn't exist
in that version (handles v4-only → v5 and v5-only → v4 cases)
## Cookbook content (v5)
- Rewrote `agent-cancellation` recipe using a single `AbortController`
pattern; removed Hard Cancellation vs Stop Signal two-approach
comparison
- Deleted `distributed-abort-controller` recipe from v5 (native
`AbortController` serialization makes it unnecessary)
- Removed references to distributed-abort-controller from
`cookbook/index.mdx` and `common-patterns/timeouts.mdx`
Co-authored-by: Cursor <cursoragent@cursor.com>
Content moved from docs/content/docs/ to docs/content/docs/v5/ on main
(pre-release channel). Stable branch will use v4/ after backport.
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@karthikscale3@pranaygp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' docs: split v4/v5 content trees and fix version switcher end-to-end by karthikscale3 · Pull Request #1948 · vercel/workflow · GitHub
Skip to content

docs: split v4/v5 content trees and fix version switcher end-to-end - #1948

Merged
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher
May 6, 2026
Merged

docs: split v4/v5 content trees and fix version switcher end-to-end#1948
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher

Conversation

@karthikscale3

Copy link
Copy Markdown
Contributor

Summary

Content restructuring

  • Split docs/content/docs/ into docs/content/docs/v4/ and docs/content/docs/v5/ — each version is now a fully independent content tree with no shared-file coupling or preRelease frontmatter filtering
  • v4 excludes the four v5-only pages (AbortController cancellation docs, abort-signal-timeout error, and serializable-abort-controller internal page)
  • v5 retains all pages; preRelease frontmatter field removed (no longer meaningful with separate folders)
  • Removed AbortController / AbortSignal from the v4 serialization page (moved to v5 only)

Fumadocs source split

  • Added v4docs and v5docs as separate defineDocs() collections in source.config.ts pointing to content/docs/v4 and content/docs/v5
  • source.ts now exports both source (v4) and v5Source (v5), both with baseUrl: /docs

Version routing fixes

  • version-source.ts simplified: removed filterPreReleaseFromNodes / isPreReleaseUrl logic; v4 sidebar uses source, v5 uses v5Source + existing rewriteNodeUrls
  • v4 page.tsx: removed the preRelease guard (v4Source simply doesn't contain those pages)
  • v5 page.tsx: uses v5Source for getPage, generateStaticParams, and generateMetadata; v5Link wrapper rewrites /docs/… hrefs to /v5/docs/… so inline MDX links stay in the v5 context
  • buildVersionUrl now handles /cookbook/… paths with the same version-prefix logic as /docs/…; non-versioned routes (worlds, api) return unchanged

Versioned cookbook

  • Added app/[lang]/v5/cookbook/ layout + page (mirrors v4, uses v5Source and rewriteCookbookUrlForVersion)
  • getCookbookTree accepts a versionPrefix parameter; sidebar URLs are prefixed accordingly (/v5/cookbook/…)
  • cookbook-tree.ts: added skipVersions?: string[] per-recipe field for version-specific exclusions; distributed-abort-controller marked skipVersions: ['v5'] so it shows in v4 but not v5

Version switcher — state & navigation

  • New VersionProvider context (hooks/geistdocs/use-version.tsx) backed by localStorage: URL is the source of truth on versioned pages; localStorage carries the preference across non-versioned pages (worlds, etc.)
  • VersionSwitcher uses useVersion() context; now visible on all pages including cookbook (no longer hidden on non-docs routes)
  • DesktopMenu and MobileMenu read activeVersion from context so "Docs" and "Cookbook" navbar links resolve to the correct version prefix on every page
  • switchVersion does a HEAD probe before navigating; falls back to the versioned cookbook or docs home if the target page doesn't exist in that version — handles both v4-only → v5 (distributed-abort-controller) and v5-only → v4 (cancellation docs) cases

Cookbook content (v5)

  • Rewrote agent-cancellation recipe using a single AbortController + hook pattern; removed the Hard Cancellation vs Stop Signal two-approach comparison and comparison table
  • Deleted distributed-abort-controller recipe from v5 (native AbortController serialization in v5 makes it unnecessary)
  • Removed all references to distributed-abort-controller from cookbook/index.mdx, common-patterns/timeouts.mdx, advanced/meta.json, and the agent-cancellation page

Test plan

  • /docs/… (v4) pages load correctly; v5-only pages (/docs/foundations/cancellation, etc.) return 404
  • /v5/docs/… pages load correctly including the four v5-only pages
  • Version switcher shows correct version on docs, cookbook, and worlds pages
  • Switching v4 → v5 on a docs page navigates to the same page under /v5/docs/…
  • Switching v5 → v4 on a v5-only page falls back to /docs/getting-started
  • Switching versions on /cookbook/… navigates to the same recipe under /v5/cookbook/… (or falls back if not present)
  • Switching v4 → v5 on /cookbook/advanced/distributed-abort-controller falls back to /v5/cookbook
  • Navbar "Docs" and "Cookbook" links resolve to the active version's prefix on all pages
  • Version preference is preserved when navigating from docs → cookbook → back to docs

Made with Cursor

@changeset-bot

changeset-botBot commented May 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b76034f

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

vercelBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

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

workflow with no steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro0.033s (-23.0% 🟢)1.006s (~)0.973s101.00x
💻 LocalExpress0.038s (-14.9% 🟢)1.008s (~)0.970s101.14x
🐘 PostgresNitro0.048s (-49.3% 🟢)1.013s (-2.9%)0.964s101.45x
💻 LocalNext.js (Turbopack)0.051s1.006s0.954s101.55x
🌐 RedisNext.js (Turbopack)0.053s1.005s0.952s101.58x
🐘 PostgresNext.js (Turbopack)0.060s1.013s0.953s101.81x
🌐 MongoDBNext.js (Turbopack)0.099s1.008s0.909s102.98x
🐘 PostgresExpress0.111s (+91.4% 🔺)1.063s (+5.2% 🔺)0.952s103.34x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro0.245s (-40.1% 🟢)2.147s (-14.4% 🟢)1.902s101.00x
▲ VercelExpress0.253s (+7.3% 🔺)2.140s (~)1.887s101.03x
▲ VercelNext.js (Turbopack)0.798s (+217.1% 🔺)2.773s (+18.9% 🔺)1.976s103.25x

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

workflow with 1 step

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.067s (-5.7% 🟢)2.007s (~)0.940s101.00x
💻 LocalExpress1.082s (-3.8%)2.008s (~)0.925s101.01x
🐘 PostgresNitro1.091s (-4.3%)2.009s (~)0.918s101.02x
🌐 RedisNext.js (Turbopack)1.109s2.006s0.898s101.04x
💻 LocalNext.js (Turbopack)1.115s2.006s0.891s101.05x
🐘 PostgresNext.js (Turbopack)1.128s2.009s0.881s101.06x
🐘 PostgresExpress1.130s (-1.4%)2.024s (+0.7%)0.894s101.06x
🌐 MongoDBNext.js (Turbopack)1.168s2.009s0.841s101.09x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express1.579s (-15.8% 🟢)3.777s (-0.8%)2.199s101.00x
▲ VercelNitro1.590s (-59.1% 🟢)3.673s (-37.8% 🟢)2.083s101.01x
▲ VercelNext.js (Turbopack)3.197s (+57.1% 🔺)4.489s (+17.2% 🔺)1.292s102.03x

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

workflow with 10 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro10.427s (-4.7%)11.021s (~)0.594s31.00x
💻 LocalExpress10.465s (-4.2%)11.025s (~)0.559s31.00x
🐘 PostgresNitro10.467s (-3.7%)11.019s (~)0.552s31.00x
🌐 RedisNext.js (Turbopack)10.655s11.023s0.368s31.02x
💻 LocalNext.js (Turbopack)10.666s11.022s0.356s31.02x
🐘 PostgresNext.js (Turbopack)10.756s11.015s0.260s31.03x
🌐 MongoDBNext.js (Turbopack)10.834s11.020s0.186s31.04x
🐘 PostgresExpress10.866s (-0.9%)11.400s (+3.4%)0.534s31.04x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro13.218s (-44.3% 🟢)14.916s (-40.6% 🟢)1.698s31.00x
▲ VercelExpress13.258s (-21.9% 🟢)15.627s (-21.9% 🟢)2.368s21.00x
▲ VercelNext.js (Turbopack)15.143s (-12.6% 🟢)16.855s (-13.1% 🟢)1.712s21.15x

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

workflow with 25 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro13.417s (-10.9% 🟢)14.027s (-12.5% 🟢)0.610s51.00x
🐘 PostgresNitro13.484s (-7.6% 🟢)14.019s (-6.7% 🟢)0.536s51.00x
💻 LocalExpress13.637s (-8.9% 🟢)14.030s (-6.7% 🟢)0.392s51.02x
🌐 RedisNext.js (Turbopack)14.069s14.828s0.759s51.05x
💻 LocalNext.js (Turbopack)14.090s15.031s0.941s41.05x
🌐 MongoDBNext.js (Turbopack)14.228s15.025s0.798s41.06x
🐘 PostgresNext.js (Turbopack)14.238s15.020s0.782s41.06x
🐘 PostgresExpress14.414s (-1.2%)15.017s (~)0.604s41.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro21.299s (-67.0% 🟢)23.458s (-64.8% 🟢)2.159s31.00x
▲ VercelExpress21.953s (-56.4% 🟢)24.119s (-54.1% 🟢)2.166s31.03x
▲ VercelNext.js (Turbopack)22.605s (-57.0% 🟢)24.322s (-55.5% 🟢)1.717s31.06x

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

workflow with 50 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro11.799s (-29.7% 🟢)12.022s (-29.4% 🟢)0.222s81.00x
🐘 PostgresNitro12.001s (-14.1% 🟢)12.392s (-13.4% 🟢)0.390s81.02x
💻 LocalExpress12.214s (-26.4% 🟢)13.027s (-23.5% 🟢)0.813s71.04x
🌐 RedisNext.js (Turbopack)12.955s13.311s0.355s71.10x
💻 LocalNext.js (Turbopack)13.113s14.026s0.913s71.11x
🐘 PostgresNext.js (Turbopack)13.257s14.016s0.759s71.12x
🌐 MongoDBNext.js (Turbopack)13.339s14.025s0.687s71.13x
🐘 PostgresExpress16.095s (+14.9% 🔺)16.539s (+13.3% 🔺)0.444s61.36x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro31.335s (-92.6% 🟢)33.852s (-92.0% 🟢)2.517s31.00x
▲ VercelExpress33.300s (-72.5% 🟢)35.430s (-71.3% 🟢)2.130s31.06x
▲ VercelNext.js (Turbopack)33.643s (-91.5% 🟢)35.813s (-90.9% 🟢)2.170s31.07x

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

Promise.all with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.151s (-9.7% 🟢)2.007s (~)0.856s151.00x
💻 LocalNitro1.170s (-28.3% 🟢)2.005s (-3.3%)0.836s151.02x
💻 LocalExpress1.182s (-20.6% 🟢)2.007s (~)0.825s151.03x
🐘 PostgresNext.js (Turbopack)1.220s2.007s0.786s151.06x
🌐 RedisNext.js (Turbopack)1.244s2.006s0.762s151.08x
💻 LocalNext.js (Turbopack)1.280s2.006s0.726s151.11x
🐘 PostgresExpress1.443s (+14.5% 🔺)2.184s (+8.7% 🔺)0.742s141.25x
🌐 MongoDBNext.js (Turbopack)2.044s2.918s0.874s111.78x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.481s (-13.2% 🟢)4.024s (-13.0% 🟢)1.543s81.00x
▲ VercelNitro2.531s (-10.2% 🟢)4.150s (-4.0%)1.619s81.02x
▲ VercelNext.js (Turbopack)3.892s (+14.6% 🔺)5.639s (+14.3% 🔺)1.747s61.57x

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

Promise.all with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.224s (-48.0% 🟢)2.007s (-33.3% 🟢)0.783s151.00x
🐘 PostgresNext.js (Turbopack)1.384s2.007s0.623s151.13x
💻 LocalExpress1.642s (-44.4% 🟢)2.007s (-41.9% 🟢)0.364s151.34x
🐘 PostgresExpress1.690s (-28.4% 🟢)2.263s (-24.8% 🟢)0.573s141.38x
💻 LocalNitro1.693s (-46.1% 🟢)2.005s (-48.4% 🟢)0.312s151.38x
💻 LocalNext.js (Turbopack)1.848s2.073s0.226s151.51x
🌐 RedisNext.js (Turbopack)2.359s3.008s0.649s101.93x
🌐 MongoDBNext.js (Turbopack)3.611s4.009s0.398s82.95x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.862s (-4.7%)5.659s (-4.4%)1.797s61.00x
▲ VercelExpress4.351s (+20.2% 🔺)5.741s (+12.3% 🔺)1.391s61.13x
▲ VercelNext.js (Turbopack)5.397s (-24.0% 🟢)7.101s (-20.3% 🟢)1.704s51.40x

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

Promise.all with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.372s (-60.6% 🟢)2.008s (-49.9% 🟢)0.636s151.00x
🐘 PostgresNext.js (Turbopack)1.764s2.074s0.310s151.29x
🐘 PostgresExpress2.273s (-34.8% 🟢)3.078s (-23.3% 🟢)0.805s101.66x
🌐 RedisNext.js (Turbopack)3.639s4.010s0.370s82.65x
💻 LocalNitro4.502s (-46.1% 🟢)5.011s (-44.4% 🟢)0.510s63.28x
💻 LocalExpress4.545s (-45.5% 🟢)5.014s (-44.5% 🟢)0.469s73.31x
💻 LocalNext.js (Turbopack)5.644s6.215s0.571s54.11x
🌐 MongoDBNext.js (Turbopack)6.310s7.015s0.705s54.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.332s (+51.2% 🔺)6.946s (+25.5% 🔺)1.614s51.00x
▲ VercelNext.js (Turbopack)6.496s (-27.1% 🟢)8.168s (-25.5% 🟢)1.672s41.22x
▲ VercelExpress7.267s (+71.4% 🔺)9.101s (+48.5% 🔺)1.834s41.36x

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

Promise.race with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.149s (-8.6% 🟢)2.007s (~)0.858s151.00x
🌐 RedisNext.js (Turbopack)1.228s2.006s0.778s151.07x
🐘 PostgresNext.js (Turbopack)1.246s2.008s0.762s151.08x
💻 LocalNext.js (Turbopack)1.328s2.006s0.678s151.16x
💻 LocalNitro1.387s (-25.7% 🟢)2.006s (-14.3% 🟢)0.619s151.21x
🐘 PostgresExpress1.481s (+17.8% 🔺)2.163s (+7.7% 🔺)0.682s141.29x
💻 LocalExpress1.482s (-21.7% 🟢)2.007s (-15.1% 🟢)0.525s151.29x
🌐 MongoDBNext.js (Turbopack)2.031s2.827s0.796s111.77x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro2.354s (-4.2%)3.765s (-9.7% 🟢)1.411s81.00x
▲ VercelExpress2.501s (-3.1%)3.783s (-13.0% 🟢)1.283s81.06x
▲ VercelNext.js (Turbopack)3.502s (+19.5% 🔺)5.206s (+12.1% 🔺)1.704s71.49x

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

Promise.race with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.223s (-47.7% 🟢)2.009s (-33.3% 🟢)0.785s151.00x
🐘 PostgresNext.js (Turbopack)1.405s2.008s0.603s151.15x
🐘 PostgresExpress1.673s (-28.6% 🟢)2.326s (-22.8% 🟢)0.653s131.37x
💻 LocalExpress1.769s (-43.5% 🟢)2.151s (-42.8% 🟢)0.381s141.45x
💻 LocalNitro1.856s (-39.4% 🟢)2.222s (-42.8% 🟢)0.366s141.52x
💻 LocalNext.js (Turbopack)2.011s2.591s0.579s121.64x
🌐 RedisNext.js (Turbopack)2.353s3.008s0.655s101.92x
🌐 MongoDBNext.js (Turbopack)3.583s4.010s0.428s82.93x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.537s (+9.4% 🔺)5.179s (+2.0%)1.642s61.00x
▲ VercelExpress3.550s (+11.2% 🔺)5.397s (+12.6% 🔺)1.847s61.00x
▲ VercelNext.js (Turbopack)5.661s (+80.1% 🔺)6.980s (+54.4% 🔺)1.319s51.60x

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

Promise.race with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.375s (-60.5% 🟢)2.008s (-49.9% 🟢)0.633s151.00x
🐘 PostgresNext.js (Turbopack)1.637s2.075s0.438s151.19x
🐘 PostgresExpress2.311s (-34.0% 🟢)3.176s (-20.8% 🟢)0.865s101.68x
🌐 RedisNext.js (Turbopack)3.594s4.010s0.416s82.61x
💻 LocalExpress4.730s (-46.3% 🟢)5.346s (-42.3% 🟢)0.616s63.44x
💻 LocalNitro5.397s (-41.0% 🟢)6.014s (-40.0% 🟢)0.617s53.92x
💻 LocalNext.js (Turbopack)5.562s6.014s0.453s54.04x
🌐 MongoDBNext.js (Turbopack)6.355s7.014s0.659s54.62x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro4.714s (-7.4% 🟢)6.592s (-3.3%)1.878s51.00x
▲ VercelNext.js (Turbopack)5.926s (-12.3% 🟢)8.154s (-4.6%)2.228s41.26x
▲ VercelExpress6.059s (-5.6% 🟢)8.015s (-2.0%)1.956s41.29x

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

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.437s (-46.7% 🟢)1.007s (~)0.569s601.00x
💻 LocalNitro0.459s (-53.2% 🟢)1.004s (-8.2% 🟢)0.544s601.05x
💻 LocalExpress0.567s (-42.4% 🟢)1.040s (-3.4%)0.473s581.30x
🌐 RedisNext.js (Turbopack)0.621s1.004s0.383s601.42x
🐘 PostgresNext.js (Turbopack)0.667s1.006s0.339s601.53x
🌐 MongoDBNext.js (Turbopack)0.730s1.006s0.276s601.67x
💻 LocalNext.js (Turbopack)0.737s1.005s0.268s601.68x
🐘 PostgresExpress0.905s (+7.9% 🔺)1.370s (+33.9% 🔺)0.465s452.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express4.958s (-73.9% 🟢)6.669s (-68.7% 🟢)1.711s91.00x
▲ VercelNitro5.116s (-76.8% 🟢)6.704s (-72.1% 🟢)1.588s101.03x
▲ VercelNext.js (Turbopack)7.017s (-51.6% 🟢)8.729s (-45.7% 🟢)1.711s71.42x

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

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.022s (-47.0% 🟢)1.585s (-24.5% 🟢)0.564s571.00x
💻 LocalNitro1.161s (-61.7% 🟢)2.005s (-46.6% 🟢)0.844s451.14x
💻 LocalExpress1.307s (-56.7% 🟢)2.006s (-44.0% 🟢)0.700s451.28x
🌐 RedisNext.js (Turbopack)1.492s2.006s0.514s451.46x
🐘 PostgresNext.js (Turbopack)1.604s2.008s0.404s451.57x
💻 LocalNext.js (Turbopack)1.792s2.006s0.214s451.75x
🌐 MongoDBNext.js (Turbopack)1.842s2.007s0.166s451.80x
🐘 PostgresExpress2.094s (+5.9% 🔺)2.560s (+13.4% 🔺)0.467s362.05x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro12.742s (-67.7% 🟢)14.987s (-63.7% 🟢)2.246s71.00x
▲ VercelExpress13.193s (-61.8% 🟢)14.863s (-59.6% 🟢)1.670s71.04x
▲ VercelNext.js (Turbopack)14.895s (-70.1% 🟢)16.716s (-67.7% 🟢)1.822s61.17x

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

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro2.012s (-51.0% 🟢)2.427s (-47.3% 🟢)0.416s501.00x
💻 LocalNitro2.667s (-71.3% 🟢)3.033s (-69.7% 🟢)0.366s401.33x
💻 LocalExpress2.912s (-68.4% 🟢)3.252s (-67.5% 🟢)0.340s371.45x
🌐 RedisNext.js (Turbopack)2.984s3.250s0.267s371.48x
🐘 PostgresNext.js (Turbopack)3.270s4.045s0.775s301.63x
💻 LocalNext.js (Turbopack)3.857s4.075s0.217s301.92x
🐘 PostgresExpress4.078s (+2.2%)4.502s (+3.0%)0.424s272.03x
🌐 MongoDBNext.js (Turbopack)4.220s5.012s0.792s242.10x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro38.819s (-59.9% 🟢)40.985s (-58.4% 🟢)2.166s31.00x
▲ VercelExpress39.658s (-69.5% 🟢)41.705s (-68.4% 🟢)2.048s31.02x
▲ VercelNext.js (Turbopack)46.146s (-56.9% 🟢)47.530s (-56.4% 🟢)1.383s31.19x

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

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.182s (-35.9% 🟢)1.006s (~)0.824s601.00x
🌐 RedisNext.js (Turbopack)0.237s1.004s0.767s601.30x
🐘 PostgresNext.js (Turbopack)0.241s1.006s0.765s601.33x
💻 LocalNitro0.447s (-26.1% 🟢)1.004s (-1.7%)0.557s602.46x
💻 LocalExpress0.478s (-14.7% 🟢)1.005s (~)0.527s602.63x
🐘 PostgresExpress0.511s (+80.8% 🔺)1.148s (+14.0% 🔺)0.637s532.81x
💻 LocalNext.js (Turbopack)0.581s1.005s0.423s603.20x
🌐 MongoDBNext.js (Turbopack)1.036s1.855s0.819s335.70x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.028s (+3.8%)3.796s (+4.4%)1.768s161.00x
▲ VercelNitro2.293s (+38.0% 🔺)4.077s (+21.7% 🔺)1.785s151.13x
▲ VercelNext.js (Turbopack)3.973s (+96.4% 🔺)5.530s (+45.8% 🔺)1.557s111.96x

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

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.310s (-37.4% 🟢)1.006s (~)0.696s901.00x
🌐 RedisNext.js (Turbopack)0.407s1.004s0.597s901.31x
🐘 PostgresNext.js (Turbopack)0.482s1.007s0.524s901.55x
🐘 PostgresExpress0.818s (+60.4% 🔺)1.341s (+33.3% 🔺)0.523s682.63x
💻 LocalExpress2.184s (-13.1% 🟢)3.010s (~)0.825s307.04x
💻 LocalNitro2.198s (-13.4% 🟢)2.944s (-2.2%)0.746s317.08x
🌐 MongoDBNext.js (Turbopack)2.606s3.007s0.400s308.39x
💻 LocalNext.js (Turbopack)2.614s3.149s0.535s298.42x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Next.js (Turbopack)6.797s (+92.3% 🔺)8.510s (+63.9% 🔺)1.713s111.00x
▲ VercelNitro7.928s (+145.8% 🔺)9.974s (+106.8% 🔺)2.046s101.17x
▲ VercelExpress8.062s (+164.6% 🔺)9.804s (+103.9% 🔺)1.742s101.19x

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

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.662s (-16.3% 🟢)1.006s (~)0.344s1201.00x
🌐 RedisNext.js (Turbopack)0.751s1.012s0.261s1191.14x
🐘 PostgresNext.js (Turbopack)0.981s1.521s0.539s801.48x
🐘 PostgresExpress1.706s (+108.3% 🔺)2.295s (+125.6% 🔺)0.589s532.58x
🌐 MongoDBNext.js (Turbopack)5.391s6.014s0.623s208.14x
💻 LocalNitro9.825s (-12.2% 🟢)10.446s (-10.4% 🟢)0.621s1214.85x
💻 LocalExpress10.179s (-9.0% 🟢)10.783s (-9.7% 🟢)0.604s1215.38x
💻 LocalNext.js (Turbopack)11.645s12.330s0.685s1017.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express18.117s (+144.2% 🔺)20.127s (+117.7% 🔺)2.009s61.00x
▲ VercelNext.js (Turbopack)19.231s (+86.2% 🔺)21.009s (+71.0% 🔺)1.778s71.06x
▲ VercelNitro23.043s (+198.4% 🔺)25.291s (+169.0% 🔺)2.248s51.27x

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

Stream Benchmarks(includes TTFB metrics)
workflow with stream

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.129s (+428.1% 🔺)2.005s (+99.6% 🔺)0.011s (-14.4% 🟢)2.018s (+98.0% 🔺)0.889s101.00x
🐘 PostgresNitro1.138s (+455.3% 🔺)2.001s (+100.2% 🔺)0.001s (-13.3% 🟢)2.010s (+98.7% 🔺)0.871s101.01x
💻 LocalExpress1.143s (+474.3% 🔺)2.006s (+99.7% 🔺)0.010s (-15.7% 🟢)2.019s (+98.3% 🔺)0.875s101.01x
💻 LocalNext.js (Turbopack)1.190s2.003s0.013s2.020s0.830s101.05x
🐘 PostgresNext.js (Turbopack)1.195s2.001s0.002s2.011s0.815s101.06x
🐘 PostgresExpress1.514s (+638.4% 🔺)2.094s (+109.7% 🔺)0.378s (+23500.0% 🔺)2.508s (+148.0% 🔺)0.994s101.34x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.104s (-16.0% 🟢)3.360s (-17.8% 🟢)1.769s (+84.1% 🔺)5.626s (+0.6%)3.521s101.00x
▲ VercelNitro2.336s (-39.0% 🟢)3.612s (-31.6% 🟢)1.861s (+150.7% 🔺)6.014s (-7.2% 🟢)3.678s101.11x
▲ VercelNext.js (Turbopack)5.134s (-25.1% 🟢)5.213s (-39.7% 🟢)1.098s (+73.8% 🔺)7.870s (-19.6% 🟢)2.735s102.44x

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

stream pipeline with 5 transform steps (1MB)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.538s (+146.5% 🔺)2.001s (+98.8% 🔺)0.004s (-12.1% 🟢)2.025s (+98.0% 🔺)0.487s301.00x
💻 LocalExpress1.588s (+109.7% 🔺)2.011s (+95.5% 🔺)0.012s (+25.7% 🔺)2.026s (+94.8% 🔺)0.438s301.03x
🐘 PostgresNext.js (Turbopack)1.705s2.010s0.004s2.026s0.321s301.11x
💻 LocalNext.js (Turbopack)1.866s2.011s0.010s2.203s0.337s281.21x
💻 LocalNitro2.164s (+158.1% 🔺)2.010s (+98.6% 🔺)0.009s (-4.0%)2.675s (+139.7% 🔺)0.510s231.41x
🐘 PostgresExpress2.444s (+288.0% 🔺)2.731s (+171.4% 🔺)0.003s (-19.3% 🟢)2.767s (+170.4% 🔺)0.322s221.59x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express5.877s (-9.6% 🟢)7.234s (-9.7% 🟢)0.232s (-43.4% 🟢)7.955s (-10.0% 🟢)2.078s81.00x
▲ VercelNitro5.894s (-80.0% 🟢)7.169s (-76.7% 🟢)0.258s (+130.4% 🔺)7.895s (-75.2% 🟢)2.001s81.00x
▲ VercelNext.js (Turbopack)13.642s (-19.4% 🟢)13.146s (-27.9% 🟢)0.318s (+50.3% 🔺)15.510s (-18.1% 🟢)1.868s42.32x

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

10 parallel streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.694s (-28.3% 🟢)1.030s (-17.5% 🟢)0.000s (-57.9% 🟢)1.060s (-15.7% 🟢)0.366s571.00x
🐘 PostgresNext.js (Turbopack)0.798s1.072s0.000s1.082s0.284s561.15x
💻 LocalNext.js (Turbopack)1.451s2.014s0.000s2.017s0.566s302.09x
💻 LocalExpress1.475s (+20.4% 🔺)2.015s (~)0.000s (~)2.018s (~)0.543s302.12x
💻 LocalNitro1.486s (+21.5% 🔺)2.014s (~)0.000s (+364.3% 🔺)2.195s (+8.6% 🔺)0.709s282.14x
🐘 PostgresExpress2.079s (+116.4% 🔺)2.453s (+92.0% 🔺)0.000s (-100.0% 🟢)2.522s (+93.1% 🔺)0.443s242.99x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express3.871s (+3.5%)5.345s (+4.7%)0.003s (+1500.0% 🔺)5.771s (+4.4%)1.900s111.00x
▲ VercelNitro3.911s (+28.2% 🔺)5.386s (+22.6% 🔺)0.000s (+254.5% 🔺)5.924s (+23.2% 🔺)2.013s111.01x
▲ VercelNext.js (Turbopack)6.210s (-39.0% 🟢)6.441s (-44.1% 🟢)0.001s (+Infinity% 🔺)7.762s (-35.6% 🟢)1.552s81.60x

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

fan-out fan-in 10 streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.461s (-18.5% 🟢)2.141s (~)0.000s (~)2.154s (-1.0%)0.693s281.00x
🐘 PostgresNext.js (Turbopack)1.801s2.348s0.000s2.356s0.554s261.23x
💻 LocalNext.js (Turbopack)2.779s3.293s0.001s3.298s0.519s191.90x
💻 LocalNitro2.995s (-11.6% 🟢)3.735s (-7.4% 🟢)0.000s (-89.0% 🟢)3.737s (-7.4% 🟢)0.743s172.05x
💻 LocalExpress3.279s (-5.4% 🟢)3.840s (-4.8%)0.001s (-21.9% 🟢)3.847s (-4.7%)0.568s162.24x
🐘 PostgresExpress3.897s (+119.9% 🔺)4.233s (+94.4% 🔺)0.000s (+Infinity% 🔺)4.354s (+98.0% 🔺)0.458s142.67x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.840s (+42.7% 🔺)7.408s (+37.8% 🔺)0.000s (-8.3% 🟢)7.847s (+35.4% 🔺)2.007s81.00x
▲ VercelExpress5.876s (+28.1% 🔺)7.054s (+17.1% 🔺)0.001s (+Infinity% 🔺)7.514s (+16.4% 🔺)1.638s81.01x
▲ VercelNext.js (Turbopack)8.242s (+46.7% 🔺)9.359s (+34.0% 🔺)0.000s (+33.3% 🔺)10.005s (+32.7% 🔺)1.763s61.41x

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

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World🥇 Fastest FrameworkWins
💻 LocalNitro13/21
🐘 PostgresNitro21/21
▲ VercelNitro12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework🥇 Fastest WorldWins
Express💻 Local15/21
Next.js (Turbopack)🌐 Redis11/21
Nitro🐘 Postgres15/21
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


⚠️Community world benchmarks failed (non-blocking):

  • Community Worlds: failure

Check the workflow run for details.

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

PassedFailedSkippedTotal
✅ ▲ Vercel Production120002191419
✅ 💻 Local Development158702191806
✅ 📦 Local Production158702191806
✅ 🐘 Local Postgres158702191806
✅ 🪟 Windows12900129
✅ 📋 Other7270176903
Total6817010527869

Details by Category

✅ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro103026
✅ example103026
✅ express103026
✅ fastify103026
✅ hono103026
✅ nextjs-turbopack12702
✅ nextjs-webpack12702
✅ nitro103026
✅ nuxt103026
✅ sveltekit12207
✅ vite103026
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🪟 Windows
AppPassedFailedSkipped
✅ nextjs-turbopack12900
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable104025
✅ e2e-local-dev-tanstack-start-104025
✅ e2e-local-postgres-nest-stable104025
✅ e2e-local-postgres-tanstack-start-104025
✅ e2e-local-prod-nest-stable104025
✅ e2e-local-prod-tanstack-start-104025
✅ e2e-vercel-prod-tanstack-start103026

📋 View full workflow run

@karthikscale3
karthikscale3force-pushed the karthik/fix-doc-switcher branch from 42d3fd0 to 4f0c239CompareMay 6, 2026 04:47
## Content restructuring
- Split `docs/content/docs/` into `docs/content/docs/v4/` and
`docs/content/docs/v5/` so each version is a fully independent
content tree with no shared-file coupling
- v4 excludes the four pages that are v5-only (AbortController
cancellation docs and the serializable-abort-controller internal page)
- v5 retains all pages; `preRelease` frontmatter field removed (no
longer needed now that each version is its own folder)
- Removed `AbortController` / `AbortSignal` from v4 serialization page
(section moved to v5 only)
## Fumadocs source
- Added `v4docs` and `v5docs` as separate `defineDocs()` collections in
`source.config.ts`; shared `docsSchema` (no more `preRelease` field)
- `source.ts` exports both `source` (v4, `baseUrl: /docs`) and
`v5Source` (v5, same base URL)
## Version routing
- `version-source.ts` simplified: `filterPreReleaseFromNodes` and
`isPreReleaseUrl` logic removed; v4 tree uses `source`, v5 tree uses
`v5Source` + `rewriteNodeUrls`
- v4 `page.tsx`: removed `preRelease` guard (v4Source has no such pages)
- v5 `page.tsx`: uses `v5Source` for `getPage` / `generateStaticParams`
/ `generateMetadata`; `v5Link` wrapper rewrites `/docs/…` hrefs to
`/v5/docs/…` so inline MDX links stay in the v5 context
## Versioned cookbook
- Added `app/[lang]/v5/cookbook/` layout + page (mirrors v4 but uses
`v5Source`, `rewriteCookbookUrlForVersion`, and `V5CookbookLink`)
- `getCookbookTree` accepts a `versionPrefix` parameter; sidebar URLs
are prefixed accordingly (`/v5/cookbook/…`)
- `cookbook-tree.ts`: added `skipVersions?: string[]` per-recipe field
for version-specific exclusions; `distributed-abort-controller` is
marked `skipVersions: ['v5']`
## Version switcher — state & navigation
- New `VersionProvider` context (`hooks/geistdocs/use-version.tsx`)
backed by `localStorage`: URL is source of truth on versioned pages,
`localStorage` carries the preference across non-versioned pages
(cookbook overview, worlds, etc.)
- `VersionSwitcher` uses `useVersion()` context instead of URL-only
detection; now visible on all pages including cookbook
- `DesktopMenu` and `MobileMenu` use `activeVersion` from context so
the "Docs" and "Cookbook" navbar links resolve to the correct version
prefix on every page
- `buildVersionUrl` expanded to handle `/cookbook/…` paths alongside
`/docs/…`; non-versioned routes (worlds, api) return unchanged
- `switchVersion` does a `HEAD` probe before navigating; falls back to
the versioned cookbook or docs home if the target page doesn't exist
in that version (handles v4-only → v5 and v5-only → v4 cases)
## Cookbook content (v5)
- Rewrote `agent-cancellation` recipe using a single `AbortController`
pattern; removed Hard Cancellation vs Stop Signal two-approach
comparison
- Deleted `distributed-abort-controller` recipe from v5 (native
`AbortController` serialization makes it unnecessary)
- Removed references to distributed-abort-controller from
`cookbook/index.mdx` and `common-patterns/timeouts.mdx`
Co-authored-by: Cursor <cursoragent@cursor.com>
Content moved from docs/content/docs/ to docs/content/docs/v5/ on main
(pre-release channel). Stable branch will use v4/ after backport.
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@karthikscale3@pranaygp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' docs: split v4/v5 content trees and fix version switcher end-to-end by karthikscale3 · Pull Request #1948 · vercel/workflow · GitHub
Skip to content

docs: split v4/v5 content trees and fix version switcher end-to-end - #1948

Merged
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher
May 6, 2026
Merged

docs: split v4/v5 content trees and fix version switcher end-to-end#1948
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher

Conversation

@karthikscale3

Copy link
Copy Markdown
Contributor

Summary

Content restructuring

  • Split docs/content/docs/ into docs/content/docs/v4/ and docs/content/docs/v5/ — each version is now a fully independent content tree with no shared-file coupling or preRelease frontmatter filtering
  • v4 excludes the four v5-only pages (AbortController cancellation docs, abort-signal-timeout error, and serializable-abort-controller internal page)
  • v5 retains all pages; preRelease frontmatter field removed (no longer meaningful with separate folders)
  • Removed AbortController / AbortSignal from the v4 serialization page (moved to v5 only)

Fumadocs source split

  • Added v4docs and v5docs as separate defineDocs() collections in source.config.ts pointing to content/docs/v4 and content/docs/v5
  • source.ts now exports both source (v4) and v5Source (v5), both with baseUrl: /docs

Version routing fixes

  • version-source.ts simplified: removed filterPreReleaseFromNodes / isPreReleaseUrl logic; v4 sidebar uses source, v5 uses v5Source + existing rewriteNodeUrls
  • v4 page.tsx: removed the preRelease guard (v4Source simply doesn't contain those pages)
  • v5 page.tsx: uses v5Source for getPage, generateStaticParams, and generateMetadata; v5Link wrapper rewrites /docs/… hrefs to /v5/docs/… so inline MDX links stay in the v5 context
  • buildVersionUrl now handles /cookbook/… paths with the same version-prefix logic as /docs/…; non-versioned routes (worlds, api) return unchanged

Versioned cookbook

  • Added app/[lang]/v5/cookbook/ layout + page (mirrors v4, uses v5Source and rewriteCookbookUrlForVersion)
  • getCookbookTree accepts a versionPrefix parameter; sidebar URLs are prefixed accordingly (/v5/cookbook/…)
  • cookbook-tree.ts: added skipVersions?: string[] per-recipe field for version-specific exclusions; distributed-abort-controller marked skipVersions: ['v5'] so it shows in v4 but not v5

Version switcher — state & navigation

  • New VersionProvider context (hooks/geistdocs/use-version.tsx) backed by localStorage: URL is the source of truth on versioned pages; localStorage carries the preference across non-versioned pages (worlds, etc.)
  • VersionSwitcher uses useVersion() context; now visible on all pages including cookbook (no longer hidden on non-docs routes)
  • DesktopMenu and MobileMenu read activeVersion from context so "Docs" and "Cookbook" navbar links resolve to the correct version prefix on every page
  • switchVersion does a HEAD probe before navigating; falls back to the versioned cookbook or docs home if the target page doesn't exist in that version — handles both v4-only → v5 (distributed-abort-controller) and v5-only → v4 (cancellation docs) cases

Cookbook content (v5)

  • Rewrote agent-cancellation recipe using a single AbortController + hook pattern; removed the Hard Cancellation vs Stop Signal two-approach comparison and comparison table
  • Deleted distributed-abort-controller recipe from v5 (native AbortController serialization in v5 makes it unnecessary)
  • Removed all references to distributed-abort-controller from cookbook/index.mdx, common-patterns/timeouts.mdx, advanced/meta.json, and the agent-cancellation page

Test plan

  • /docs/… (v4) pages load correctly; v5-only pages (/docs/foundations/cancellation, etc.) return 404
  • /v5/docs/… pages load correctly including the four v5-only pages
  • Version switcher shows correct version on docs, cookbook, and worlds pages
  • Switching v4 → v5 on a docs page navigates to the same page under /v5/docs/…
  • Switching v5 → v4 on a v5-only page falls back to /docs/getting-started
  • Switching versions on /cookbook/… navigates to the same recipe under /v5/cookbook/… (or falls back if not present)
  • Switching v4 → v5 on /cookbook/advanced/distributed-abort-controller falls back to /v5/cookbook
  • Navbar "Docs" and "Cookbook" links resolve to the active version's prefix on all pages
  • Version preference is preserved when navigating from docs → cookbook → back to docs

Made with Cursor

@changeset-bot

changeset-botBot commented May 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b76034f

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

vercelBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

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

workflow with no steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro0.033s (-23.0% 🟢)1.006s (~)0.973s101.00x
💻 LocalExpress0.038s (-14.9% 🟢)1.008s (~)0.970s101.14x
🐘 PostgresNitro0.048s (-49.3% 🟢)1.013s (-2.9%)0.964s101.45x
💻 LocalNext.js (Turbopack)0.051s1.006s0.954s101.55x
🌐 RedisNext.js (Turbopack)0.053s1.005s0.952s101.58x
🐘 PostgresNext.js (Turbopack)0.060s1.013s0.953s101.81x
🌐 MongoDBNext.js (Turbopack)0.099s1.008s0.909s102.98x
🐘 PostgresExpress0.111s (+91.4% 🔺)1.063s (+5.2% 🔺)0.952s103.34x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro0.245s (-40.1% 🟢)2.147s (-14.4% 🟢)1.902s101.00x
▲ VercelExpress0.253s (+7.3% 🔺)2.140s (~)1.887s101.03x
▲ VercelNext.js (Turbopack)0.798s (+217.1% 🔺)2.773s (+18.9% 🔺)1.976s103.25x

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

workflow with 1 step

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.067s (-5.7% 🟢)2.007s (~)0.940s101.00x
💻 LocalExpress1.082s (-3.8%)2.008s (~)0.925s101.01x
🐘 PostgresNitro1.091s (-4.3%)2.009s (~)0.918s101.02x
🌐 RedisNext.js (Turbopack)1.109s2.006s0.898s101.04x
💻 LocalNext.js (Turbopack)1.115s2.006s0.891s101.05x
🐘 PostgresNext.js (Turbopack)1.128s2.009s0.881s101.06x
🐘 PostgresExpress1.130s (-1.4%)2.024s (+0.7%)0.894s101.06x
🌐 MongoDBNext.js (Turbopack)1.168s2.009s0.841s101.09x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express1.579s (-15.8% 🟢)3.777s (-0.8%)2.199s101.00x
▲ VercelNitro1.590s (-59.1% 🟢)3.673s (-37.8% 🟢)2.083s101.01x
▲ VercelNext.js (Turbopack)3.197s (+57.1% 🔺)4.489s (+17.2% 🔺)1.292s102.03x

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

workflow with 10 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro10.427s (-4.7%)11.021s (~)0.594s31.00x
💻 LocalExpress10.465s (-4.2%)11.025s (~)0.559s31.00x
🐘 PostgresNitro10.467s (-3.7%)11.019s (~)0.552s31.00x
🌐 RedisNext.js (Turbopack)10.655s11.023s0.368s31.02x
💻 LocalNext.js (Turbopack)10.666s11.022s0.356s31.02x
🐘 PostgresNext.js (Turbopack)10.756s11.015s0.260s31.03x
🌐 MongoDBNext.js (Turbopack)10.834s11.020s0.186s31.04x
🐘 PostgresExpress10.866s (-0.9%)11.400s (+3.4%)0.534s31.04x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro13.218s (-44.3% 🟢)14.916s (-40.6% 🟢)1.698s31.00x
▲ VercelExpress13.258s (-21.9% 🟢)15.627s (-21.9% 🟢)2.368s21.00x
▲ VercelNext.js (Turbopack)15.143s (-12.6% 🟢)16.855s (-13.1% 🟢)1.712s21.15x

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

workflow with 25 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro13.417s (-10.9% 🟢)14.027s (-12.5% 🟢)0.610s51.00x
🐘 PostgresNitro13.484s (-7.6% 🟢)14.019s (-6.7% 🟢)0.536s51.00x
💻 LocalExpress13.637s (-8.9% 🟢)14.030s (-6.7% 🟢)0.392s51.02x
🌐 RedisNext.js (Turbopack)14.069s14.828s0.759s51.05x
💻 LocalNext.js (Turbopack)14.090s15.031s0.941s41.05x
🌐 MongoDBNext.js (Turbopack)14.228s15.025s0.798s41.06x
🐘 PostgresNext.js (Turbopack)14.238s15.020s0.782s41.06x
🐘 PostgresExpress14.414s (-1.2%)15.017s (~)0.604s41.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro21.299s (-67.0% 🟢)23.458s (-64.8% 🟢)2.159s31.00x
▲ VercelExpress21.953s (-56.4% 🟢)24.119s (-54.1% 🟢)2.166s31.03x
▲ VercelNext.js (Turbopack)22.605s (-57.0% 🟢)24.322s (-55.5% 🟢)1.717s31.06x

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

workflow with 50 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro11.799s (-29.7% 🟢)12.022s (-29.4% 🟢)0.222s81.00x
🐘 PostgresNitro12.001s (-14.1% 🟢)12.392s (-13.4% 🟢)0.390s81.02x
💻 LocalExpress12.214s (-26.4% 🟢)13.027s (-23.5% 🟢)0.813s71.04x
🌐 RedisNext.js (Turbopack)12.955s13.311s0.355s71.10x
💻 LocalNext.js (Turbopack)13.113s14.026s0.913s71.11x
🐘 PostgresNext.js (Turbopack)13.257s14.016s0.759s71.12x
🌐 MongoDBNext.js (Turbopack)13.339s14.025s0.687s71.13x
🐘 PostgresExpress16.095s (+14.9% 🔺)16.539s (+13.3% 🔺)0.444s61.36x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro31.335s (-92.6% 🟢)33.852s (-92.0% 🟢)2.517s31.00x
▲ VercelExpress33.300s (-72.5% 🟢)35.430s (-71.3% 🟢)2.130s31.06x
▲ VercelNext.js (Turbopack)33.643s (-91.5% 🟢)35.813s (-90.9% 🟢)2.170s31.07x

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

Promise.all with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.151s (-9.7% 🟢)2.007s (~)0.856s151.00x
💻 LocalNitro1.170s (-28.3% 🟢)2.005s (-3.3%)0.836s151.02x
💻 LocalExpress1.182s (-20.6% 🟢)2.007s (~)0.825s151.03x
🐘 PostgresNext.js (Turbopack)1.220s2.007s0.786s151.06x
🌐 RedisNext.js (Turbopack)1.244s2.006s0.762s151.08x
💻 LocalNext.js (Turbopack)1.280s2.006s0.726s151.11x
🐘 PostgresExpress1.443s (+14.5% 🔺)2.184s (+8.7% 🔺)0.742s141.25x
🌐 MongoDBNext.js (Turbopack)2.044s2.918s0.874s111.78x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.481s (-13.2% 🟢)4.024s (-13.0% 🟢)1.543s81.00x
▲ VercelNitro2.531s (-10.2% 🟢)4.150s (-4.0%)1.619s81.02x
▲ VercelNext.js (Turbopack)3.892s (+14.6% 🔺)5.639s (+14.3% 🔺)1.747s61.57x

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

Promise.all with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.224s (-48.0% 🟢)2.007s (-33.3% 🟢)0.783s151.00x
🐘 PostgresNext.js (Turbopack)1.384s2.007s0.623s151.13x
💻 LocalExpress1.642s (-44.4% 🟢)2.007s (-41.9% 🟢)0.364s151.34x
🐘 PostgresExpress1.690s (-28.4% 🟢)2.263s (-24.8% 🟢)0.573s141.38x
💻 LocalNitro1.693s (-46.1% 🟢)2.005s (-48.4% 🟢)0.312s151.38x
💻 LocalNext.js (Turbopack)1.848s2.073s0.226s151.51x
🌐 RedisNext.js (Turbopack)2.359s3.008s0.649s101.93x
🌐 MongoDBNext.js (Turbopack)3.611s4.009s0.398s82.95x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.862s (-4.7%)5.659s (-4.4%)1.797s61.00x
▲ VercelExpress4.351s (+20.2% 🔺)5.741s (+12.3% 🔺)1.391s61.13x
▲ VercelNext.js (Turbopack)5.397s (-24.0% 🟢)7.101s (-20.3% 🟢)1.704s51.40x

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

Promise.all with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.372s (-60.6% 🟢)2.008s (-49.9% 🟢)0.636s151.00x
🐘 PostgresNext.js (Turbopack)1.764s2.074s0.310s151.29x
🐘 PostgresExpress2.273s (-34.8% 🟢)3.078s (-23.3% 🟢)0.805s101.66x
🌐 RedisNext.js (Turbopack)3.639s4.010s0.370s82.65x
💻 LocalNitro4.502s (-46.1% 🟢)5.011s (-44.4% 🟢)0.510s63.28x
💻 LocalExpress4.545s (-45.5% 🟢)5.014s (-44.5% 🟢)0.469s73.31x
💻 LocalNext.js (Turbopack)5.644s6.215s0.571s54.11x
🌐 MongoDBNext.js (Turbopack)6.310s7.015s0.705s54.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.332s (+51.2% 🔺)6.946s (+25.5% 🔺)1.614s51.00x
▲ VercelNext.js (Turbopack)6.496s (-27.1% 🟢)8.168s (-25.5% 🟢)1.672s41.22x
▲ VercelExpress7.267s (+71.4% 🔺)9.101s (+48.5% 🔺)1.834s41.36x

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

Promise.race with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.149s (-8.6% 🟢)2.007s (~)0.858s151.00x
🌐 RedisNext.js (Turbopack)1.228s2.006s0.778s151.07x
🐘 PostgresNext.js (Turbopack)1.246s2.008s0.762s151.08x
💻 LocalNext.js (Turbopack)1.328s2.006s0.678s151.16x
💻 LocalNitro1.387s (-25.7% 🟢)2.006s (-14.3% 🟢)0.619s151.21x
🐘 PostgresExpress1.481s (+17.8% 🔺)2.163s (+7.7% 🔺)0.682s141.29x
💻 LocalExpress1.482s (-21.7% 🟢)2.007s (-15.1% 🟢)0.525s151.29x
🌐 MongoDBNext.js (Turbopack)2.031s2.827s0.796s111.77x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro2.354s (-4.2%)3.765s (-9.7% 🟢)1.411s81.00x
▲ VercelExpress2.501s (-3.1%)3.783s (-13.0% 🟢)1.283s81.06x
▲ VercelNext.js (Turbopack)3.502s (+19.5% 🔺)5.206s (+12.1% 🔺)1.704s71.49x

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

Promise.race with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.223s (-47.7% 🟢)2.009s (-33.3% 🟢)0.785s151.00x
🐘 PostgresNext.js (Turbopack)1.405s2.008s0.603s151.15x
🐘 PostgresExpress1.673s (-28.6% 🟢)2.326s (-22.8% 🟢)0.653s131.37x
💻 LocalExpress1.769s (-43.5% 🟢)2.151s (-42.8% 🟢)0.381s141.45x
💻 LocalNitro1.856s (-39.4% 🟢)2.222s (-42.8% 🟢)0.366s141.52x
💻 LocalNext.js (Turbopack)2.011s2.591s0.579s121.64x
🌐 RedisNext.js (Turbopack)2.353s3.008s0.655s101.92x
🌐 MongoDBNext.js (Turbopack)3.583s4.010s0.428s82.93x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.537s (+9.4% 🔺)5.179s (+2.0%)1.642s61.00x
▲ VercelExpress3.550s (+11.2% 🔺)5.397s (+12.6% 🔺)1.847s61.00x
▲ VercelNext.js (Turbopack)5.661s (+80.1% 🔺)6.980s (+54.4% 🔺)1.319s51.60x

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

Promise.race with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.375s (-60.5% 🟢)2.008s (-49.9% 🟢)0.633s151.00x
🐘 PostgresNext.js (Turbopack)1.637s2.075s0.438s151.19x
🐘 PostgresExpress2.311s (-34.0% 🟢)3.176s (-20.8% 🟢)0.865s101.68x
🌐 RedisNext.js (Turbopack)3.594s4.010s0.416s82.61x
💻 LocalExpress4.730s (-46.3% 🟢)5.346s (-42.3% 🟢)0.616s63.44x
💻 LocalNitro5.397s (-41.0% 🟢)6.014s (-40.0% 🟢)0.617s53.92x
💻 LocalNext.js (Turbopack)5.562s6.014s0.453s54.04x
🌐 MongoDBNext.js (Turbopack)6.355s7.014s0.659s54.62x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro4.714s (-7.4% 🟢)6.592s (-3.3%)1.878s51.00x
▲ VercelNext.js (Turbopack)5.926s (-12.3% 🟢)8.154s (-4.6%)2.228s41.26x
▲ VercelExpress6.059s (-5.6% 🟢)8.015s (-2.0%)1.956s41.29x

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

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.437s (-46.7% 🟢)1.007s (~)0.569s601.00x
💻 LocalNitro0.459s (-53.2% 🟢)1.004s (-8.2% 🟢)0.544s601.05x
💻 LocalExpress0.567s (-42.4% 🟢)1.040s (-3.4%)0.473s581.30x
🌐 RedisNext.js (Turbopack)0.621s1.004s0.383s601.42x
🐘 PostgresNext.js (Turbopack)0.667s1.006s0.339s601.53x
🌐 MongoDBNext.js (Turbopack)0.730s1.006s0.276s601.67x
💻 LocalNext.js (Turbopack)0.737s1.005s0.268s601.68x
🐘 PostgresExpress0.905s (+7.9% 🔺)1.370s (+33.9% 🔺)0.465s452.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express4.958s (-73.9% 🟢)6.669s (-68.7% 🟢)1.711s91.00x
▲ VercelNitro5.116s (-76.8% 🟢)6.704s (-72.1% 🟢)1.588s101.03x
▲ VercelNext.js (Turbopack)7.017s (-51.6% 🟢)8.729s (-45.7% 🟢)1.711s71.42x

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

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.022s (-47.0% 🟢)1.585s (-24.5% 🟢)0.564s571.00x
💻 LocalNitro1.161s (-61.7% 🟢)2.005s (-46.6% 🟢)0.844s451.14x
💻 LocalExpress1.307s (-56.7% 🟢)2.006s (-44.0% 🟢)0.700s451.28x
🌐 RedisNext.js (Turbopack)1.492s2.006s0.514s451.46x
🐘 PostgresNext.js (Turbopack)1.604s2.008s0.404s451.57x
💻 LocalNext.js (Turbopack)1.792s2.006s0.214s451.75x
🌐 MongoDBNext.js (Turbopack)1.842s2.007s0.166s451.80x
🐘 PostgresExpress2.094s (+5.9% 🔺)2.560s (+13.4% 🔺)0.467s362.05x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro12.742s (-67.7% 🟢)14.987s (-63.7% 🟢)2.246s71.00x
▲ VercelExpress13.193s (-61.8% 🟢)14.863s (-59.6% 🟢)1.670s71.04x
▲ VercelNext.js (Turbopack)14.895s (-70.1% 🟢)16.716s (-67.7% 🟢)1.822s61.17x

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

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro2.012s (-51.0% 🟢)2.427s (-47.3% 🟢)0.416s501.00x
💻 LocalNitro2.667s (-71.3% 🟢)3.033s (-69.7% 🟢)0.366s401.33x
💻 LocalExpress2.912s (-68.4% 🟢)3.252s (-67.5% 🟢)0.340s371.45x
🌐 RedisNext.js (Turbopack)2.984s3.250s0.267s371.48x
🐘 PostgresNext.js (Turbopack)3.270s4.045s0.775s301.63x
💻 LocalNext.js (Turbopack)3.857s4.075s0.217s301.92x
🐘 PostgresExpress4.078s (+2.2%)4.502s (+3.0%)0.424s272.03x
🌐 MongoDBNext.js (Turbopack)4.220s5.012s0.792s242.10x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro38.819s (-59.9% 🟢)40.985s (-58.4% 🟢)2.166s31.00x
▲ VercelExpress39.658s (-69.5% 🟢)41.705s (-68.4% 🟢)2.048s31.02x
▲ VercelNext.js (Turbopack)46.146s (-56.9% 🟢)47.530s (-56.4% 🟢)1.383s31.19x

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

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.182s (-35.9% 🟢)1.006s (~)0.824s601.00x
🌐 RedisNext.js (Turbopack)0.237s1.004s0.767s601.30x
🐘 PostgresNext.js (Turbopack)0.241s1.006s0.765s601.33x
💻 LocalNitro0.447s (-26.1% 🟢)1.004s (-1.7%)0.557s602.46x
💻 LocalExpress0.478s (-14.7% 🟢)1.005s (~)0.527s602.63x
🐘 PostgresExpress0.511s (+80.8% 🔺)1.148s (+14.0% 🔺)0.637s532.81x
💻 LocalNext.js (Turbopack)0.581s1.005s0.423s603.20x
🌐 MongoDBNext.js (Turbopack)1.036s1.855s0.819s335.70x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.028s (+3.8%)3.796s (+4.4%)1.768s161.00x
▲ VercelNitro2.293s (+38.0% 🔺)4.077s (+21.7% 🔺)1.785s151.13x
▲ VercelNext.js (Turbopack)3.973s (+96.4% 🔺)5.530s (+45.8% 🔺)1.557s111.96x

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

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.310s (-37.4% 🟢)1.006s (~)0.696s901.00x
🌐 RedisNext.js (Turbopack)0.407s1.004s0.597s901.31x
🐘 PostgresNext.js (Turbopack)0.482s1.007s0.524s901.55x
🐘 PostgresExpress0.818s (+60.4% 🔺)1.341s (+33.3% 🔺)0.523s682.63x
💻 LocalExpress2.184s (-13.1% 🟢)3.010s (~)0.825s307.04x
💻 LocalNitro2.198s (-13.4% 🟢)2.944s (-2.2%)0.746s317.08x
🌐 MongoDBNext.js (Turbopack)2.606s3.007s0.400s308.39x
💻 LocalNext.js (Turbopack)2.614s3.149s0.535s298.42x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Next.js (Turbopack)6.797s (+92.3% 🔺)8.510s (+63.9% 🔺)1.713s111.00x
▲ VercelNitro7.928s (+145.8% 🔺)9.974s (+106.8% 🔺)2.046s101.17x
▲ VercelExpress8.062s (+164.6% 🔺)9.804s (+103.9% 🔺)1.742s101.19x

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

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.662s (-16.3% 🟢)1.006s (~)0.344s1201.00x
🌐 RedisNext.js (Turbopack)0.751s1.012s0.261s1191.14x
🐘 PostgresNext.js (Turbopack)0.981s1.521s0.539s801.48x
🐘 PostgresExpress1.706s (+108.3% 🔺)2.295s (+125.6% 🔺)0.589s532.58x
🌐 MongoDBNext.js (Turbopack)5.391s6.014s0.623s208.14x
💻 LocalNitro9.825s (-12.2% 🟢)10.446s (-10.4% 🟢)0.621s1214.85x
💻 LocalExpress10.179s (-9.0% 🟢)10.783s (-9.7% 🟢)0.604s1215.38x
💻 LocalNext.js (Turbopack)11.645s12.330s0.685s1017.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express18.117s (+144.2% 🔺)20.127s (+117.7% 🔺)2.009s61.00x
▲ VercelNext.js (Turbopack)19.231s (+86.2% 🔺)21.009s (+71.0% 🔺)1.778s71.06x
▲ VercelNitro23.043s (+198.4% 🔺)25.291s (+169.0% 🔺)2.248s51.27x

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

Stream Benchmarks(includes TTFB metrics)
workflow with stream

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.129s (+428.1% 🔺)2.005s (+99.6% 🔺)0.011s (-14.4% 🟢)2.018s (+98.0% 🔺)0.889s101.00x
🐘 PostgresNitro1.138s (+455.3% 🔺)2.001s (+100.2% 🔺)0.001s (-13.3% 🟢)2.010s (+98.7% 🔺)0.871s101.01x
💻 LocalExpress1.143s (+474.3% 🔺)2.006s (+99.7% 🔺)0.010s (-15.7% 🟢)2.019s (+98.3% 🔺)0.875s101.01x
💻 LocalNext.js (Turbopack)1.190s2.003s0.013s2.020s0.830s101.05x
🐘 PostgresNext.js (Turbopack)1.195s2.001s0.002s2.011s0.815s101.06x
🐘 PostgresExpress1.514s (+638.4% 🔺)2.094s (+109.7% 🔺)0.378s (+23500.0% 🔺)2.508s (+148.0% 🔺)0.994s101.34x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.104s (-16.0% 🟢)3.360s (-17.8% 🟢)1.769s (+84.1% 🔺)5.626s (+0.6%)3.521s101.00x
▲ VercelNitro2.336s (-39.0% 🟢)3.612s (-31.6% 🟢)1.861s (+150.7% 🔺)6.014s (-7.2% 🟢)3.678s101.11x
▲ VercelNext.js (Turbopack)5.134s (-25.1% 🟢)5.213s (-39.7% 🟢)1.098s (+73.8% 🔺)7.870s (-19.6% 🟢)2.735s102.44x

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

stream pipeline with 5 transform steps (1MB)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.538s (+146.5% 🔺)2.001s (+98.8% 🔺)0.004s (-12.1% 🟢)2.025s (+98.0% 🔺)0.487s301.00x
💻 LocalExpress1.588s (+109.7% 🔺)2.011s (+95.5% 🔺)0.012s (+25.7% 🔺)2.026s (+94.8% 🔺)0.438s301.03x
🐘 PostgresNext.js (Turbopack)1.705s2.010s0.004s2.026s0.321s301.11x
💻 LocalNext.js (Turbopack)1.866s2.011s0.010s2.203s0.337s281.21x
💻 LocalNitro2.164s (+158.1% 🔺)2.010s (+98.6% 🔺)0.009s (-4.0%)2.675s (+139.7% 🔺)0.510s231.41x
🐘 PostgresExpress2.444s (+288.0% 🔺)2.731s (+171.4% 🔺)0.003s (-19.3% 🟢)2.767s (+170.4% 🔺)0.322s221.59x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express5.877s (-9.6% 🟢)7.234s (-9.7% 🟢)0.232s (-43.4% 🟢)7.955s (-10.0% 🟢)2.078s81.00x
▲ VercelNitro5.894s (-80.0% 🟢)7.169s (-76.7% 🟢)0.258s (+130.4% 🔺)7.895s (-75.2% 🟢)2.001s81.00x
▲ VercelNext.js (Turbopack)13.642s (-19.4% 🟢)13.146s (-27.9% 🟢)0.318s (+50.3% 🔺)15.510s (-18.1% 🟢)1.868s42.32x

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

10 parallel streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.694s (-28.3% 🟢)1.030s (-17.5% 🟢)0.000s (-57.9% 🟢)1.060s (-15.7% 🟢)0.366s571.00x
🐘 PostgresNext.js (Turbopack)0.798s1.072s0.000s1.082s0.284s561.15x
💻 LocalNext.js (Turbopack)1.451s2.014s0.000s2.017s0.566s302.09x
💻 LocalExpress1.475s (+20.4% 🔺)2.015s (~)0.000s (~)2.018s (~)0.543s302.12x
💻 LocalNitro1.486s (+21.5% 🔺)2.014s (~)0.000s (+364.3% 🔺)2.195s (+8.6% 🔺)0.709s282.14x
🐘 PostgresExpress2.079s (+116.4% 🔺)2.453s (+92.0% 🔺)0.000s (-100.0% 🟢)2.522s (+93.1% 🔺)0.443s242.99x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express3.871s (+3.5%)5.345s (+4.7%)0.003s (+1500.0% 🔺)5.771s (+4.4%)1.900s111.00x
▲ VercelNitro3.911s (+28.2% 🔺)5.386s (+22.6% 🔺)0.000s (+254.5% 🔺)5.924s (+23.2% 🔺)2.013s111.01x
▲ VercelNext.js (Turbopack)6.210s (-39.0% 🟢)6.441s (-44.1% 🟢)0.001s (+Infinity% 🔺)7.762s (-35.6% 🟢)1.552s81.60x

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

fan-out fan-in 10 streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.461s (-18.5% 🟢)2.141s (~)0.000s (~)2.154s (-1.0%)0.693s281.00x
🐘 PostgresNext.js (Turbopack)1.801s2.348s0.000s2.356s0.554s261.23x
💻 LocalNext.js (Turbopack)2.779s3.293s0.001s3.298s0.519s191.90x
💻 LocalNitro2.995s (-11.6% 🟢)3.735s (-7.4% 🟢)0.000s (-89.0% 🟢)3.737s (-7.4% 🟢)0.743s172.05x
💻 LocalExpress3.279s (-5.4% 🟢)3.840s (-4.8%)0.001s (-21.9% 🟢)3.847s (-4.7%)0.568s162.24x
🐘 PostgresExpress3.897s (+119.9% 🔺)4.233s (+94.4% 🔺)0.000s (+Infinity% 🔺)4.354s (+98.0% 🔺)0.458s142.67x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.840s (+42.7% 🔺)7.408s (+37.8% 🔺)0.000s (-8.3% 🟢)7.847s (+35.4% 🔺)2.007s81.00x
▲ VercelExpress5.876s (+28.1% 🔺)7.054s (+17.1% 🔺)0.001s (+Infinity% 🔺)7.514s (+16.4% 🔺)1.638s81.01x
▲ VercelNext.js (Turbopack)8.242s (+46.7% 🔺)9.359s (+34.0% 🔺)0.000s (+33.3% 🔺)10.005s (+32.7% 🔺)1.763s61.41x

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

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World🥇 Fastest FrameworkWins
💻 LocalNitro13/21
🐘 PostgresNitro21/21
▲ VercelNitro12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework🥇 Fastest WorldWins
Express💻 Local15/21
Next.js (Turbopack)🌐 Redis11/21
Nitro🐘 Postgres15/21
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


⚠️Community world benchmarks failed (non-blocking):

  • Community Worlds: failure

Check the workflow run for details.

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

PassedFailedSkippedTotal
✅ ▲ Vercel Production120002191419
✅ 💻 Local Development158702191806
✅ 📦 Local Production158702191806
✅ 🐘 Local Postgres158702191806
✅ 🪟 Windows12900129
✅ 📋 Other7270176903
Total6817010527869

Details by Category

✅ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro103026
✅ example103026
✅ express103026
✅ fastify103026
✅ hono103026
✅ nextjs-turbopack12702
✅ nextjs-webpack12702
✅ nitro103026
✅ nuxt103026
✅ sveltekit12207
✅ vite103026
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🪟 Windows
AppPassedFailedSkipped
✅ nextjs-turbopack12900
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable104025
✅ e2e-local-dev-tanstack-start-104025
✅ e2e-local-postgres-nest-stable104025
✅ e2e-local-postgres-tanstack-start-104025
✅ e2e-local-prod-nest-stable104025
✅ e2e-local-prod-tanstack-start-104025
✅ e2e-vercel-prod-tanstack-start103026

📋 View full workflow run

@karthikscale3
karthikscale3force-pushed the karthik/fix-doc-switcher branch from 42d3fd0 to 4f0c239CompareMay 6, 2026 04:47
## Content restructuring
- Split `docs/content/docs/` into `docs/content/docs/v4/` and
`docs/content/docs/v5/` so each version is a fully independent
content tree with no shared-file coupling
- v4 excludes the four pages that are v5-only (AbortController
cancellation docs and the serializable-abort-controller internal page)
- v5 retains all pages; `preRelease` frontmatter field removed (no
longer needed now that each version is its own folder)
- Removed `AbortController` / `AbortSignal` from v4 serialization page
(section moved to v5 only)
## Fumadocs source
- Added `v4docs` and `v5docs` as separate `defineDocs()` collections in
`source.config.ts`; shared `docsSchema` (no more `preRelease` field)
- `source.ts` exports both `source` (v4, `baseUrl: /docs`) and
`v5Source` (v5, same base URL)
## Version routing
- `version-source.ts` simplified: `filterPreReleaseFromNodes` and
`isPreReleaseUrl` logic removed; v4 tree uses `source`, v5 tree uses
`v5Source` + `rewriteNodeUrls`
- v4 `page.tsx`: removed `preRelease` guard (v4Source has no such pages)
- v5 `page.tsx`: uses `v5Source` for `getPage` / `generateStaticParams`
/ `generateMetadata`; `v5Link` wrapper rewrites `/docs/…` hrefs to
`/v5/docs/…` so inline MDX links stay in the v5 context
## Versioned cookbook
- Added `app/[lang]/v5/cookbook/` layout + page (mirrors v4 but uses
`v5Source`, `rewriteCookbookUrlForVersion`, and `V5CookbookLink`)
- `getCookbookTree` accepts a `versionPrefix` parameter; sidebar URLs
are prefixed accordingly (`/v5/cookbook/…`)
- `cookbook-tree.ts`: added `skipVersions?: string[]` per-recipe field
for version-specific exclusions; `distributed-abort-controller` is
marked `skipVersions: ['v5']`
## Version switcher — state & navigation
- New `VersionProvider` context (`hooks/geistdocs/use-version.tsx`)
backed by `localStorage`: URL is source of truth on versioned pages,
`localStorage` carries the preference across non-versioned pages
(cookbook overview, worlds, etc.)
- `VersionSwitcher` uses `useVersion()` context instead of URL-only
detection; now visible on all pages including cookbook
- `DesktopMenu` and `MobileMenu` use `activeVersion` from context so
the "Docs" and "Cookbook" navbar links resolve to the correct version
prefix on every page
- `buildVersionUrl` expanded to handle `/cookbook/…` paths alongside
`/docs/…`; non-versioned routes (worlds, api) return unchanged
- `switchVersion` does a `HEAD` probe before navigating; falls back to
the versioned cookbook or docs home if the target page doesn't exist
in that version (handles v4-only → v5 and v5-only → v4 cases)
## Cookbook content (v5)
- Rewrote `agent-cancellation` recipe using a single `AbortController`
pattern; removed Hard Cancellation vs Stop Signal two-approach
comparison
- Deleted `distributed-abort-controller` recipe from v5 (native
`AbortController` serialization makes it unnecessary)
- Removed references to distributed-abort-controller from
`cookbook/index.mdx` and `common-patterns/timeouts.mdx`
Co-authored-by: Cursor <cursoragent@cursor.com>
Content moved from docs/content/docs/ to docs/content/docs/v5/ on main
(pre-release channel). Stable branch will use v4/ after backport.
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@karthikscale3@pranaygp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' docs: split v4/v5 content trees and fix version switcher end-to-end by karthikscale3 · Pull Request #1948 · vercel/workflow · GitHub
Skip to content

docs: split v4/v5 content trees and fix version switcher end-to-end - #1948

Merged
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher
May 6, 2026
Merged

docs: split v4/v5 content trees and fix version switcher end-to-end#1948
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher

Conversation

@karthikscale3

Copy link
Copy Markdown
Contributor

Summary

Content restructuring

  • Split docs/content/docs/ into docs/content/docs/v4/ and docs/content/docs/v5/ — each version is now a fully independent content tree with no shared-file coupling or preRelease frontmatter filtering
  • v4 excludes the four v5-only pages (AbortController cancellation docs, abort-signal-timeout error, and serializable-abort-controller internal page)
  • v5 retains all pages; preRelease frontmatter field removed (no longer meaningful with separate folders)
  • Removed AbortController / AbortSignal from the v4 serialization page (moved to v5 only)

Fumadocs source split

  • Added v4docs and v5docs as separate defineDocs() collections in source.config.ts pointing to content/docs/v4 and content/docs/v5
  • source.ts now exports both source (v4) and v5Source (v5), both with baseUrl: /docs

Version routing fixes

  • version-source.ts simplified: removed filterPreReleaseFromNodes / isPreReleaseUrl logic; v4 sidebar uses source, v5 uses v5Source + existing rewriteNodeUrls
  • v4 page.tsx: removed the preRelease guard (v4Source simply doesn't contain those pages)
  • v5 page.tsx: uses v5Source for getPage, generateStaticParams, and generateMetadata; v5Link wrapper rewrites /docs/… hrefs to /v5/docs/… so inline MDX links stay in the v5 context
  • buildVersionUrl now handles /cookbook/… paths with the same version-prefix logic as /docs/…; non-versioned routes (worlds, api) return unchanged

Versioned cookbook

  • Added app/[lang]/v5/cookbook/ layout + page (mirrors v4, uses v5Source and rewriteCookbookUrlForVersion)
  • getCookbookTree accepts a versionPrefix parameter; sidebar URLs are prefixed accordingly (/v5/cookbook/…)
  • cookbook-tree.ts: added skipVersions?: string[] per-recipe field for version-specific exclusions; distributed-abort-controller marked skipVersions: ['v5'] so it shows in v4 but not v5

Version switcher — state & navigation

  • New VersionProvider context (hooks/geistdocs/use-version.tsx) backed by localStorage: URL is the source of truth on versioned pages; localStorage carries the preference across non-versioned pages (worlds, etc.)
  • VersionSwitcher uses useVersion() context; now visible on all pages including cookbook (no longer hidden on non-docs routes)
  • DesktopMenu and MobileMenu read activeVersion from context so "Docs" and "Cookbook" navbar links resolve to the correct version prefix on every page
  • switchVersion does a HEAD probe before navigating; falls back to the versioned cookbook or docs home if the target page doesn't exist in that version — handles both v4-only → v5 (distributed-abort-controller) and v5-only → v4 (cancellation docs) cases

Cookbook content (v5)

  • Rewrote agent-cancellation recipe using a single AbortController + hook pattern; removed the Hard Cancellation vs Stop Signal two-approach comparison and comparison table
  • Deleted distributed-abort-controller recipe from v5 (native AbortController serialization in v5 makes it unnecessary)
  • Removed all references to distributed-abort-controller from cookbook/index.mdx, common-patterns/timeouts.mdx, advanced/meta.json, and the agent-cancellation page

Test plan

  • /docs/… (v4) pages load correctly; v5-only pages (/docs/foundations/cancellation, etc.) return 404
  • /v5/docs/… pages load correctly including the four v5-only pages
  • Version switcher shows correct version on docs, cookbook, and worlds pages
  • Switching v4 → v5 on a docs page navigates to the same page under /v5/docs/…
  • Switching v5 → v4 on a v5-only page falls back to /docs/getting-started
  • Switching versions on /cookbook/… navigates to the same recipe under /v5/cookbook/… (or falls back if not present)
  • Switching v4 → v5 on /cookbook/advanced/distributed-abort-controller falls back to /v5/cookbook
  • Navbar "Docs" and "Cookbook" links resolve to the active version's prefix on all pages
  • Version preference is preserved when navigating from docs → cookbook → back to docs

Made with Cursor

@changeset-bot

changeset-botBot commented May 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b76034f

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

vercelBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

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

workflow with no steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro0.033s (-23.0% 🟢)1.006s (~)0.973s101.00x
💻 LocalExpress0.038s (-14.9% 🟢)1.008s (~)0.970s101.14x
🐘 PostgresNitro0.048s (-49.3% 🟢)1.013s (-2.9%)0.964s101.45x
💻 LocalNext.js (Turbopack)0.051s1.006s0.954s101.55x
🌐 RedisNext.js (Turbopack)0.053s1.005s0.952s101.58x
🐘 PostgresNext.js (Turbopack)0.060s1.013s0.953s101.81x
🌐 MongoDBNext.js (Turbopack)0.099s1.008s0.909s102.98x
🐘 PostgresExpress0.111s (+91.4% 🔺)1.063s (+5.2% 🔺)0.952s103.34x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro0.245s (-40.1% 🟢)2.147s (-14.4% 🟢)1.902s101.00x
▲ VercelExpress0.253s (+7.3% 🔺)2.140s (~)1.887s101.03x
▲ VercelNext.js (Turbopack)0.798s (+217.1% 🔺)2.773s (+18.9% 🔺)1.976s103.25x

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

workflow with 1 step

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.067s (-5.7% 🟢)2.007s (~)0.940s101.00x
💻 LocalExpress1.082s (-3.8%)2.008s (~)0.925s101.01x
🐘 PostgresNitro1.091s (-4.3%)2.009s (~)0.918s101.02x
🌐 RedisNext.js (Turbopack)1.109s2.006s0.898s101.04x
💻 LocalNext.js (Turbopack)1.115s2.006s0.891s101.05x
🐘 PostgresNext.js (Turbopack)1.128s2.009s0.881s101.06x
🐘 PostgresExpress1.130s (-1.4%)2.024s (+0.7%)0.894s101.06x
🌐 MongoDBNext.js (Turbopack)1.168s2.009s0.841s101.09x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express1.579s (-15.8% 🟢)3.777s (-0.8%)2.199s101.00x
▲ VercelNitro1.590s (-59.1% 🟢)3.673s (-37.8% 🟢)2.083s101.01x
▲ VercelNext.js (Turbopack)3.197s (+57.1% 🔺)4.489s (+17.2% 🔺)1.292s102.03x

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

workflow with 10 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro10.427s (-4.7%)11.021s (~)0.594s31.00x
💻 LocalExpress10.465s (-4.2%)11.025s (~)0.559s31.00x
🐘 PostgresNitro10.467s (-3.7%)11.019s (~)0.552s31.00x
🌐 RedisNext.js (Turbopack)10.655s11.023s0.368s31.02x
💻 LocalNext.js (Turbopack)10.666s11.022s0.356s31.02x
🐘 PostgresNext.js (Turbopack)10.756s11.015s0.260s31.03x
🌐 MongoDBNext.js (Turbopack)10.834s11.020s0.186s31.04x
🐘 PostgresExpress10.866s (-0.9%)11.400s (+3.4%)0.534s31.04x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro13.218s (-44.3% 🟢)14.916s (-40.6% 🟢)1.698s31.00x
▲ VercelExpress13.258s (-21.9% 🟢)15.627s (-21.9% 🟢)2.368s21.00x
▲ VercelNext.js (Turbopack)15.143s (-12.6% 🟢)16.855s (-13.1% 🟢)1.712s21.15x

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

workflow with 25 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro13.417s (-10.9% 🟢)14.027s (-12.5% 🟢)0.610s51.00x
🐘 PostgresNitro13.484s (-7.6% 🟢)14.019s (-6.7% 🟢)0.536s51.00x
💻 LocalExpress13.637s (-8.9% 🟢)14.030s (-6.7% 🟢)0.392s51.02x
🌐 RedisNext.js (Turbopack)14.069s14.828s0.759s51.05x
💻 LocalNext.js (Turbopack)14.090s15.031s0.941s41.05x
🌐 MongoDBNext.js (Turbopack)14.228s15.025s0.798s41.06x
🐘 PostgresNext.js (Turbopack)14.238s15.020s0.782s41.06x
🐘 PostgresExpress14.414s (-1.2%)15.017s (~)0.604s41.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro21.299s (-67.0% 🟢)23.458s (-64.8% 🟢)2.159s31.00x
▲ VercelExpress21.953s (-56.4% 🟢)24.119s (-54.1% 🟢)2.166s31.03x
▲ VercelNext.js (Turbopack)22.605s (-57.0% 🟢)24.322s (-55.5% 🟢)1.717s31.06x

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

workflow with 50 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro11.799s (-29.7% 🟢)12.022s (-29.4% 🟢)0.222s81.00x
🐘 PostgresNitro12.001s (-14.1% 🟢)12.392s (-13.4% 🟢)0.390s81.02x
💻 LocalExpress12.214s (-26.4% 🟢)13.027s (-23.5% 🟢)0.813s71.04x
🌐 RedisNext.js (Turbopack)12.955s13.311s0.355s71.10x
💻 LocalNext.js (Turbopack)13.113s14.026s0.913s71.11x
🐘 PostgresNext.js (Turbopack)13.257s14.016s0.759s71.12x
🌐 MongoDBNext.js (Turbopack)13.339s14.025s0.687s71.13x
🐘 PostgresExpress16.095s (+14.9% 🔺)16.539s (+13.3% 🔺)0.444s61.36x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro31.335s (-92.6% 🟢)33.852s (-92.0% 🟢)2.517s31.00x
▲ VercelExpress33.300s (-72.5% 🟢)35.430s (-71.3% 🟢)2.130s31.06x
▲ VercelNext.js (Turbopack)33.643s (-91.5% 🟢)35.813s (-90.9% 🟢)2.170s31.07x

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

Promise.all with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.151s (-9.7% 🟢)2.007s (~)0.856s151.00x
💻 LocalNitro1.170s (-28.3% 🟢)2.005s (-3.3%)0.836s151.02x
💻 LocalExpress1.182s (-20.6% 🟢)2.007s (~)0.825s151.03x
🐘 PostgresNext.js (Turbopack)1.220s2.007s0.786s151.06x
🌐 RedisNext.js (Turbopack)1.244s2.006s0.762s151.08x
💻 LocalNext.js (Turbopack)1.280s2.006s0.726s151.11x
🐘 PostgresExpress1.443s (+14.5% 🔺)2.184s (+8.7% 🔺)0.742s141.25x
🌐 MongoDBNext.js (Turbopack)2.044s2.918s0.874s111.78x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.481s (-13.2% 🟢)4.024s (-13.0% 🟢)1.543s81.00x
▲ VercelNitro2.531s (-10.2% 🟢)4.150s (-4.0%)1.619s81.02x
▲ VercelNext.js (Turbopack)3.892s (+14.6% 🔺)5.639s (+14.3% 🔺)1.747s61.57x

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

Promise.all with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.224s (-48.0% 🟢)2.007s (-33.3% 🟢)0.783s151.00x
🐘 PostgresNext.js (Turbopack)1.384s2.007s0.623s151.13x
💻 LocalExpress1.642s (-44.4% 🟢)2.007s (-41.9% 🟢)0.364s151.34x
🐘 PostgresExpress1.690s (-28.4% 🟢)2.263s (-24.8% 🟢)0.573s141.38x
💻 LocalNitro1.693s (-46.1% 🟢)2.005s (-48.4% 🟢)0.312s151.38x
💻 LocalNext.js (Turbopack)1.848s2.073s0.226s151.51x
🌐 RedisNext.js (Turbopack)2.359s3.008s0.649s101.93x
🌐 MongoDBNext.js (Turbopack)3.611s4.009s0.398s82.95x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.862s (-4.7%)5.659s (-4.4%)1.797s61.00x
▲ VercelExpress4.351s (+20.2% 🔺)5.741s (+12.3% 🔺)1.391s61.13x
▲ VercelNext.js (Turbopack)5.397s (-24.0% 🟢)7.101s (-20.3% 🟢)1.704s51.40x

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

Promise.all with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.372s (-60.6% 🟢)2.008s (-49.9% 🟢)0.636s151.00x
🐘 PostgresNext.js (Turbopack)1.764s2.074s0.310s151.29x
🐘 PostgresExpress2.273s (-34.8% 🟢)3.078s (-23.3% 🟢)0.805s101.66x
🌐 RedisNext.js (Turbopack)3.639s4.010s0.370s82.65x
💻 LocalNitro4.502s (-46.1% 🟢)5.011s (-44.4% 🟢)0.510s63.28x
💻 LocalExpress4.545s (-45.5% 🟢)5.014s (-44.5% 🟢)0.469s73.31x
💻 LocalNext.js (Turbopack)5.644s6.215s0.571s54.11x
🌐 MongoDBNext.js (Turbopack)6.310s7.015s0.705s54.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.332s (+51.2% 🔺)6.946s (+25.5% 🔺)1.614s51.00x
▲ VercelNext.js (Turbopack)6.496s (-27.1% 🟢)8.168s (-25.5% 🟢)1.672s41.22x
▲ VercelExpress7.267s (+71.4% 🔺)9.101s (+48.5% 🔺)1.834s41.36x

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

Promise.race with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.149s (-8.6% 🟢)2.007s (~)0.858s151.00x
🌐 RedisNext.js (Turbopack)1.228s2.006s0.778s151.07x
🐘 PostgresNext.js (Turbopack)1.246s2.008s0.762s151.08x
💻 LocalNext.js (Turbopack)1.328s2.006s0.678s151.16x
💻 LocalNitro1.387s (-25.7% 🟢)2.006s (-14.3% 🟢)0.619s151.21x
🐘 PostgresExpress1.481s (+17.8% 🔺)2.163s (+7.7% 🔺)0.682s141.29x
💻 LocalExpress1.482s (-21.7% 🟢)2.007s (-15.1% 🟢)0.525s151.29x
🌐 MongoDBNext.js (Turbopack)2.031s2.827s0.796s111.77x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro2.354s (-4.2%)3.765s (-9.7% 🟢)1.411s81.00x
▲ VercelExpress2.501s (-3.1%)3.783s (-13.0% 🟢)1.283s81.06x
▲ VercelNext.js (Turbopack)3.502s (+19.5% 🔺)5.206s (+12.1% 🔺)1.704s71.49x

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

Promise.race with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.223s (-47.7% 🟢)2.009s (-33.3% 🟢)0.785s151.00x
🐘 PostgresNext.js (Turbopack)1.405s2.008s0.603s151.15x
🐘 PostgresExpress1.673s (-28.6% 🟢)2.326s (-22.8% 🟢)0.653s131.37x
💻 LocalExpress1.769s (-43.5% 🟢)2.151s (-42.8% 🟢)0.381s141.45x
💻 LocalNitro1.856s (-39.4% 🟢)2.222s (-42.8% 🟢)0.366s141.52x
💻 LocalNext.js (Turbopack)2.011s2.591s0.579s121.64x
🌐 RedisNext.js (Turbopack)2.353s3.008s0.655s101.92x
🌐 MongoDBNext.js (Turbopack)3.583s4.010s0.428s82.93x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.537s (+9.4% 🔺)5.179s (+2.0%)1.642s61.00x
▲ VercelExpress3.550s (+11.2% 🔺)5.397s (+12.6% 🔺)1.847s61.00x
▲ VercelNext.js (Turbopack)5.661s (+80.1% 🔺)6.980s (+54.4% 🔺)1.319s51.60x

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

Promise.race with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.375s (-60.5% 🟢)2.008s (-49.9% 🟢)0.633s151.00x
🐘 PostgresNext.js (Turbopack)1.637s2.075s0.438s151.19x
🐘 PostgresExpress2.311s (-34.0% 🟢)3.176s (-20.8% 🟢)0.865s101.68x
🌐 RedisNext.js (Turbopack)3.594s4.010s0.416s82.61x
💻 LocalExpress4.730s (-46.3% 🟢)5.346s (-42.3% 🟢)0.616s63.44x
💻 LocalNitro5.397s (-41.0% 🟢)6.014s (-40.0% 🟢)0.617s53.92x
💻 LocalNext.js (Turbopack)5.562s6.014s0.453s54.04x
🌐 MongoDBNext.js (Turbopack)6.355s7.014s0.659s54.62x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro4.714s (-7.4% 🟢)6.592s (-3.3%)1.878s51.00x
▲ VercelNext.js (Turbopack)5.926s (-12.3% 🟢)8.154s (-4.6%)2.228s41.26x
▲ VercelExpress6.059s (-5.6% 🟢)8.015s (-2.0%)1.956s41.29x

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

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.437s (-46.7% 🟢)1.007s (~)0.569s601.00x
💻 LocalNitro0.459s (-53.2% 🟢)1.004s (-8.2% 🟢)0.544s601.05x
💻 LocalExpress0.567s (-42.4% 🟢)1.040s (-3.4%)0.473s581.30x
🌐 RedisNext.js (Turbopack)0.621s1.004s0.383s601.42x
🐘 PostgresNext.js (Turbopack)0.667s1.006s0.339s601.53x
🌐 MongoDBNext.js (Turbopack)0.730s1.006s0.276s601.67x
💻 LocalNext.js (Turbopack)0.737s1.005s0.268s601.68x
🐘 PostgresExpress0.905s (+7.9% 🔺)1.370s (+33.9% 🔺)0.465s452.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express4.958s (-73.9% 🟢)6.669s (-68.7% 🟢)1.711s91.00x
▲ VercelNitro5.116s (-76.8% 🟢)6.704s (-72.1% 🟢)1.588s101.03x
▲ VercelNext.js (Turbopack)7.017s (-51.6% 🟢)8.729s (-45.7% 🟢)1.711s71.42x

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

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.022s (-47.0% 🟢)1.585s (-24.5% 🟢)0.564s571.00x
💻 LocalNitro1.161s (-61.7% 🟢)2.005s (-46.6% 🟢)0.844s451.14x
💻 LocalExpress1.307s (-56.7% 🟢)2.006s (-44.0% 🟢)0.700s451.28x
🌐 RedisNext.js (Turbopack)1.492s2.006s0.514s451.46x
🐘 PostgresNext.js (Turbopack)1.604s2.008s0.404s451.57x
💻 LocalNext.js (Turbopack)1.792s2.006s0.214s451.75x
🌐 MongoDBNext.js (Turbopack)1.842s2.007s0.166s451.80x
🐘 PostgresExpress2.094s (+5.9% 🔺)2.560s (+13.4% 🔺)0.467s362.05x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro12.742s (-67.7% 🟢)14.987s (-63.7% 🟢)2.246s71.00x
▲ VercelExpress13.193s (-61.8% 🟢)14.863s (-59.6% 🟢)1.670s71.04x
▲ VercelNext.js (Turbopack)14.895s (-70.1% 🟢)16.716s (-67.7% 🟢)1.822s61.17x

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

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro2.012s (-51.0% 🟢)2.427s (-47.3% 🟢)0.416s501.00x
💻 LocalNitro2.667s (-71.3% 🟢)3.033s (-69.7% 🟢)0.366s401.33x
💻 LocalExpress2.912s (-68.4% 🟢)3.252s (-67.5% 🟢)0.340s371.45x
🌐 RedisNext.js (Turbopack)2.984s3.250s0.267s371.48x
🐘 PostgresNext.js (Turbopack)3.270s4.045s0.775s301.63x
💻 LocalNext.js (Turbopack)3.857s4.075s0.217s301.92x
🐘 PostgresExpress4.078s (+2.2%)4.502s (+3.0%)0.424s272.03x
🌐 MongoDBNext.js (Turbopack)4.220s5.012s0.792s242.10x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro38.819s (-59.9% 🟢)40.985s (-58.4% 🟢)2.166s31.00x
▲ VercelExpress39.658s (-69.5% 🟢)41.705s (-68.4% 🟢)2.048s31.02x
▲ VercelNext.js (Turbopack)46.146s (-56.9% 🟢)47.530s (-56.4% 🟢)1.383s31.19x

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

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.182s (-35.9% 🟢)1.006s (~)0.824s601.00x
🌐 RedisNext.js (Turbopack)0.237s1.004s0.767s601.30x
🐘 PostgresNext.js (Turbopack)0.241s1.006s0.765s601.33x
💻 LocalNitro0.447s (-26.1% 🟢)1.004s (-1.7%)0.557s602.46x
💻 LocalExpress0.478s (-14.7% 🟢)1.005s (~)0.527s602.63x
🐘 PostgresExpress0.511s (+80.8% 🔺)1.148s (+14.0% 🔺)0.637s532.81x
💻 LocalNext.js (Turbopack)0.581s1.005s0.423s603.20x
🌐 MongoDBNext.js (Turbopack)1.036s1.855s0.819s335.70x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.028s (+3.8%)3.796s (+4.4%)1.768s161.00x
▲ VercelNitro2.293s (+38.0% 🔺)4.077s (+21.7% 🔺)1.785s151.13x
▲ VercelNext.js (Turbopack)3.973s (+96.4% 🔺)5.530s (+45.8% 🔺)1.557s111.96x

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

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.310s (-37.4% 🟢)1.006s (~)0.696s901.00x
🌐 RedisNext.js (Turbopack)0.407s1.004s0.597s901.31x
🐘 PostgresNext.js (Turbopack)0.482s1.007s0.524s901.55x
🐘 PostgresExpress0.818s (+60.4% 🔺)1.341s (+33.3% 🔺)0.523s682.63x
💻 LocalExpress2.184s (-13.1% 🟢)3.010s (~)0.825s307.04x
💻 LocalNitro2.198s (-13.4% 🟢)2.944s (-2.2%)0.746s317.08x
🌐 MongoDBNext.js (Turbopack)2.606s3.007s0.400s308.39x
💻 LocalNext.js (Turbopack)2.614s3.149s0.535s298.42x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Next.js (Turbopack)6.797s (+92.3% 🔺)8.510s (+63.9% 🔺)1.713s111.00x
▲ VercelNitro7.928s (+145.8% 🔺)9.974s (+106.8% 🔺)2.046s101.17x
▲ VercelExpress8.062s (+164.6% 🔺)9.804s (+103.9% 🔺)1.742s101.19x

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

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.662s (-16.3% 🟢)1.006s (~)0.344s1201.00x
🌐 RedisNext.js (Turbopack)0.751s1.012s0.261s1191.14x
🐘 PostgresNext.js (Turbopack)0.981s1.521s0.539s801.48x
🐘 PostgresExpress1.706s (+108.3% 🔺)2.295s (+125.6% 🔺)0.589s532.58x
🌐 MongoDBNext.js (Turbopack)5.391s6.014s0.623s208.14x
💻 LocalNitro9.825s (-12.2% 🟢)10.446s (-10.4% 🟢)0.621s1214.85x
💻 LocalExpress10.179s (-9.0% 🟢)10.783s (-9.7% 🟢)0.604s1215.38x
💻 LocalNext.js (Turbopack)11.645s12.330s0.685s1017.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express18.117s (+144.2% 🔺)20.127s (+117.7% 🔺)2.009s61.00x
▲ VercelNext.js (Turbopack)19.231s (+86.2% 🔺)21.009s (+71.0% 🔺)1.778s71.06x
▲ VercelNitro23.043s (+198.4% 🔺)25.291s (+169.0% 🔺)2.248s51.27x

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

Stream Benchmarks(includes TTFB metrics)
workflow with stream

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.129s (+428.1% 🔺)2.005s (+99.6% 🔺)0.011s (-14.4% 🟢)2.018s (+98.0% 🔺)0.889s101.00x
🐘 PostgresNitro1.138s (+455.3% 🔺)2.001s (+100.2% 🔺)0.001s (-13.3% 🟢)2.010s (+98.7% 🔺)0.871s101.01x
💻 LocalExpress1.143s (+474.3% 🔺)2.006s (+99.7% 🔺)0.010s (-15.7% 🟢)2.019s (+98.3% 🔺)0.875s101.01x
💻 LocalNext.js (Turbopack)1.190s2.003s0.013s2.020s0.830s101.05x
🐘 PostgresNext.js (Turbopack)1.195s2.001s0.002s2.011s0.815s101.06x
🐘 PostgresExpress1.514s (+638.4% 🔺)2.094s (+109.7% 🔺)0.378s (+23500.0% 🔺)2.508s (+148.0% 🔺)0.994s101.34x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.104s (-16.0% 🟢)3.360s (-17.8% 🟢)1.769s (+84.1% 🔺)5.626s (+0.6%)3.521s101.00x
▲ VercelNitro2.336s (-39.0% 🟢)3.612s (-31.6% 🟢)1.861s (+150.7% 🔺)6.014s (-7.2% 🟢)3.678s101.11x
▲ VercelNext.js (Turbopack)5.134s (-25.1% 🟢)5.213s (-39.7% 🟢)1.098s (+73.8% 🔺)7.870s (-19.6% 🟢)2.735s102.44x

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

stream pipeline with 5 transform steps (1MB)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.538s (+146.5% 🔺)2.001s (+98.8% 🔺)0.004s (-12.1% 🟢)2.025s (+98.0% 🔺)0.487s301.00x
💻 LocalExpress1.588s (+109.7% 🔺)2.011s (+95.5% 🔺)0.012s (+25.7% 🔺)2.026s (+94.8% 🔺)0.438s301.03x
🐘 PostgresNext.js (Turbopack)1.705s2.010s0.004s2.026s0.321s301.11x
💻 LocalNext.js (Turbopack)1.866s2.011s0.010s2.203s0.337s281.21x
💻 LocalNitro2.164s (+158.1% 🔺)2.010s (+98.6% 🔺)0.009s (-4.0%)2.675s (+139.7% 🔺)0.510s231.41x
🐘 PostgresExpress2.444s (+288.0% 🔺)2.731s (+171.4% 🔺)0.003s (-19.3% 🟢)2.767s (+170.4% 🔺)0.322s221.59x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express5.877s (-9.6% 🟢)7.234s (-9.7% 🟢)0.232s (-43.4% 🟢)7.955s (-10.0% 🟢)2.078s81.00x
▲ VercelNitro5.894s (-80.0% 🟢)7.169s (-76.7% 🟢)0.258s (+130.4% 🔺)7.895s (-75.2% 🟢)2.001s81.00x
▲ VercelNext.js (Turbopack)13.642s (-19.4% 🟢)13.146s (-27.9% 🟢)0.318s (+50.3% 🔺)15.510s (-18.1% 🟢)1.868s42.32x

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

10 parallel streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.694s (-28.3% 🟢)1.030s (-17.5% 🟢)0.000s (-57.9% 🟢)1.060s (-15.7% 🟢)0.366s571.00x
🐘 PostgresNext.js (Turbopack)0.798s1.072s0.000s1.082s0.284s561.15x
💻 LocalNext.js (Turbopack)1.451s2.014s0.000s2.017s0.566s302.09x
💻 LocalExpress1.475s (+20.4% 🔺)2.015s (~)0.000s (~)2.018s (~)0.543s302.12x
💻 LocalNitro1.486s (+21.5% 🔺)2.014s (~)0.000s (+364.3% 🔺)2.195s (+8.6% 🔺)0.709s282.14x
🐘 PostgresExpress2.079s (+116.4% 🔺)2.453s (+92.0% 🔺)0.000s (-100.0% 🟢)2.522s (+93.1% 🔺)0.443s242.99x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express3.871s (+3.5%)5.345s (+4.7%)0.003s (+1500.0% 🔺)5.771s (+4.4%)1.900s111.00x
▲ VercelNitro3.911s (+28.2% 🔺)5.386s (+22.6% 🔺)0.000s (+254.5% 🔺)5.924s (+23.2% 🔺)2.013s111.01x
▲ VercelNext.js (Turbopack)6.210s (-39.0% 🟢)6.441s (-44.1% 🟢)0.001s (+Infinity% 🔺)7.762s (-35.6% 🟢)1.552s81.60x

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

fan-out fan-in 10 streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.461s (-18.5% 🟢)2.141s (~)0.000s (~)2.154s (-1.0%)0.693s281.00x
🐘 PostgresNext.js (Turbopack)1.801s2.348s0.000s2.356s0.554s261.23x
💻 LocalNext.js (Turbopack)2.779s3.293s0.001s3.298s0.519s191.90x
💻 LocalNitro2.995s (-11.6% 🟢)3.735s (-7.4% 🟢)0.000s (-89.0% 🟢)3.737s (-7.4% 🟢)0.743s172.05x
💻 LocalExpress3.279s (-5.4% 🟢)3.840s (-4.8%)0.001s (-21.9% 🟢)3.847s (-4.7%)0.568s162.24x
🐘 PostgresExpress3.897s (+119.9% 🔺)4.233s (+94.4% 🔺)0.000s (+Infinity% 🔺)4.354s (+98.0% 🔺)0.458s142.67x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.840s (+42.7% 🔺)7.408s (+37.8% 🔺)0.000s (-8.3% 🟢)7.847s (+35.4% 🔺)2.007s81.00x
▲ VercelExpress5.876s (+28.1% 🔺)7.054s (+17.1% 🔺)0.001s (+Infinity% 🔺)7.514s (+16.4% 🔺)1.638s81.01x
▲ VercelNext.js (Turbopack)8.242s (+46.7% 🔺)9.359s (+34.0% 🔺)0.000s (+33.3% 🔺)10.005s (+32.7% 🔺)1.763s61.41x

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

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World🥇 Fastest FrameworkWins
💻 LocalNitro13/21
🐘 PostgresNitro21/21
▲ VercelNitro12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework🥇 Fastest WorldWins
Express💻 Local15/21
Next.js (Turbopack)🌐 Redis11/21
Nitro🐘 Postgres15/21
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


⚠️Community world benchmarks failed (non-blocking):

  • Community Worlds: failure

Check the workflow run for details.

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

PassedFailedSkippedTotal
✅ ▲ Vercel Production120002191419
✅ 💻 Local Development158702191806
✅ 📦 Local Production158702191806
✅ 🐘 Local Postgres158702191806
✅ 🪟 Windows12900129
✅ 📋 Other7270176903
Total6817010527869

Details by Category

✅ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro103026
✅ example103026
✅ express103026
✅ fastify103026
✅ hono103026
✅ nextjs-turbopack12702
✅ nextjs-webpack12702
✅ nitro103026
✅ nuxt103026
✅ sveltekit12207
✅ vite103026
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🪟 Windows
AppPassedFailedSkipped
✅ nextjs-turbopack12900
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable104025
✅ e2e-local-dev-tanstack-start-104025
✅ e2e-local-postgres-nest-stable104025
✅ e2e-local-postgres-tanstack-start-104025
✅ e2e-local-prod-nest-stable104025
✅ e2e-local-prod-tanstack-start-104025
✅ e2e-vercel-prod-tanstack-start103026

📋 View full workflow run

@karthikscale3
karthikscale3force-pushed the karthik/fix-doc-switcher branch from 42d3fd0 to 4f0c239CompareMay 6, 2026 04:47
## Content restructuring
- Split `docs/content/docs/` into `docs/content/docs/v4/` and
`docs/content/docs/v5/` so each version is a fully independent
content tree with no shared-file coupling
- v4 excludes the four pages that are v5-only (AbortController
cancellation docs and the serializable-abort-controller internal page)
- v5 retains all pages; `preRelease` frontmatter field removed (no
longer needed now that each version is its own folder)
- Removed `AbortController` / `AbortSignal` from v4 serialization page
(section moved to v5 only)
## Fumadocs source
- Added `v4docs` and `v5docs` as separate `defineDocs()` collections in
`source.config.ts`; shared `docsSchema` (no more `preRelease` field)
- `source.ts` exports both `source` (v4, `baseUrl: /docs`) and
`v5Source` (v5, same base URL)
## Version routing
- `version-source.ts` simplified: `filterPreReleaseFromNodes` and
`isPreReleaseUrl` logic removed; v4 tree uses `source`, v5 tree uses
`v5Source` + `rewriteNodeUrls`
- v4 `page.tsx`: removed `preRelease` guard (v4Source has no such pages)
- v5 `page.tsx`: uses `v5Source` for `getPage` / `generateStaticParams`
/ `generateMetadata`; `v5Link` wrapper rewrites `/docs/…` hrefs to
`/v5/docs/…` so inline MDX links stay in the v5 context
## Versioned cookbook
- Added `app/[lang]/v5/cookbook/` layout + page (mirrors v4 but uses
`v5Source`, `rewriteCookbookUrlForVersion`, and `V5CookbookLink`)
- `getCookbookTree` accepts a `versionPrefix` parameter; sidebar URLs
are prefixed accordingly (`/v5/cookbook/…`)
- `cookbook-tree.ts`: added `skipVersions?: string[]` per-recipe field
for version-specific exclusions; `distributed-abort-controller` is
marked `skipVersions: ['v5']`
## Version switcher — state & navigation
- New `VersionProvider` context (`hooks/geistdocs/use-version.tsx`)
backed by `localStorage`: URL is source of truth on versioned pages,
`localStorage` carries the preference across non-versioned pages
(cookbook overview, worlds, etc.)
- `VersionSwitcher` uses `useVersion()` context instead of URL-only
detection; now visible on all pages including cookbook
- `DesktopMenu` and `MobileMenu` use `activeVersion` from context so
the "Docs" and "Cookbook" navbar links resolve to the correct version
prefix on every page
- `buildVersionUrl` expanded to handle `/cookbook/…` paths alongside
`/docs/…`; non-versioned routes (worlds, api) return unchanged
- `switchVersion` does a `HEAD` probe before navigating; falls back to
the versioned cookbook or docs home if the target page doesn't exist
in that version (handles v4-only → v5 and v5-only → v4 cases)
## Cookbook content (v5)
- Rewrote `agent-cancellation` recipe using a single `AbortController`
pattern; removed Hard Cancellation vs Stop Signal two-approach
comparison
- Deleted `distributed-abort-controller` recipe from v5 (native
`AbortController` serialization makes it unnecessary)
- Removed references to distributed-abort-controller from
`cookbook/index.mdx` and `common-patterns/timeouts.mdx`
Co-authored-by: Cursor <cursoragent@cursor.com>
Content moved from docs/content/docs/ to docs/content/docs/v5/ on main
(pre-release channel). Stable branch will use v4/ after backport.
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@karthikscale3@pranaygp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' docs: split v4/v5 content trees and fix version switcher end-to-end by karthikscale3 · Pull Request #1948 · vercel/workflow · GitHub
Skip to content

docs: split v4/v5 content trees and fix version switcher end-to-end - #1948

Merged
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher
May 6, 2026
Merged

docs: split v4/v5 content trees and fix version switcher end-to-end#1948
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher

Conversation

@karthikscale3

Copy link
Copy Markdown
Contributor

Summary

Content restructuring

  • Split docs/content/docs/ into docs/content/docs/v4/ and docs/content/docs/v5/ — each version is now a fully independent content tree with no shared-file coupling or preRelease frontmatter filtering
  • v4 excludes the four v5-only pages (AbortController cancellation docs, abort-signal-timeout error, and serializable-abort-controller internal page)
  • v5 retains all pages; preRelease frontmatter field removed (no longer meaningful with separate folders)
  • Removed AbortController / AbortSignal from the v4 serialization page (moved to v5 only)

Fumadocs source split

  • Added v4docs and v5docs as separate defineDocs() collections in source.config.ts pointing to content/docs/v4 and content/docs/v5
  • source.ts now exports both source (v4) and v5Source (v5), both with baseUrl: /docs

Version routing fixes

  • version-source.ts simplified: removed filterPreReleaseFromNodes / isPreReleaseUrl logic; v4 sidebar uses source, v5 uses v5Source + existing rewriteNodeUrls
  • v4 page.tsx: removed the preRelease guard (v4Source simply doesn't contain those pages)
  • v5 page.tsx: uses v5Source for getPage, generateStaticParams, and generateMetadata; v5Link wrapper rewrites /docs/… hrefs to /v5/docs/… so inline MDX links stay in the v5 context
  • buildVersionUrl now handles /cookbook/… paths with the same version-prefix logic as /docs/…; non-versioned routes (worlds, api) return unchanged

Versioned cookbook

  • Added app/[lang]/v5/cookbook/ layout + page (mirrors v4, uses v5Source and rewriteCookbookUrlForVersion)
  • getCookbookTree accepts a versionPrefix parameter; sidebar URLs are prefixed accordingly (/v5/cookbook/…)
  • cookbook-tree.ts: added skipVersions?: string[] per-recipe field for version-specific exclusions; distributed-abort-controller marked skipVersions: ['v5'] so it shows in v4 but not v5

Version switcher — state & navigation

  • New VersionProvider context (hooks/geistdocs/use-version.tsx) backed by localStorage: URL is the source of truth on versioned pages; localStorage carries the preference across non-versioned pages (worlds, etc.)
  • VersionSwitcher uses useVersion() context; now visible on all pages including cookbook (no longer hidden on non-docs routes)
  • DesktopMenu and MobileMenu read activeVersion from context so "Docs" and "Cookbook" navbar links resolve to the correct version prefix on every page
  • switchVersion does a HEAD probe before navigating; falls back to the versioned cookbook or docs home if the target page doesn't exist in that version — handles both v4-only → v5 (distributed-abort-controller) and v5-only → v4 (cancellation docs) cases

Cookbook content (v5)

  • Rewrote agent-cancellation recipe using a single AbortController + hook pattern; removed the Hard Cancellation vs Stop Signal two-approach comparison and comparison table
  • Deleted distributed-abort-controller recipe from v5 (native AbortController serialization in v5 makes it unnecessary)
  • Removed all references to distributed-abort-controller from cookbook/index.mdx, common-patterns/timeouts.mdx, advanced/meta.json, and the agent-cancellation page

Test plan

  • /docs/… (v4) pages load correctly; v5-only pages (/docs/foundations/cancellation, etc.) return 404
  • /v5/docs/… pages load correctly including the four v5-only pages
  • Version switcher shows correct version on docs, cookbook, and worlds pages
  • Switching v4 → v5 on a docs page navigates to the same page under /v5/docs/…
  • Switching v5 → v4 on a v5-only page falls back to /docs/getting-started
  • Switching versions on /cookbook/… navigates to the same recipe under /v5/cookbook/… (or falls back if not present)
  • Switching v4 → v5 on /cookbook/advanced/distributed-abort-controller falls back to /v5/cookbook
  • Navbar "Docs" and "Cookbook" links resolve to the active version's prefix on all pages
  • Version preference is preserved when navigating from docs → cookbook → back to docs

Made with Cursor

@changeset-bot

changeset-botBot commented May 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b76034f

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

vercelBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

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

workflow with no steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro0.033s (-23.0% 🟢)1.006s (~)0.973s101.00x
💻 LocalExpress0.038s (-14.9% 🟢)1.008s (~)0.970s101.14x
🐘 PostgresNitro0.048s (-49.3% 🟢)1.013s (-2.9%)0.964s101.45x
💻 LocalNext.js (Turbopack)0.051s1.006s0.954s101.55x
🌐 RedisNext.js (Turbopack)0.053s1.005s0.952s101.58x
🐘 PostgresNext.js (Turbopack)0.060s1.013s0.953s101.81x
🌐 MongoDBNext.js (Turbopack)0.099s1.008s0.909s102.98x
🐘 PostgresExpress0.111s (+91.4% 🔺)1.063s (+5.2% 🔺)0.952s103.34x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro0.245s (-40.1% 🟢)2.147s (-14.4% 🟢)1.902s101.00x
▲ VercelExpress0.253s (+7.3% 🔺)2.140s (~)1.887s101.03x
▲ VercelNext.js (Turbopack)0.798s (+217.1% 🔺)2.773s (+18.9% 🔺)1.976s103.25x

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

workflow with 1 step

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.067s (-5.7% 🟢)2.007s (~)0.940s101.00x
💻 LocalExpress1.082s (-3.8%)2.008s (~)0.925s101.01x
🐘 PostgresNitro1.091s (-4.3%)2.009s (~)0.918s101.02x
🌐 RedisNext.js (Turbopack)1.109s2.006s0.898s101.04x
💻 LocalNext.js (Turbopack)1.115s2.006s0.891s101.05x
🐘 PostgresNext.js (Turbopack)1.128s2.009s0.881s101.06x
🐘 PostgresExpress1.130s (-1.4%)2.024s (+0.7%)0.894s101.06x
🌐 MongoDBNext.js (Turbopack)1.168s2.009s0.841s101.09x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express1.579s (-15.8% 🟢)3.777s (-0.8%)2.199s101.00x
▲ VercelNitro1.590s (-59.1% 🟢)3.673s (-37.8% 🟢)2.083s101.01x
▲ VercelNext.js (Turbopack)3.197s (+57.1% 🔺)4.489s (+17.2% 🔺)1.292s102.03x

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

workflow with 10 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro10.427s (-4.7%)11.021s (~)0.594s31.00x
💻 LocalExpress10.465s (-4.2%)11.025s (~)0.559s31.00x
🐘 PostgresNitro10.467s (-3.7%)11.019s (~)0.552s31.00x
🌐 RedisNext.js (Turbopack)10.655s11.023s0.368s31.02x
💻 LocalNext.js (Turbopack)10.666s11.022s0.356s31.02x
🐘 PostgresNext.js (Turbopack)10.756s11.015s0.260s31.03x
🌐 MongoDBNext.js (Turbopack)10.834s11.020s0.186s31.04x
🐘 PostgresExpress10.866s (-0.9%)11.400s (+3.4%)0.534s31.04x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro13.218s (-44.3% 🟢)14.916s (-40.6% 🟢)1.698s31.00x
▲ VercelExpress13.258s (-21.9% 🟢)15.627s (-21.9% 🟢)2.368s21.00x
▲ VercelNext.js (Turbopack)15.143s (-12.6% 🟢)16.855s (-13.1% 🟢)1.712s21.15x

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

workflow with 25 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro13.417s (-10.9% 🟢)14.027s (-12.5% 🟢)0.610s51.00x
🐘 PostgresNitro13.484s (-7.6% 🟢)14.019s (-6.7% 🟢)0.536s51.00x
💻 LocalExpress13.637s (-8.9% 🟢)14.030s (-6.7% 🟢)0.392s51.02x
🌐 RedisNext.js (Turbopack)14.069s14.828s0.759s51.05x
💻 LocalNext.js (Turbopack)14.090s15.031s0.941s41.05x
🌐 MongoDBNext.js (Turbopack)14.228s15.025s0.798s41.06x
🐘 PostgresNext.js (Turbopack)14.238s15.020s0.782s41.06x
🐘 PostgresExpress14.414s (-1.2%)15.017s (~)0.604s41.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro21.299s (-67.0% 🟢)23.458s (-64.8% 🟢)2.159s31.00x
▲ VercelExpress21.953s (-56.4% 🟢)24.119s (-54.1% 🟢)2.166s31.03x
▲ VercelNext.js (Turbopack)22.605s (-57.0% 🟢)24.322s (-55.5% 🟢)1.717s31.06x

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

workflow with 50 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro11.799s (-29.7% 🟢)12.022s (-29.4% 🟢)0.222s81.00x
🐘 PostgresNitro12.001s (-14.1% 🟢)12.392s (-13.4% 🟢)0.390s81.02x
💻 LocalExpress12.214s (-26.4% 🟢)13.027s (-23.5% 🟢)0.813s71.04x
🌐 RedisNext.js (Turbopack)12.955s13.311s0.355s71.10x
💻 LocalNext.js (Turbopack)13.113s14.026s0.913s71.11x
🐘 PostgresNext.js (Turbopack)13.257s14.016s0.759s71.12x
🌐 MongoDBNext.js (Turbopack)13.339s14.025s0.687s71.13x
🐘 PostgresExpress16.095s (+14.9% 🔺)16.539s (+13.3% 🔺)0.444s61.36x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro31.335s (-92.6% 🟢)33.852s (-92.0% 🟢)2.517s31.00x
▲ VercelExpress33.300s (-72.5% 🟢)35.430s (-71.3% 🟢)2.130s31.06x
▲ VercelNext.js (Turbopack)33.643s (-91.5% 🟢)35.813s (-90.9% 🟢)2.170s31.07x

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

Promise.all with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.151s (-9.7% 🟢)2.007s (~)0.856s151.00x
💻 LocalNitro1.170s (-28.3% 🟢)2.005s (-3.3%)0.836s151.02x
💻 LocalExpress1.182s (-20.6% 🟢)2.007s (~)0.825s151.03x
🐘 PostgresNext.js (Turbopack)1.220s2.007s0.786s151.06x
🌐 RedisNext.js (Turbopack)1.244s2.006s0.762s151.08x
💻 LocalNext.js (Turbopack)1.280s2.006s0.726s151.11x
🐘 PostgresExpress1.443s (+14.5% 🔺)2.184s (+8.7% 🔺)0.742s141.25x
🌐 MongoDBNext.js (Turbopack)2.044s2.918s0.874s111.78x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.481s (-13.2% 🟢)4.024s (-13.0% 🟢)1.543s81.00x
▲ VercelNitro2.531s (-10.2% 🟢)4.150s (-4.0%)1.619s81.02x
▲ VercelNext.js (Turbopack)3.892s (+14.6% 🔺)5.639s (+14.3% 🔺)1.747s61.57x

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

Promise.all with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.224s (-48.0% 🟢)2.007s (-33.3% 🟢)0.783s151.00x
🐘 PostgresNext.js (Turbopack)1.384s2.007s0.623s151.13x
💻 LocalExpress1.642s (-44.4% 🟢)2.007s (-41.9% 🟢)0.364s151.34x
🐘 PostgresExpress1.690s (-28.4% 🟢)2.263s (-24.8% 🟢)0.573s141.38x
💻 LocalNitro1.693s (-46.1% 🟢)2.005s (-48.4% 🟢)0.312s151.38x
💻 LocalNext.js (Turbopack)1.848s2.073s0.226s151.51x
🌐 RedisNext.js (Turbopack)2.359s3.008s0.649s101.93x
🌐 MongoDBNext.js (Turbopack)3.611s4.009s0.398s82.95x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.862s (-4.7%)5.659s (-4.4%)1.797s61.00x
▲ VercelExpress4.351s (+20.2% 🔺)5.741s (+12.3% 🔺)1.391s61.13x
▲ VercelNext.js (Turbopack)5.397s (-24.0% 🟢)7.101s (-20.3% 🟢)1.704s51.40x

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

Promise.all with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.372s (-60.6% 🟢)2.008s (-49.9% 🟢)0.636s151.00x
🐘 PostgresNext.js (Turbopack)1.764s2.074s0.310s151.29x
🐘 PostgresExpress2.273s (-34.8% 🟢)3.078s (-23.3% 🟢)0.805s101.66x
🌐 RedisNext.js (Turbopack)3.639s4.010s0.370s82.65x
💻 LocalNitro4.502s (-46.1% 🟢)5.011s (-44.4% 🟢)0.510s63.28x
💻 LocalExpress4.545s (-45.5% 🟢)5.014s (-44.5% 🟢)0.469s73.31x
💻 LocalNext.js (Turbopack)5.644s6.215s0.571s54.11x
🌐 MongoDBNext.js (Turbopack)6.310s7.015s0.705s54.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.332s (+51.2% 🔺)6.946s (+25.5% 🔺)1.614s51.00x
▲ VercelNext.js (Turbopack)6.496s (-27.1% 🟢)8.168s (-25.5% 🟢)1.672s41.22x
▲ VercelExpress7.267s (+71.4% 🔺)9.101s (+48.5% 🔺)1.834s41.36x

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

Promise.race with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.149s (-8.6% 🟢)2.007s (~)0.858s151.00x
🌐 RedisNext.js (Turbopack)1.228s2.006s0.778s151.07x
🐘 PostgresNext.js (Turbopack)1.246s2.008s0.762s151.08x
💻 LocalNext.js (Turbopack)1.328s2.006s0.678s151.16x
💻 LocalNitro1.387s (-25.7% 🟢)2.006s (-14.3% 🟢)0.619s151.21x
🐘 PostgresExpress1.481s (+17.8% 🔺)2.163s (+7.7% 🔺)0.682s141.29x
💻 LocalExpress1.482s (-21.7% 🟢)2.007s (-15.1% 🟢)0.525s151.29x
🌐 MongoDBNext.js (Turbopack)2.031s2.827s0.796s111.77x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro2.354s (-4.2%)3.765s (-9.7% 🟢)1.411s81.00x
▲ VercelExpress2.501s (-3.1%)3.783s (-13.0% 🟢)1.283s81.06x
▲ VercelNext.js (Turbopack)3.502s (+19.5% 🔺)5.206s (+12.1% 🔺)1.704s71.49x

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

Promise.race with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.223s (-47.7% 🟢)2.009s (-33.3% 🟢)0.785s151.00x
🐘 PostgresNext.js (Turbopack)1.405s2.008s0.603s151.15x
🐘 PostgresExpress1.673s (-28.6% 🟢)2.326s (-22.8% 🟢)0.653s131.37x
💻 LocalExpress1.769s (-43.5% 🟢)2.151s (-42.8% 🟢)0.381s141.45x
💻 LocalNitro1.856s (-39.4% 🟢)2.222s (-42.8% 🟢)0.366s141.52x
💻 LocalNext.js (Turbopack)2.011s2.591s0.579s121.64x
🌐 RedisNext.js (Turbopack)2.353s3.008s0.655s101.92x
🌐 MongoDBNext.js (Turbopack)3.583s4.010s0.428s82.93x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.537s (+9.4% 🔺)5.179s (+2.0%)1.642s61.00x
▲ VercelExpress3.550s (+11.2% 🔺)5.397s (+12.6% 🔺)1.847s61.00x
▲ VercelNext.js (Turbopack)5.661s (+80.1% 🔺)6.980s (+54.4% 🔺)1.319s51.60x

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

Promise.race with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.375s (-60.5% 🟢)2.008s (-49.9% 🟢)0.633s151.00x
🐘 PostgresNext.js (Turbopack)1.637s2.075s0.438s151.19x
🐘 PostgresExpress2.311s (-34.0% 🟢)3.176s (-20.8% 🟢)0.865s101.68x
🌐 RedisNext.js (Turbopack)3.594s4.010s0.416s82.61x
💻 LocalExpress4.730s (-46.3% 🟢)5.346s (-42.3% 🟢)0.616s63.44x
💻 LocalNitro5.397s (-41.0% 🟢)6.014s (-40.0% 🟢)0.617s53.92x
💻 LocalNext.js (Turbopack)5.562s6.014s0.453s54.04x
🌐 MongoDBNext.js (Turbopack)6.355s7.014s0.659s54.62x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro4.714s (-7.4% 🟢)6.592s (-3.3%)1.878s51.00x
▲ VercelNext.js (Turbopack)5.926s (-12.3% 🟢)8.154s (-4.6%)2.228s41.26x
▲ VercelExpress6.059s (-5.6% 🟢)8.015s (-2.0%)1.956s41.29x

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

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.437s (-46.7% 🟢)1.007s (~)0.569s601.00x
💻 LocalNitro0.459s (-53.2% 🟢)1.004s (-8.2% 🟢)0.544s601.05x
💻 LocalExpress0.567s (-42.4% 🟢)1.040s (-3.4%)0.473s581.30x
🌐 RedisNext.js (Turbopack)0.621s1.004s0.383s601.42x
🐘 PostgresNext.js (Turbopack)0.667s1.006s0.339s601.53x
🌐 MongoDBNext.js (Turbopack)0.730s1.006s0.276s601.67x
💻 LocalNext.js (Turbopack)0.737s1.005s0.268s601.68x
🐘 PostgresExpress0.905s (+7.9% 🔺)1.370s (+33.9% 🔺)0.465s452.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express4.958s (-73.9% 🟢)6.669s (-68.7% 🟢)1.711s91.00x
▲ VercelNitro5.116s (-76.8% 🟢)6.704s (-72.1% 🟢)1.588s101.03x
▲ VercelNext.js (Turbopack)7.017s (-51.6% 🟢)8.729s (-45.7% 🟢)1.711s71.42x

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

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.022s (-47.0% 🟢)1.585s (-24.5% 🟢)0.564s571.00x
💻 LocalNitro1.161s (-61.7% 🟢)2.005s (-46.6% 🟢)0.844s451.14x
💻 LocalExpress1.307s (-56.7% 🟢)2.006s (-44.0% 🟢)0.700s451.28x
🌐 RedisNext.js (Turbopack)1.492s2.006s0.514s451.46x
🐘 PostgresNext.js (Turbopack)1.604s2.008s0.404s451.57x
💻 LocalNext.js (Turbopack)1.792s2.006s0.214s451.75x
🌐 MongoDBNext.js (Turbopack)1.842s2.007s0.166s451.80x
🐘 PostgresExpress2.094s (+5.9% 🔺)2.560s (+13.4% 🔺)0.467s362.05x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro12.742s (-67.7% 🟢)14.987s (-63.7% 🟢)2.246s71.00x
▲ VercelExpress13.193s (-61.8% 🟢)14.863s (-59.6% 🟢)1.670s71.04x
▲ VercelNext.js (Turbopack)14.895s (-70.1% 🟢)16.716s (-67.7% 🟢)1.822s61.17x

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

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro2.012s (-51.0% 🟢)2.427s (-47.3% 🟢)0.416s501.00x
💻 LocalNitro2.667s (-71.3% 🟢)3.033s (-69.7% 🟢)0.366s401.33x
💻 LocalExpress2.912s (-68.4% 🟢)3.252s (-67.5% 🟢)0.340s371.45x
🌐 RedisNext.js (Turbopack)2.984s3.250s0.267s371.48x
🐘 PostgresNext.js (Turbopack)3.270s4.045s0.775s301.63x
💻 LocalNext.js (Turbopack)3.857s4.075s0.217s301.92x
🐘 PostgresExpress4.078s (+2.2%)4.502s (+3.0%)0.424s272.03x
🌐 MongoDBNext.js (Turbopack)4.220s5.012s0.792s242.10x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro38.819s (-59.9% 🟢)40.985s (-58.4% 🟢)2.166s31.00x
▲ VercelExpress39.658s (-69.5% 🟢)41.705s (-68.4% 🟢)2.048s31.02x
▲ VercelNext.js (Turbopack)46.146s (-56.9% 🟢)47.530s (-56.4% 🟢)1.383s31.19x

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

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.182s (-35.9% 🟢)1.006s (~)0.824s601.00x
🌐 RedisNext.js (Turbopack)0.237s1.004s0.767s601.30x
🐘 PostgresNext.js (Turbopack)0.241s1.006s0.765s601.33x
💻 LocalNitro0.447s (-26.1% 🟢)1.004s (-1.7%)0.557s602.46x
💻 LocalExpress0.478s (-14.7% 🟢)1.005s (~)0.527s602.63x
🐘 PostgresExpress0.511s (+80.8% 🔺)1.148s (+14.0% 🔺)0.637s532.81x
💻 LocalNext.js (Turbopack)0.581s1.005s0.423s603.20x
🌐 MongoDBNext.js (Turbopack)1.036s1.855s0.819s335.70x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.028s (+3.8%)3.796s (+4.4%)1.768s161.00x
▲ VercelNitro2.293s (+38.0% 🔺)4.077s (+21.7% 🔺)1.785s151.13x
▲ VercelNext.js (Turbopack)3.973s (+96.4% 🔺)5.530s (+45.8% 🔺)1.557s111.96x

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

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.310s (-37.4% 🟢)1.006s (~)0.696s901.00x
🌐 RedisNext.js (Turbopack)0.407s1.004s0.597s901.31x
🐘 PostgresNext.js (Turbopack)0.482s1.007s0.524s901.55x
🐘 PostgresExpress0.818s (+60.4% 🔺)1.341s (+33.3% 🔺)0.523s682.63x
💻 LocalExpress2.184s (-13.1% 🟢)3.010s (~)0.825s307.04x
💻 LocalNitro2.198s (-13.4% 🟢)2.944s (-2.2%)0.746s317.08x
🌐 MongoDBNext.js (Turbopack)2.606s3.007s0.400s308.39x
💻 LocalNext.js (Turbopack)2.614s3.149s0.535s298.42x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Next.js (Turbopack)6.797s (+92.3% 🔺)8.510s (+63.9% 🔺)1.713s111.00x
▲ VercelNitro7.928s (+145.8% 🔺)9.974s (+106.8% 🔺)2.046s101.17x
▲ VercelExpress8.062s (+164.6% 🔺)9.804s (+103.9% 🔺)1.742s101.19x

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

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.662s (-16.3% 🟢)1.006s (~)0.344s1201.00x
🌐 RedisNext.js (Turbopack)0.751s1.012s0.261s1191.14x
🐘 PostgresNext.js (Turbopack)0.981s1.521s0.539s801.48x
🐘 PostgresExpress1.706s (+108.3% 🔺)2.295s (+125.6% 🔺)0.589s532.58x
🌐 MongoDBNext.js (Turbopack)5.391s6.014s0.623s208.14x
💻 LocalNitro9.825s (-12.2% 🟢)10.446s (-10.4% 🟢)0.621s1214.85x
💻 LocalExpress10.179s (-9.0% 🟢)10.783s (-9.7% 🟢)0.604s1215.38x
💻 LocalNext.js (Turbopack)11.645s12.330s0.685s1017.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express18.117s (+144.2% 🔺)20.127s (+117.7% 🔺)2.009s61.00x
▲ VercelNext.js (Turbopack)19.231s (+86.2% 🔺)21.009s (+71.0% 🔺)1.778s71.06x
▲ VercelNitro23.043s (+198.4% 🔺)25.291s (+169.0% 🔺)2.248s51.27x

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

Stream Benchmarks(includes TTFB metrics)
workflow with stream

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.129s (+428.1% 🔺)2.005s (+99.6% 🔺)0.011s (-14.4% 🟢)2.018s (+98.0% 🔺)0.889s101.00x
🐘 PostgresNitro1.138s (+455.3% 🔺)2.001s (+100.2% 🔺)0.001s (-13.3% 🟢)2.010s (+98.7% 🔺)0.871s101.01x
💻 LocalExpress1.143s (+474.3% 🔺)2.006s (+99.7% 🔺)0.010s (-15.7% 🟢)2.019s (+98.3% 🔺)0.875s101.01x
💻 LocalNext.js (Turbopack)1.190s2.003s0.013s2.020s0.830s101.05x
🐘 PostgresNext.js (Turbopack)1.195s2.001s0.002s2.011s0.815s101.06x
🐘 PostgresExpress1.514s (+638.4% 🔺)2.094s (+109.7% 🔺)0.378s (+23500.0% 🔺)2.508s (+148.0% 🔺)0.994s101.34x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.104s (-16.0% 🟢)3.360s (-17.8% 🟢)1.769s (+84.1% 🔺)5.626s (+0.6%)3.521s101.00x
▲ VercelNitro2.336s (-39.0% 🟢)3.612s (-31.6% 🟢)1.861s (+150.7% 🔺)6.014s (-7.2% 🟢)3.678s101.11x
▲ VercelNext.js (Turbopack)5.134s (-25.1% 🟢)5.213s (-39.7% 🟢)1.098s (+73.8% 🔺)7.870s (-19.6% 🟢)2.735s102.44x

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

stream pipeline with 5 transform steps (1MB)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.538s (+146.5% 🔺)2.001s (+98.8% 🔺)0.004s (-12.1% 🟢)2.025s (+98.0% 🔺)0.487s301.00x
💻 LocalExpress1.588s (+109.7% 🔺)2.011s (+95.5% 🔺)0.012s (+25.7% 🔺)2.026s (+94.8% 🔺)0.438s301.03x
🐘 PostgresNext.js (Turbopack)1.705s2.010s0.004s2.026s0.321s301.11x
💻 LocalNext.js (Turbopack)1.866s2.011s0.010s2.203s0.337s281.21x
💻 LocalNitro2.164s (+158.1% 🔺)2.010s (+98.6% 🔺)0.009s (-4.0%)2.675s (+139.7% 🔺)0.510s231.41x
🐘 PostgresExpress2.444s (+288.0% 🔺)2.731s (+171.4% 🔺)0.003s (-19.3% 🟢)2.767s (+170.4% 🔺)0.322s221.59x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express5.877s (-9.6% 🟢)7.234s (-9.7% 🟢)0.232s (-43.4% 🟢)7.955s (-10.0% 🟢)2.078s81.00x
▲ VercelNitro5.894s (-80.0% 🟢)7.169s (-76.7% 🟢)0.258s (+130.4% 🔺)7.895s (-75.2% 🟢)2.001s81.00x
▲ VercelNext.js (Turbopack)13.642s (-19.4% 🟢)13.146s (-27.9% 🟢)0.318s (+50.3% 🔺)15.510s (-18.1% 🟢)1.868s42.32x

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

10 parallel streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.694s (-28.3% 🟢)1.030s (-17.5% 🟢)0.000s (-57.9% 🟢)1.060s (-15.7% 🟢)0.366s571.00x
🐘 PostgresNext.js (Turbopack)0.798s1.072s0.000s1.082s0.284s561.15x
💻 LocalNext.js (Turbopack)1.451s2.014s0.000s2.017s0.566s302.09x
💻 LocalExpress1.475s (+20.4% 🔺)2.015s (~)0.000s (~)2.018s (~)0.543s302.12x
💻 LocalNitro1.486s (+21.5% 🔺)2.014s (~)0.000s (+364.3% 🔺)2.195s (+8.6% 🔺)0.709s282.14x
🐘 PostgresExpress2.079s (+116.4% 🔺)2.453s (+92.0% 🔺)0.000s (-100.0% 🟢)2.522s (+93.1% 🔺)0.443s242.99x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express3.871s (+3.5%)5.345s (+4.7%)0.003s (+1500.0% 🔺)5.771s (+4.4%)1.900s111.00x
▲ VercelNitro3.911s (+28.2% 🔺)5.386s (+22.6% 🔺)0.000s (+254.5% 🔺)5.924s (+23.2% 🔺)2.013s111.01x
▲ VercelNext.js (Turbopack)6.210s (-39.0% 🟢)6.441s (-44.1% 🟢)0.001s (+Infinity% 🔺)7.762s (-35.6% 🟢)1.552s81.60x

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

fan-out fan-in 10 streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.461s (-18.5% 🟢)2.141s (~)0.000s (~)2.154s (-1.0%)0.693s281.00x
🐘 PostgresNext.js (Turbopack)1.801s2.348s0.000s2.356s0.554s261.23x
💻 LocalNext.js (Turbopack)2.779s3.293s0.001s3.298s0.519s191.90x
💻 LocalNitro2.995s (-11.6% 🟢)3.735s (-7.4% 🟢)0.000s (-89.0% 🟢)3.737s (-7.4% 🟢)0.743s172.05x
💻 LocalExpress3.279s (-5.4% 🟢)3.840s (-4.8%)0.001s (-21.9% 🟢)3.847s (-4.7%)0.568s162.24x
🐘 PostgresExpress3.897s (+119.9% 🔺)4.233s (+94.4% 🔺)0.000s (+Infinity% 🔺)4.354s (+98.0% 🔺)0.458s142.67x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.840s (+42.7% 🔺)7.408s (+37.8% 🔺)0.000s (-8.3% 🟢)7.847s (+35.4% 🔺)2.007s81.00x
▲ VercelExpress5.876s (+28.1% 🔺)7.054s (+17.1% 🔺)0.001s (+Infinity% 🔺)7.514s (+16.4% 🔺)1.638s81.01x
▲ VercelNext.js (Turbopack)8.242s (+46.7% 🔺)9.359s (+34.0% 🔺)0.000s (+33.3% 🔺)10.005s (+32.7% 🔺)1.763s61.41x

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

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World🥇 Fastest FrameworkWins
💻 LocalNitro13/21
🐘 PostgresNitro21/21
▲ VercelNitro12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework🥇 Fastest WorldWins
Express💻 Local15/21
Next.js (Turbopack)🌐 Redis11/21
Nitro🐘 Postgres15/21
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


⚠️Community world benchmarks failed (non-blocking):

  • Community Worlds: failure

Check the workflow run for details.

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

PassedFailedSkippedTotal
✅ ▲ Vercel Production120002191419
✅ 💻 Local Development158702191806
✅ 📦 Local Production158702191806
✅ 🐘 Local Postgres158702191806
✅ 🪟 Windows12900129
✅ 📋 Other7270176903
Total6817010527869

Details by Category

✅ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro103026
✅ example103026
✅ express103026
✅ fastify103026
✅ hono103026
✅ nextjs-turbopack12702
✅ nextjs-webpack12702
✅ nitro103026
✅ nuxt103026
✅ sveltekit12207
✅ vite103026
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🪟 Windows
AppPassedFailedSkipped
✅ nextjs-turbopack12900
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable104025
✅ e2e-local-dev-tanstack-start-104025
✅ e2e-local-postgres-nest-stable104025
✅ e2e-local-postgres-tanstack-start-104025
✅ e2e-local-prod-nest-stable104025
✅ e2e-local-prod-tanstack-start-104025
✅ e2e-vercel-prod-tanstack-start103026

📋 View full workflow run

@karthikscale3
karthikscale3force-pushed the karthik/fix-doc-switcher branch from 42d3fd0 to 4f0c239CompareMay 6, 2026 04:47
## Content restructuring
- Split `docs/content/docs/` into `docs/content/docs/v4/` and
`docs/content/docs/v5/` so each version is a fully independent
content tree with no shared-file coupling
- v4 excludes the four pages that are v5-only (AbortController
cancellation docs and the serializable-abort-controller internal page)
- v5 retains all pages; `preRelease` frontmatter field removed (no
longer needed now that each version is its own folder)
- Removed `AbortController` / `AbortSignal` from v4 serialization page
(section moved to v5 only)
## Fumadocs source
- Added `v4docs` and `v5docs` as separate `defineDocs()` collections in
`source.config.ts`; shared `docsSchema` (no more `preRelease` field)
- `source.ts` exports both `source` (v4, `baseUrl: /docs`) and
`v5Source` (v5, same base URL)
## Version routing
- `version-source.ts` simplified: `filterPreReleaseFromNodes` and
`isPreReleaseUrl` logic removed; v4 tree uses `source`, v5 tree uses
`v5Source` + `rewriteNodeUrls`
- v4 `page.tsx`: removed `preRelease` guard (v4Source has no such pages)
- v5 `page.tsx`: uses `v5Source` for `getPage` / `generateStaticParams`
/ `generateMetadata`; `v5Link` wrapper rewrites `/docs/…` hrefs to
`/v5/docs/…` so inline MDX links stay in the v5 context
## Versioned cookbook
- Added `app/[lang]/v5/cookbook/` layout + page (mirrors v4 but uses
`v5Source`, `rewriteCookbookUrlForVersion`, and `V5CookbookLink`)
- `getCookbookTree` accepts a `versionPrefix` parameter; sidebar URLs
are prefixed accordingly (`/v5/cookbook/…`)
- `cookbook-tree.ts`: added `skipVersions?: string[]` per-recipe field
for version-specific exclusions; `distributed-abort-controller` is
marked `skipVersions: ['v5']`
## Version switcher — state & navigation
- New `VersionProvider` context (`hooks/geistdocs/use-version.tsx`)
backed by `localStorage`: URL is source of truth on versioned pages,
`localStorage` carries the preference across non-versioned pages
(cookbook overview, worlds, etc.)
- `VersionSwitcher` uses `useVersion()` context instead of URL-only
detection; now visible on all pages including cookbook
- `DesktopMenu` and `MobileMenu` use `activeVersion` from context so
the "Docs" and "Cookbook" navbar links resolve to the correct version
prefix on every page
- `buildVersionUrl` expanded to handle `/cookbook/…` paths alongside
`/docs/…`; non-versioned routes (worlds, api) return unchanged
- `switchVersion` does a `HEAD` probe before navigating; falls back to
the versioned cookbook or docs home if the target page doesn't exist
in that version (handles v4-only → v5 and v5-only → v4 cases)
## Cookbook content (v5)
- Rewrote `agent-cancellation` recipe using a single `AbortController`
pattern; removed Hard Cancellation vs Stop Signal two-approach
comparison
- Deleted `distributed-abort-controller` recipe from v5 (native
`AbortController` serialization makes it unnecessary)
- Removed references to distributed-abort-controller from
`cookbook/index.mdx` and `common-patterns/timeouts.mdx`
Co-authored-by: Cursor <cursoragent@cursor.com>
Content moved from docs/content/docs/ to docs/content/docs/v5/ on main
(pre-release channel). Stable branch will use v4/ after backport.
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@karthikscale3@pranaygp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' docs: split v4/v5 content trees and fix version switcher end-to-end by karthikscale3 · Pull Request #1948 · vercel/workflow · GitHub
Skip to content

docs: split v4/v5 content trees and fix version switcher end-to-end - #1948

Merged
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher
May 6, 2026
Merged

docs: split v4/v5 content trees and fix version switcher end-to-end#1948
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher

Conversation

@karthikscale3

Copy link
Copy Markdown
Contributor

Summary

Content restructuring

  • Split docs/content/docs/ into docs/content/docs/v4/ and docs/content/docs/v5/ — each version is now a fully independent content tree with no shared-file coupling or preRelease frontmatter filtering
  • v4 excludes the four v5-only pages (AbortController cancellation docs, abort-signal-timeout error, and serializable-abort-controller internal page)
  • v5 retains all pages; preRelease frontmatter field removed (no longer meaningful with separate folders)
  • Removed AbortController / AbortSignal from the v4 serialization page (moved to v5 only)

Fumadocs source split

  • Added v4docs and v5docs as separate defineDocs() collections in source.config.ts pointing to content/docs/v4 and content/docs/v5
  • source.ts now exports both source (v4) and v5Source (v5), both with baseUrl: /docs

Version routing fixes

  • version-source.ts simplified: removed filterPreReleaseFromNodes / isPreReleaseUrl logic; v4 sidebar uses source, v5 uses v5Source + existing rewriteNodeUrls
  • v4 page.tsx: removed the preRelease guard (v4Source simply doesn't contain those pages)
  • v5 page.tsx: uses v5Source for getPage, generateStaticParams, and generateMetadata; v5Link wrapper rewrites /docs/… hrefs to /v5/docs/… so inline MDX links stay in the v5 context
  • buildVersionUrl now handles /cookbook/… paths with the same version-prefix logic as /docs/…; non-versioned routes (worlds, api) return unchanged

Versioned cookbook

  • Added app/[lang]/v5/cookbook/ layout + page (mirrors v4, uses v5Source and rewriteCookbookUrlForVersion)
  • getCookbookTree accepts a versionPrefix parameter; sidebar URLs are prefixed accordingly (/v5/cookbook/…)
  • cookbook-tree.ts: added skipVersions?: string[] per-recipe field for version-specific exclusions; distributed-abort-controller marked skipVersions: ['v5'] so it shows in v4 but not v5

Version switcher — state & navigation

  • New VersionProvider context (hooks/geistdocs/use-version.tsx) backed by localStorage: URL is the source of truth on versioned pages; localStorage carries the preference across non-versioned pages (worlds, etc.)
  • VersionSwitcher uses useVersion() context; now visible on all pages including cookbook (no longer hidden on non-docs routes)
  • DesktopMenu and MobileMenu read activeVersion from context so "Docs" and "Cookbook" navbar links resolve to the correct version prefix on every page
  • switchVersion does a HEAD probe before navigating; falls back to the versioned cookbook or docs home if the target page doesn't exist in that version — handles both v4-only → v5 (distributed-abort-controller) and v5-only → v4 (cancellation docs) cases

Cookbook content (v5)

  • Rewrote agent-cancellation recipe using a single AbortController + hook pattern; removed the Hard Cancellation vs Stop Signal two-approach comparison and comparison table
  • Deleted distributed-abort-controller recipe from v5 (native AbortController serialization in v5 makes it unnecessary)
  • Removed all references to distributed-abort-controller from cookbook/index.mdx, common-patterns/timeouts.mdx, advanced/meta.json, and the agent-cancellation page

Test plan

  • /docs/… (v4) pages load correctly; v5-only pages (/docs/foundations/cancellation, etc.) return 404
  • /v5/docs/… pages load correctly including the four v5-only pages
  • Version switcher shows correct version on docs, cookbook, and worlds pages
  • Switching v4 → v5 on a docs page navigates to the same page under /v5/docs/…
  • Switching v5 → v4 on a v5-only page falls back to /docs/getting-started
  • Switching versions on /cookbook/… navigates to the same recipe under /v5/cookbook/… (or falls back if not present)
  • Switching v4 → v5 on /cookbook/advanced/distributed-abort-controller falls back to /v5/cookbook
  • Navbar "Docs" and "Cookbook" links resolve to the active version's prefix on all pages
  • Version preference is preserved when navigating from docs → cookbook → back to docs

Made with Cursor

@changeset-bot

changeset-botBot commented May 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b76034f

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

vercelBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

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

workflow with no steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro0.033s (-23.0% 🟢)1.006s (~)0.973s101.00x
💻 LocalExpress0.038s (-14.9% 🟢)1.008s (~)0.970s101.14x
🐘 PostgresNitro0.048s (-49.3% 🟢)1.013s (-2.9%)0.964s101.45x
💻 LocalNext.js (Turbopack)0.051s1.006s0.954s101.55x
🌐 RedisNext.js (Turbopack)0.053s1.005s0.952s101.58x
🐘 PostgresNext.js (Turbopack)0.060s1.013s0.953s101.81x
🌐 MongoDBNext.js (Turbopack)0.099s1.008s0.909s102.98x
🐘 PostgresExpress0.111s (+91.4% 🔺)1.063s (+5.2% 🔺)0.952s103.34x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro0.245s (-40.1% 🟢)2.147s (-14.4% 🟢)1.902s101.00x
▲ VercelExpress0.253s (+7.3% 🔺)2.140s (~)1.887s101.03x
▲ VercelNext.js (Turbopack)0.798s (+217.1% 🔺)2.773s (+18.9% 🔺)1.976s103.25x

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

workflow with 1 step

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.067s (-5.7% 🟢)2.007s (~)0.940s101.00x
💻 LocalExpress1.082s (-3.8%)2.008s (~)0.925s101.01x
🐘 PostgresNitro1.091s (-4.3%)2.009s (~)0.918s101.02x
🌐 RedisNext.js (Turbopack)1.109s2.006s0.898s101.04x
💻 LocalNext.js (Turbopack)1.115s2.006s0.891s101.05x
🐘 PostgresNext.js (Turbopack)1.128s2.009s0.881s101.06x
🐘 PostgresExpress1.130s (-1.4%)2.024s (+0.7%)0.894s101.06x
🌐 MongoDBNext.js (Turbopack)1.168s2.009s0.841s101.09x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express1.579s (-15.8% 🟢)3.777s (-0.8%)2.199s101.00x
▲ VercelNitro1.590s (-59.1% 🟢)3.673s (-37.8% 🟢)2.083s101.01x
▲ VercelNext.js (Turbopack)3.197s (+57.1% 🔺)4.489s (+17.2% 🔺)1.292s102.03x

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

workflow with 10 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro10.427s (-4.7%)11.021s (~)0.594s31.00x
💻 LocalExpress10.465s (-4.2%)11.025s (~)0.559s31.00x
🐘 PostgresNitro10.467s (-3.7%)11.019s (~)0.552s31.00x
🌐 RedisNext.js (Turbopack)10.655s11.023s0.368s31.02x
💻 LocalNext.js (Turbopack)10.666s11.022s0.356s31.02x
🐘 PostgresNext.js (Turbopack)10.756s11.015s0.260s31.03x
🌐 MongoDBNext.js (Turbopack)10.834s11.020s0.186s31.04x
🐘 PostgresExpress10.866s (-0.9%)11.400s (+3.4%)0.534s31.04x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro13.218s (-44.3% 🟢)14.916s (-40.6% 🟢)1.698s31.00x
▲ VercelExpress13.258s (-21.9% 🟢)15.627s (-21.9% 🟢)2.368s21.00x
▲ VercelNext.js (Turbopack)15.143s (-12.6% 🟢)16.855s (-13.1% 🟢)1.712s21.15x

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

workflow with 25 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro13.417s (-10.9% 🟢)14.027s (-12.5% 🟢)0.610s51.00x
🐘 PostgresNitro13.484s (-7.6% 🟢)14.019s (-6.7% 🟢)0.536s51.00x
💻 LocalExpress13.637s (-8.9% 🟢)14.030s (-6.7% 🟢)0.392s51.02x
🌐 RedisNext.js (Turbopack)14.069s14.828s0.759s51.05x
💻 LocalNext.js (Turbopack)14.090s15.031s0.941s41.05x
🌐 MongoDBNext.js (Turbopack)14.228s15.025s0.798s41.06x
🐘 PostgresNext.js (Turbopack)14.238s15.020s0.782s41.06x
🐘 PostgresExpress14.414s (-1.2%)15.017s (~)0.604s41.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro21.299s (-67.0% 🟢)23.458s (-64.8% 🟢)2.159s31.00x
▲ VercelExpress21.953s (-56.4% 🟢)24.119s (-54.1% 🟢)2.166s31.03x
▲ VercelNext.js (Turbopack)22.605s (-57.0% 🟢)24.322s (-55.5% 🟢)1.717s31.06x

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

workflow with 50 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro11.799s (-29.7% 🟢)12.022s (-29.4% 🟢)0.222s81.00x
🐘 PostgresNitro12.001s (-14.1% 🟢)12.392s (-13.4% 🟢)0.390s81.02x
💻 LocalExpress12.214s (-26.4% 🟢)13.027s (-23.5% 🟢)0.813s71.04x
🌐 RedisNext.js (Turbopack)12.955s13.311s0.355s71.10x
💻 LocalNext.js (Turbopack)13.113s14.026s0.913s71.11x
🐘 PostgresNext.js (Turbopack)13.257s14.016s0.759s71.12x
🌐 MongoDBNext.js (Turbopack)13.339s14.025s0.687s71.13x
🐘 PostgresExpress16.095s (+14.9% 🔺)16.539s (+13.3% 🔺)0.444s61.36x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro31.335s (-92.6% 🟢)33.852s (-92.0% 🟢)2.517s31.00x
▲ VercelExpress33.300s (-72.5% 🟢)35.430s (-71.3% 🟢)2.130s31.06x
▲ VercelNext.js (Turbopack)33.643s (-91.5% 🟢)35.813s (-90.9% 🟢)2.170s31.07x

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

Promise.all with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.151s (-9.7% 🟢)2.007s (~)0.856s151.00x
💻 LocalNitro1.170s (-28.3% 🟢)2.005s (-3.3%)0.836s151.02x
💻 LocalExpress1.182s (-20.6% 🟢)2.007s (~)0.825s151.03x
🐘 PostgresNext.js (Turbopack)1.220s2.007s0.786s151.06x
🌐 RedisNext.js (Turbopack)1.244s2.006s0.762s151.08x
💻 LocalNext.js (Turbopack)1.280s2.006s0.726s151.11x
🐘 PostgresExpress1.443s (+14.5% 🔺)2.184s (+8.7% 🔺)0.742s141.25x
🌐 MongoDBNext.js (Turbopack)2.044s2.918s0.874s111.78x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.481s (-13.2% 🟢)4.024s (-13.0% 🟢)1.543s81.00x
▲ VercelNitro2.531s (-10.2% 🟢)4.150s (-4.0%)1.619s81.02x
▲ VercelNext.js (Turbopack)3.892s (+14.6% 🔺)5.639s (+14.3% 🔺)1.747s61.57x

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

Promise.all with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.224s (-48.0% 🟢)2.007s (-33.3% 🟢)0.783s151.00x
🐘 PostgresNext.js (Turbopack)1.384s2.007s0.623s151.13x
💻 LocalExpress1.642s (-44.4% 🟢)2.007s (-41.9% 🟢)0.364s151.34x
🐘 PostgresExpress1.690s (-28.4% 🟢)2.263s (-24.8% 🟢)0.573s141.38x
💻 LocalNitro1.693s (-46.1% 🟢)2.005s (-48.4% 🟢)0.312s151.38x
💻 LocalNext.js (Turbopack)1.848s2.073s0.226s151.51x
🌐 RedisNext.js (Turbopack)2.359s3.008s0.649s101.93x
🌐 MongoDBNext.js (Turbopack)3.611s4.009s0.398s82.95x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.862s (-4.7%)5.659s (-4.4%)1.797s61.00x
▲ VercelExpress4.351s (+20.2% 🔺)5.741s (+12.3% 🔺)1.391s61.13x
▲ VercelNext.js (Turbopack)5.397s (-24.0% 🟢)7.101s (-20.3% 🟢)1.704s51.40x

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

Promise.all with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.372s (-60.6% 🟢)2.008s (-49.9% 🟢)0.636s151.00x
🐘 PostgresNext.js (Turbopack)1.764s2.074s0.310s151.29x
🐘 PostgresExpress2.273s (-34.8% 🟢)3.078s (-23.3% 🟢)0.805s101.66x
🌐 RedisNext.js (Turbopack)3.639s4.010s0.370s82.65x
💻 LocalNitro4.502s (-46.1% 🟢)5.011s (-44.4% 🟢)0.510s63.28x
💻 LocalExpress4.545s (-45.5% 🟢)5.014s (-44.5% 🟢)0.469s73.31x
💻 LocalNext.js (Turbopack)5.644s6.215s0.571s54.11x
🌐 MongoDBNext.js (Turbopack)6.310s7.015s0.705s54.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.332s (+51.2% 🔺)6.946s (+25.5% 🔺)1.614s51.00x
▲ VercelNext.js (Turbopack)6.496s (-27.1% 🟢)8.168s (-25.5% 🟢)1.672s41.22x
▲ VercelExpress7.267s (+71.4% 🔺)9.101s (+48.5% 🔺)1.834s41.36x

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

Promise.race with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.149s (-8.6% 🟢)2.007s (~)0.858s151.00x
🌐 RedisNext.js (Turbopack)1.228s2.006s0.778s151.07x
🐘 PostgresNext.js (Turbopack)1.246s2.008s0.762s151.08x
💻 LocalNext.js (Turbopack)1.328s2.006s0.678s151.16x
💻 LocalNitro1.387s (-25.7% 🟢)2.006s (-14.3% 🟢)0.619s151.21x
🐘 PostgresExpress1.481s (+17.8% 🔺)2.163s (+7.7% 🔺)0.682s141.29x
💻 LocalExpress1.482s (-21.7% 🟢)2.007s (-15.1% 🟢)0.525s151.29x
🌐 MongoDBNext.js (Turbopack)2.031s2.827s0.796s111.77x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro2.354s (-4.2%)3.765s (-9.7% 🟢)1.411s81.00x
▲ VercelExpress2.501s (-3.1%)3.783s (-13.0% 🟢)1.283s81.06x
▲ VercelNext.js (Turbopack)3.502s (+19.5% 🔺)5.206s (+12.1% 🔺)1.704s71.49x

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

Promise.race with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.223s (-47.7% 🟢)2.009s (-33.3% 🟢)0.785s151.00x
🐘 PostgresNext.js (Turbopack)1.405s2.008s0.603s151.15x
🐘 PostgresExpress1.673s (-28.6% 🟢)2.326s (-22.8% 🟢)0.653s131.37x
💻 LocalExpress1.769s (-43.5% 🟢)2.151s (-42.8% 🟢)0.381s141.45x
💻 LocalNitro1.856s (-39.4% 🟢)2.222s (-42.8% 🟢)0.366s141.52x
💻 LocalNext.js (Turbopack)2.011s2.591s0.579s121.64x
🌐 RedisNext.js (Turbopack)2.353s3.008s0.655s101.92x
🌐 MongoDBNext.js (Turbopack)3.583s4.010s0.428s82.93x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.537s (+9.4% 🔺)5.179s (+2.0%)1.642s61.00x
▲ VercelExpress3.550s (+11.2% 🔺)5.397s (+12.6% 🔺)1.847s61.00x
▲ VercelNext.js (Turbopack)5.661s (+80.1% 🔺)6.980s (+54.4% 🔺)1.319s51.60x

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

Promise.race with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.375s (-60.5% 🟢)2.008s (-49.9% 🟢)0.633s151.00x
🐘 PostgresNext.js (Turbopack)1.637s2.075s0.438s151.19x
🐘 PostgresExpress2.311s (-34.0% 🟢)3.176s (-20.8% 🟢)0.865s101.68x
🌐 RedisNext.js (Turbopack)3.594s4.010s0.416s82.61x
💻 LocalExpress4.730s (-46.3% 🟢)5.346s (-42.3% 🟢)0.616s63.44x
💻 LocalNitro5.397s (-41.0% 🟢)6.014s (-40.0% 🟢)0.617s53.92x
💻 LocalNext.js (Turbopack)5.562s6.014s0.453s54.04x
🌐 MongoDBNext.js (Turbopack)6.355s7.014s0.659s54.62x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro4.714s (-7.4% 🟢)6.592s (-3.3%)1.878s51.00x
▲ VercelNext.js (Turbopack)5.926s (-12.3% 🟢)8.154s (-4.6%)2.228s41.26x
▲ VercelExpress6.059s (-5.6% 🟢)8.015s (-2.0%)1.956s41.29x

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

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.437s (-46.7% 🟢)1.007s (~)0.569s601.00x
💻 LocalNitro0.459s (-53.2% 🟢)1.004s (-8.2% 🟢)0.544s601.05x
💻 LocalExpress0.567s (-42.4% 🟢)1.040s (-3.4%)0.473s581.30x
🌐 RedisNext.js (Turbopack)0.621s1.004s0.383s601.42x
🐘 PostgresNext.js (Turbopack)0.667s1.006s0.339s601.53x
🌐 MongoDBNext.js (Turbopack)0.730s1.006s0.276s601.67x
💻 LocalNext.js (Turbopack)0.737s1.005s0.268s601.68x
🐘 PostgresExpress0.905s (+7.9% 🔺)1.370s (+33.9% 🔺)0.465s452.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express4.958s (-73.9% 🟢)6.669s (-68.7% 🟢)1.711s91.00x
▲ VercelNitro5.116s (-76.8% 🟢)6.704s (-72.1% 🟢)1.588s101.03x
▲ VercelNext.js (Turbopack)7.017s (-51.6% 🟢)8.729s (-45.7% 🟢)1.711s71.42x

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

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.022s (-47.0% 🟢)1.585s (-24.5% 🟢)0.564s571.00x
💻 LocalNitro1.161s (-61.7% 🟢)2.005s (-46.6% 🟢)0.844s451.14x
💻 LocalExpress1.307s (-56.7% 🟢)2.006s (-44.0% 🟢)0.700s451.28x
🌐 RedisNext.js (Turbopack)1.492s2.006s0.514s451.46x
🐘 PostgresNext.js (Turbopack)1.604s2.008s0.404s451.57x
💻 LocalNext.js (Turbopack)1.792s2.006s0.214s451.75x
🌐 MongoDBNext.js (Turbopack)1.842s2.007s0.166s451.80x
🐘 PostgresExpress2.094s (+5.9% 🔺)2.560s (+13.4% 🔺)0.467s362.05x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro12.742s (-67.7% 🟢)14.987s (-63.7% 🟢)2.246s71.00x
▲ VercelExpress13.193s (-61.8% 🟢)14.863s (-59.6% 🟢)1.670s71.04x
▲ VercelNext.js (Turbopack)14.895s (-70.1% 🟢)16.716s (-67.7% 🟢)1.822s61.17x

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

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro2.012s (-51.0% 🟢)2.427s (-47.3% 🟢)0.416s501.00x
💻 LocalNitro2.667s (-71.3% 🟢)3.033s (-69.7% 🟢)0.366s401.33x
💻 LocalExpress2.912s (-68.4% 🟢)3.252s (-67.5% 🟢)0.340s371.45x
🌐 RedisNext.js (Turbopack)2.984s3.250s0.267s371.48x
🐘 PostgresNext.js (Turbopack)3.270s4.045s0.775s301.63x
💻 LocalNext.js (Turbopack)3.857s4.075s0.217s301.92x
🐘 PostgresExpress4.078s (+2.2%)4.502s (+3.0%)0.424s272.03x
🌐 MongoDBNext.js (Turbopack)4.220s5.012s0.792s242.10x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro38.819s (-59.9% 🟢)40.985s (-58.4% 🟢)2.166s31.00x
▲ VercelExpress39.658s (-69.5% 🟢)41.705s (-68.4% 🟢)2.048s31.02x
▲ VercelNext.js (Turbopack)46.146s (-56.9% 🟢)47.530s (-56.4% 🟢)1.383s31.19x

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

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.182s (-35.9% 🟢)1.006s (~)0.824s601.00x
🌐 RedisNext.js (Turbopack)0.237s1.004s0.767s601.30x
🐘 PostgresNext.js (Turbopack)0.241s1.006s0.765s601.33x
💻 LocalNitro0.447s (-26.1% 🟢)1.004s (-1.7%)0.557s602.46x
💻 LocalExpress0.478s (-14.7% 🟢)1.005s (~)0.527s602.63x
🐘 PostgresExpress0.511s (+80.8% 🔺)1.148s (+14.0% 🔺)0.637s532.81x
💻 LocalNext.js (Turbopack)0.581s1.005s0.423s603.20x
🌐 MongoDBNext.js (Turbopack)1.036s1.855s0.819s335.70x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.028s (+3.8%)3.796s (+4.4%)1.768s161.00x
▲ VercelNitro2.293s (+38.0% 🔺)4.077s (+21.7% 🔺)1.785s151.13x
▲ VercelNext.js (Turbopack)3.973s (+96.4% 🔺)5.530s (+45.8% 🔺)1.557s111.96x

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

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.310s (-37.4% 🟢)1.006s (~)0.696s901.00x
🌐 RedisNext.js (Turbopack)0.407s1.004s0.597s901.31x
🐘 PostgresNext.js (Turbopack)0.482s1.007s0.524s901.55x
🐘 PostgresExpress0.818s (+60.4% 🔺)1.341s (+33.3% 🔺)0.523s682.63x
💻 LocalExpress2.184s (-13.1% 🟢)3.010s (~)0.825s307.04x
💻 LocalNitro2.198s (-13.4% 🟢)2.944s (-2.2%)0.746s317.08x
🌐 MongoDBNext.js (Turbopack)2.606s3.007s0.400s308.39x
💻 LocalNext.js (Turbopack)2.614s3.149s0.535s298.42x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Next.js (Turbopack)6.797s (+92.3% 🔺)8.510s (+63.9% 🔺)1.713s111.00x
▲ VercelNitro7.928s (+145.8% 🔺)9.974s (+106.8% 🔺)2.046s101.17x
▲ VercelExpress8.062s (+164.6% 🔺)9.804s (+103.9% 🔺)1.742s101.19x

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

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.662s (-16.3% 🟢)1.006s (~)0.344s1201.00x
🌐 RedisNext.js (Turbopack)0.751s1.012s0.261s1191.14x
🐘 PostgresNext.js (Turbopack)0.981s1.521s0.539s801.48x
🐘 PostgresExpress1.706s (+108.3% 🔺)2.295s (+125.6% 🔺)0.589s532.58x
🌐 MongoDBNext.js (Turbopack)5.391s6.014s0.623s208.14x
💻 LocalNitro9.825s (-12.2% 🟢)10.446s (-10.4% 🟢)0.621s1214.85x
💻 LocalExpress10.179s (-9.0% 🟢)10.783s (-9.7% 🟢)0.604s1215.38x
💻 LocalNext.js (Turbopack)11.645s12.330s0.685s1017.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express18.117s (+144.2% 🔺)20.127s (+117.7% 🔺)2.009s61.00x
▲ VercelNext.js (Turbopack)19.231s (+86.2% 🔺)21.009s (+71.0% 🔺)1.778s71.06x
▲ VercelNitro23.043s (+198.4% 🔺)25.291s (+169.0% 🔺)2.248s51.27x

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

Stream Benchmarks(includes TTFB metrics)
workflow with stream

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.129s (+428.1% 🔺)2.005s (+99.6% 🔺)0.011s (-14.4% 🟢)2.018s (+98.0% 🔺)0.889s101.00x
🐘 PostgresNitro1.138s (+455.3% 🔺)2.001s (+100.2% 🔺)0.001s (-13.3% 🟢)2.010s (+98.7% 🔺)0.871s101.01x
💻 LocalExpress1.143s (+474.3% 🔺)2.006s (+99.7% 🔺)0.010s (-15.7% 🟢)2.019s (+98.3% 🔺)0.875s101.01x
💻 LocalNext.js (Turbopack)1.190s2.003s0.013s2.020s0.830s101.05x
🐘 PostgresNext.js (Turbopack)1.195s2.001s0.002s2.011s0.815s101.06x
🐘 PostgresExpress1.514s (+638.4% 🔺)2.094s (+109.7% 🔺)0.378s (+23500.0% 🔺)2.508s (+148.0% 🔺)0.994s101.34x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.104s (-16.0% 🟢)3.360s (-17.8% 🟢)1.769s (+84.1% 🔺)5.626s (+0.6%)3.521s101.00x
▲ VercelNitro2.336s (-39.0% 🟢)3.612s (-31.6% 🟢)1.861s (+150.7% 🔺)6.014s (-7.2% 🟢)3.678s101.11x
▲ VercelNext.js (Turbopack)5.134s (-25.1% 🟢)5.213s (-39.7% 🟢)1.098s (+73.8% 🔺)7.870s (-19.6% 🟢)2.735s102.44x

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

stream pipeline with 5 transform steps (1MB)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.538s (+146.5% 🔺)2.001s (+98.8% 🔺)0.004s (-12.1% 🟢)2.025s (+98.0% 🔺)0.487s301.00x
💻 LocalExpress1.588s (+109.7% 🔺)2.011s (+95.5% 🔺)0.012s (+25.7% 🔺)2.026s (+94.8% 🔺)0.438s301.03x
🐘 PostgresNext.js (Turbopack)1.705s2.010s0.004s2.026s0.321s301.11x
💻 LocalNext.js (Turbopack)1.866s2.011s0.010s2.203s0.337s281.21x
💻 LocalNitro2.164s (+158.1% 🔺)2.010s (+98.6% 🔺)0.009s (-4.0%)2.675s (+139.7% 🔺)0.510s231.41x
🐘 PostgresExpress2.444s (+288.0% 🔺)2.731s (+171.4% 🔺)0.003s (-19.3% 🟢)2.767s (+170.4% 🔺)0.322s221.59x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express5.877s (-9.6% 🟢)7.234s (-9.7% 🟢)0.232s (-43.4% 🟢)7.955s (-10.0% 🟢)2.078s81.00x
▲ VercelNitro5.894s (-80.0% 🟢)7.169s (-76.7% 🟢)0.258s (+130.4% 🔺)7.895s (-75.2% 🟢)2.001s81.00x
▲ VercelNext.js (Turbopack)13.642s (-19.4% 🟢)13.146s (-27.9% 🟢)0.318s (+50.3% 🔺)15.510s (-18.1% 🟢)1.868s42.32x

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

10 parallel streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.694s (-28.3% 🟢)1.030s (-17.5% 🟢)0.000s (-57.9% 🟢)1.060s (-15.7% 🟢)0.366s571.00x
🐘 PostgresNext.js (Turbopack)0.798s1.072s0.000s1.082s0.284s561.15x
💻 LocalNext.js (Turbopack)1.451s2.014s0.000s2.017s0.566s302.09x
💻 LocalExpress1.475s (+20.4% 🔺)2.015s (~)0.000s (~)2.018s (~)0.543s302.12x
💻 LocalNitro1.486s (+21.5% 🔺)2.014s (~)0.000s (+364.3% 🔺)2.195s (+8.6% 🔺)0.709s282.14x
🐘 PostgresExpress2.079s (+116.4% 🔺)2.453s (+92.0% 🔺)0.000s (-100.0% 🟢)2.522s (+93.1% 🔺)0.443s242.99x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express3.871s (+3.5%)5.345s (+4.7%)0.003s (+1500.0% 🔺)5.771s (+4.4%)1.900s111.00x
▲ VercelNitro3.911s (+28.2% 🔺)5.386s (+22.6% 🔺)0.000s (+254.5% 🔺)5.924s (+23.2% 🔺)2.013s111.01x
▲ VercelNext.js (Turbopack)6.210s (-39.0% 🟢)6.441s (-44.1% 🟢)0.001s (+Infinity% 🔺)7.762s (-35.6% 🟢)1.552s81.60x

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

fan-out fan-in 10 streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.461s (-18.5% 🟢)2.141s (~)0.000s (~)2.154s (-1.0%)0.693s281.00x
🐘 PostgresNext.js (Turbopack)1.801s2.348s0.000s2.356s0.554s261.23x
💻 LocalNext.js (Turbopack)2.779s3.293s0.001s3.298s0.519s191.90x
💻 LocalNitro2.995s (-11.6% 🟢)3.735s (-7.4% 🟢)0.000s (-89.0% 🟢)3.737s (-7.4% 🟢)0.743s172.05x
💻 LocalExpress3.279s (-5.4% 🟢)3.840s (-4.8%)0.001s (-21.9% 🟢)3.847s (-4.7%)0.568s162.24x
🐘 PostgresExpress3.897s (+119.9% 🔺)4.233s (+94.4% 🔺)0.000s (+Infinity% 🔺)4.354s (+98.0% 🔺)0.458s142.67x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.840s (+42.7% 🔺)7.408s (+37.8% 🔺)0.000s (-8.3% 🟢)7.847s (+35.4% 🔺)2.007s81.00x
▲ VercelExpress5.876s (+28.1% 🔺)7.054s (+17.1% 🔺)0.001s (+Infinity% 🔺)7.514s (+16.4% 🔺)1.638s81.01x
▲ VercelNext.js (Turbopack)8.242s (+46.7% 🔺)9.359s (+34.0% 🔺)0.000s (+33.3% 🔺)10.005s (+32.7% 🔺)1.763s61.41x

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

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World🥇 Fastest FrameworkWins
💻 LocalNitro13/21
🐘 PostgresNitro21/21
▲ VercelNitro12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework🥇 Fastest WorldWins
Express💻 Local15/21
Next.js (Turbopack)🌐 Redis11/21
Nitro🐘 Postgres15/21
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


⚠️Community world benchmarks failed (non-blocking):

  • Community Worlds: failure

Check the workflow run for details.

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

PassedFailedSkippedTotal
✅ ▲ Vercel Production120002191419
✅ 💻 Local Development158702191806
✅ 📦 Local Production158702191806
✅ 🐘 Local Postgres158702191806
✅ 🪟 Windows12900129
✅ 📋 Other7270176903
Total6817010527869

Details by Category

✅ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro103026
✅ example103026
✅ express103026
✅ fastify103026
✅ hono103026
✅ nextjs-turbopack12702
✅ nextjs-webpack12702
✅ nitro103026
✅ nuxt103026
✅ sveltekit12207
✅ vite103026
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🪟 Windows
AppPassedFailedSkipped
✅ nextjs-turbopack12900
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable104025
✅ e2e-local-dev-tanstack-start-104025
✅ e2e-local-postgres-nest-stable104025
✅ e2e-local-postgres-tanstack-start-104025
✅ e2e-local-prod-nest-stable104025
✅ e2e-local-prod-tanstack-start-104025
✅ e2e-vercel-prod-tanstack-start103026

📋 View full workflow run

@karthikscale3
karthikscale3force-pushed the karthik/fix-doc-switcher branch from 42d3fd0 to 4f0c239CompareMay 6, 2026 04:47
## Content restructuring
- Split `docs/content/docs/` into `docs/content/docs/v4/` and
`docs/content/docs/v5/` so each version is a fully independent
content tree with no shared-file coupling
- v4 excludes the four pages that are v5-only (AbortController
cancellation docs and the serializable-abort-controller internal page)
- v5 retains all pages; `preRelease` frontmatter field removed (no
longer needed now that each version is its own folder)
- Removed `AbortController` / `AbortSignal` from v4 serialization page
(section moved to v5 only)
## Fumadocs source
- Added `v4docs` and `v5docs` as separate `defineDocs()` collections in
`source.config.ts`; shared `docsSchema` (no more `preRelease` field)
- `source.ts` exports both `source` (v4, `baseUrl: /docs`) and
`v5Source` (v5, same base URL)
## Version routing
- `version-source.ts` simplified: `filterPreReleaseFromNodes` and
`isPreReleaseUrl` logic removed; v4 tree uses `source`, v5 tree uses
`v5Source` + `rewriteNodeUrls`
- v4 `page.tsx`: removed `preRelease` guard (v4Source has no such pages)
- v5 `page.tsx`: uses `v5Source` for `getPage` / `generateStaticParams`
/ `generateMetadata`; `v5Link` wrapper rewrites `/docs/…` hrefs to
`/v5/docs/…` so inline MDX links stay in the v5 context
## Versioned cookbook
- Added `app/[lang]/v5/cookbook/` layout + page (mirrors v4 but uses
`v5Source`, `rewriteCookbookUrlForVersion`, and `V5CookbookLink`)
- `getCookbookTree` accepts a `versionPrefix` parameter; sidebar URLs
are prefixed accordingly (`/v5/cookbook/…`)
- `cookbook-tree.ts`: added `skipVersions?: string[]` per-recipe field
for version-specific exclusions; `distributed-abort-controller` is
marked `skipVersions: ['v5']`
## Version switcher — state & navigation
- New `VersionProvider` context (`hooks/geistdocs/use-version.tsx`)
backed by `localStorage`: URL is source of truth on versioned pages,
`localStorage` carries the preference across non-versioned pages
(cookbook overview, worlds, etc.)
- `VersionSwitcher` uses `useVersion()` context instead of URL-only
detection; now visible on all pages including cookbook
- `DesktopMenu` and `MobileMenu` use `activeVersion` from context so
the "Docs" and "Cookbook" navbar links resolve to the correct version
prefix on every page
- `buildVersionUrl` expanded to handle `/cookbook/…` paths alongside
`/docs/…`; non-versioned routes (worlds, api) return unchanged
- `switchVersion` does a `HEAD` probe before navigating; falls back to
the versioned cookbook or docs home if the target page doesn't exist
in that version (handles v4-only → v5 and v5-only → v4 cases)
## Cookbook content (v5)
- Rewrote `agent-cancellation` recipe using a single `AbortController`
pattern; removed Hard Cancellation vs Stop Signal two-approach
comparison
- Deleted `distributed-abort-controller` recipe from v5 (native
`AbortController` serialization makes it unnecessary)
- Removed references to distributed-abort-controller from
`cookbook/index.mdx` and `common-patterns/timeouts.mdx`
Co-authored-by: Cursor <cursoragent@cursor.com>
Content moved from docs/content/docs/ to docs/content/docs/v5/ on main
(pre-release channel). Stable branch will use v4/ after backport.
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@karthikscale3@pranaygp
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); docs: split v4/v5 content trees and fix version switcher end-to-end by karthikscale3 · Pull Request #1948 · vercel/workflow · GitHub
Skip to content

docs: split v4/v5 content trees and fix version switcher end-to-end - #1948

Merged
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher
May 6, 2026
Merged

docs: split v4/v5 content trees and fix version switcher end-to-end#1948
karthikscale3 merged 3 commits into
mainfrom
karthik/fix-doc-switcher

Conversation

@karthikscale3

Copy link
Copy Markdown
Contributor

Summary

Content restructuring

  • Split docs/content/docs/ into docs/content/docs/v4/ and docs/content/docs/v5/ — each version is now a fully independent content tree with no shared-file coupling or preRelease frontmatter filtering
  • v4 excludes the four v5-only pages (AbortController cancellation docs, abort-signal-timeout error, and serializable-abort-controller internal page)
  • v5 retains all pages; preRelease frontmatter field removed (no longer meaningful with separate folders)
  • Removed AbortController / AbortSignal from the v4 serialization page (moved to v5 only)

Fumadocs source split

  • Added v4docs and v5docs as separate defineDocs() collections in source.config.ts pointing to content/docs/v4 and content/docs/v5
  • source.ts now exports both source (v4) and v5Source (v5), both with baseUrl: /docs

Version routing fixes

  • version-source.ts simplified: removed filterPreReleaseFromNodes / isPreReleaseUrl logic; v4 sidebar uses source, v5 uses v5Source + existing rewriteNodeUrls
  • v4 page.tsx: removed the preRelease guard (v4Source simply doesn't contain those pages)
  • v5 page.tsx: uses v5Source for getPage, generateStaticParams, and generateMetadata; v5Link wrapper rewrites /docs/… hrefs to /v5/docs/… so inline MDX links stay in the v5 context
  • buildVersionUrl now handles /cookbook/… paths with the same version-prefix logic as /docs/…; non-versioned routes (worlds, api) return unchanged

Versioned cookbook

  • Added app/[lang]/v5/cookbook/ layout + page (mirrors v4, uses v5Source and rewriteCookbookUrlForVersion)
  • getCookbookTree accepts a versionPrefix parameter; sidebar URLs are prefixed accordingly (/v5/cookbook/…)
  • cookbook-tree.ts: added skipVersions?: string[] per-recipe field for version-specific exclusions; distributed-abort-controller marked skipVersions: ['v5'] so it shows in v4 but not v5

Version switcher — state & navigation

  • New VersionProvider context (hooks/geistdocs/use-version.tsx) backed by localStorage: URL is the source of truth on versioned pages; localStorage carries the preference across non-versioned pages (worlds, etc.)
  • VersionSwitcher uses useVersion() context; now visible on all pages including cookbook (no longer hidden on non-docs routes)
  • DesktopMenu and MobileMenu read activeVersion from context so "Docs" and "Cookbook" navbar links resolve to the correct version prefix on every page
  • switchVersion does a HEAD probe before navigating; falls back to the versioned cookbook or docs home if the target page doesn't exist in that version — handles both v4-only → v5 (distributed-abort-controller) and v5-only → v4 (cancellation docs) cases

Cookbook content (v5)

  • Rewrote agent-cancellation recipe using a single AbortController + hook pattern; removed the Hard Cancellation vs Stop Signal two-approach comparison and comparison table
  • Deleted distributed-abort-controller recipe from v5 (native AbortController serialization in v5 makes it unnecessary)
  • Removed all references to distributed-abort-controller from cookbook/index.mdx, common-patterns/timeouts.mdx, advanced/meta.json, and the agent-cancellation page

Test plan

  • /docs/… (v4) pages load correctly; v5-only pages (/docs/foundations/cancellation, etc.) return 404
  • /v5/docs/… pages load correctly including the four v5-only pages
  • Version switcher shows correct version on docs, cookbook, and worlds pages
  • Switching v4 → v5 on a docs page navigates to the same page under /v5/docs/…
  • Switching v5 → v4 on a v5-only page falls back to /docs/getting-started
  • Switching versions on /cookbook/… navigates to the same recipe under /v5/cookbook/… (or falls back if not present)
  • Switching v4 → v5 on /cookbook/advanced/distributed-abort-controller falls back to /v5/cookbook
  • Navbar "Docs" and "Cookbook" links resolve to the active version's prefix on all pages
  • Version preference is preserved when navigating from docs → cookbook → back to docs

Made with Cursor

@changeset-bot

changeset-botBot commented May 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b76034f

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

vercelBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

📊 Benchmark Results

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

workflow with no steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro0.033s (-23.0% 🟢)1.006s (~)0.973s101.00x
💻 LocalExpress0.038s (-14.9% 🟢)1.008s (~)0.970s101.14x
🐘 PostgresNitro0.048s (-49.3% 🟢)1.013s (-2.9%)0.964s101.45x
💻 LocalNext.js (Turbopack)0.051s1.006s0.954s101.55x
🌐 RedisNext.js (Turbopack)0.053s1.005s0.952s101.58x
🐘 PostgresNext.js (Turbopack)0.060s1.013s0.953s101.81x
🌐 MongoDBNext.js (Turbopack)0.099s1.008s0.909s102.98x
🐘 PostgresExpress0.111s (+91.4% 🔺)1.063s (+5.2% 🔺)0.952s103.34x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro0.245s (-40.1% 🟢)2.147s (-14.4% 🟢)1.902s101.00x
▲ VercelExpress0.253s (+7.3% 🔺)2.140s (~)1.887s101.03x
▲ VercelNext.js (Turbopack)0.798s (+217.1% 🔺)2.773s (+18.9% 🔺)1.976s103.25x

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

workflow with 1 step

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.067s (-5.7% 🟢)2.007s (~)0.940s101.00x
💻 LocalExpress1.082s (-3.8%)2.008s (~)0.925s101.01x
🐘 PostgresNitro1.091s (-4.3%)2.009s (~)0.918s101.02x
🌐 RedisNext.js (Turbopack)1.109s2.006s0.898s101.04x
💻 LocalNext.js (Turbopack)1.115s2.006s0.891s101.05x
🐘 PostgresNext.js (Turbopack)1.128s2.009s0.881s101.06x
🐘 PostgresExpress1.130s (-1.4%)2.024s (+0.7%)0.894s101.06x
🌐 MongoDBNext.js (Turbopack)1.168s2.009s0.841s101.09x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express1.579s (-15.8% 🟢)3.777s (-0.8%)2.199s101.00x
▲ VercelNitro1.590s (-59.1% 🟢)3.673s (-37.8% 🟢)2.083s101.01x
▲ VercelNext.js (Turbopack)3.197s (+57.1% 🔺)4.489s (+17.2% 🔺)1.292s102.03x

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

workflow with 10 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro10.427s (-4.7%)11.021s (~)0.594s31.00x
💻 LocalExpress10.465s (-4.2%)11.025s (~)0.559s31.00x
🐘 PostgresNitro10.467s (-3.7%)11.019s (~)0.552s31.00x
🌐 RedisNext.js (Turbopack)10.655s11.023s0.368s31.02x
💻 LocalNext.js (Turbopack)10.666s11.022s0.356s31.02x
🐘 PostgresNext.js (Turbopack)10.756s11.015s0.260s31.03x
🌐 MongoDBNext.js (Turbopack)10.834s11.020s0.186s31.04x
🐘 PostgresExpress10.866s (-0.9%)11.400s (+3.4%)0.534s31.04x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro13.218s (-44.3% 🟢)14.916s (-40.6% 🟢)1.698s31.00x
▲ VercelExpress13.258s (-21.9% 🟢)15.627s (-21.9% 🟢)2.368s21.00x
▲ VercelNext.js (Turbopack)15.143s (-12.6% 🟢)16.855s (-13.1% 🟢)1.712s21.15x

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

workflow with 25 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro13.417s (-10.9% 🟢)14.027s (-12.5% 🟢)0.610s51.00x
🐘 PostgresNitro13.484s (-7.6% 🟢)14.019s (-6.7% 🟢)0.536s51.00x
💻 LocalExpress13.637s (-8.9% 🟢)14.030s (-6.7% 🟢)0.392s51.02x
🌐 RedisNext.js (Turbopack)14.069s14.828s0.759s51.05x
💻 LocalNext.js (Turbopack)14.090s15.031s0.941s41.05x
🌐 MongoDBNext.js (Turbopack)14.228s15.025s0.798s41.06x
🐘 PostgresNext.js (Turbopack)14.238s15.020s0.782s41.06x
🐘 PostgresExpress14.414s (-1.2%)15.017s (~)0.604s41.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro21.299s (-67.0% 🟢)23.458s (-64.8% 🟢)2.159s31.00x
▲ VercelExpress21.953s (-56.4% 🟢)24.119s (-54.1% 🟢)2.166s31.03x
▲ VercelNext.js (Turbopack)22.605s (-57.0% 🟢)24.322s (-55.5% 🟢)1.717s31.06x

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

workflow with 50 sequential steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro11.799s (-29.7% 🟢)12.022s (-29.4% 🟢)0.222s81.00x
🐘 PostgresNitro12.001s (-14.1% 🟢)12.392s (-13.4% 🟢)0.390s81.02x
💻 LocalExpress12.214s (-26.4% 🟢)13.027s (-23.5% 🟢)0.813s71.04x
🌐 RedisNext.js (Turbopack)12.955s13.311s0.355s71.10x
💻 LocalNext.js (Turbopack)13.113s14.026s0.913s71.11x
🐘 PostgresNext.js (Turbopack)13.257s14.016s0.759s71.12x
🌐 MongoDBNext.js (Turbopack)13.339s14.025s0.687s71.13x
🐘 PostgresExpress16.095s (+14.9% 🔺)16.539s (+13.3% 🔺)0.444s61.36x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro31.335s (-92.6% 🟢)33.852s (-92.0% 🟢)2.517s31.00x
▲ VercelExpress33.300s (-72.5% 🟢)35.430s (-71.3% 🟢)2.130s31.06x
▲ VercelNext.js (Turbopack)33.643s (-91.5% 🟢)35.813s (-90.9% 🟢)2.170s31.07x

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

Promise.all with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.151s (-9.7% 🟢)2.007s (~)0.856s151.00x
💻 LocalNitro1.170s (-28.3% 🟢)2.005s (-3.3%)0.836s151.02x
💻 LocalExpress1.182s (-20.6% 🟢)2.007s (~)0.825s151.03x
🐘 PostgresNext.js (Turbopack)1.220s2.007s0.786s151.06x
🌐 RedisNext.js (Turbopack)1.244s2.006s0.762s151.08x
💻 LocalNext.js (Turbopack)1.280s2.006s0.726s151.11x
🐘 PostgresExpress1.443s (+14.5% 🔺)2.184s (+8.7% 🔺)0.742s141.25x
🌐 MongoDBNext.js (Turbopack)2.044s2.918s0.874s111.78x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.481s (-13.2% 🟢)4.024s (-13.0% 🟢)1.543s81.00x
▲ VercelNitro2.531s (-10.2% 🟢)4.150s (-4.0%)1.619s81.02x
▲ VercelNext.js (Turbopack)3.892s (+14.6% 🔺)5.639s (+14.3% 🔺)1.747s61.57x

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

Promise.all with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.224s (-48.0% 🟢)2.007s (-33.3% 🟢)0.783s151.00x
🐘 PostgresNext.js (Turbopack)1.384s2.007s0.623s151.13x
💻 LocalExpress1.642s (-44.4% 🟢)2.007s (-41.9% 🟢)0.364s151.34x
🐘 PostgresExpress1.690s (-28.4% 🟢)2.263s (-24.8% 🟢)0.573s141.38x
💻 LocalNitro1.693s (-46.1% 🟢)2.005s (-48.4% 🟢)0.312s151.38x
💻 LocalNext.js (Turbopack)1.848s2.073s0.226s151.51x
🌐 RedisNext.js (Turbopack)2.359s3.008s0.649s101.93x
🌐 MongoDBNext.js (Turbopack)3.611s4.009s0.398s82.95x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.862s (-4.7%)5.659s (-4.4%)1.797s61.00x
▲ VercelExpress4.351s (+20.2% 🔺)5.741s (+12.3% 🔺)1.391s61.13x
▲ VercelNext.js (Turbopack)5.397s (-24.0% 🟢)7.101s (-20.3% 🟢)1.704s51.40x

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

Promise.all with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.372s (-60.6% 🟢)2.008s (-49.9% 🟢)0.636s151.00x
🐘 PostgresNext.js (Turbopack)1.764s2.074s0.310s151.29x
🐘 PostgresExpress2.273s (-34.8% 🟢)3.078s (-23.3% 🟢)0.805s101.66x
🌐 RedisNext.js (Turbopack)3.639s4.010s0.370s82.65x
💻 LocalNitro4.502s (-46.1% 🟢)5.011s (-44.4% 🟢)0.510s63.28x
💻 LocalExpress4.545s (-45.5% 🟢)5.014s (-44.5% 🟢)0.469s73.31x
💻 LocalNext.js (Turbopack)5.644s6.215s0.571s54.11x
🌐 MongoDBNext.js (Turbopack)6.310s7.015s0.705s54.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.332s (+51.2% 🔺)6.946s (+25.5% 🔺)1.614s51.00x
▲ VercelNext.js (Turbopack)6.496s (-27.1% 🟢)8.168s (-25.5% 🟢)1.672s41.22x
▲ VercelExpress7.267s (+71.4% 🔺)9.101s (+48.5% 🔺)1.834s41.36x

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

Promise.race with 10 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.149s (-8.6% 🟢)2.007s (~)0.858s151.00x
🌐 RedisNext.js (Turbopack)1.228s2.006s0.778s151.07x
🐘 PostgresNext.js (Turbopack)1.246s2.008s0.762s151.08x
💻 LocalNext.js (Turbopack)1.328s2.006s0.678s151.16x
💻 LocalNitro1.387s (-25.7% 🟢)2.006s (-14.3% 🟢)0.619s151.21x
🐘 PostgresExpress1.481s (+17.8% 🔺)2.163s (+7.7% 🔺)0.682s141.29x
💻 LocalExpress1.482s (-21.7% 🟢)2.007s (-15.1% 🟢)0.525s151.29x
🌐 MongoDBNext.js (Turbopack)2.031s2.827s0.796s111.77x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro2.354s (-4.2%)3.765s (-9.7% 🟢)1.411s81.00x
▲ VercelExpress2.501s (-3.1%)3.783s (-13.0% 🟢)1.283s81.06x
▲ VercelNext.js (Turbopack)3.502s (+19.5% 🔺)5.206s (+12.1% 🔺)1.704s71.49x

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

Promise.race with 25 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.223s (-47.7% 🟢)2.009s (-33.3% 🟢)0.785s151.00x
🐘 PostgresNext.js (Turbopack)1.405s2.008s0.603s151.15x
🐘 PostgresExpress1.673s (-28.6% 🟢)2.326s (-22.8% 🟢)0.653s131.37x
💻 LocalExpress1.769s (-43.5% 🟢)2.151s (-42.8% 🟢)0.381s141.45x
💻 LocalNitro1.856s (-39.4% 🟢)2.222s (-42.8% 🟢)0.366s141.52x
💻 LocalNext.js (Turbopack)2.011s2.591s0.579s121.64x
🌐 RedisNext.js (Turbopack)2.353s3.008s0.655s101.92x
🌐 MongoDBNext.js (Turbopack)3.583s4.010s0.428s82.93x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro3.537s (+9.4% 🔺)5.179s (+2.0%)1.642s61.00x
▲ VercelExpress3.550s (+11.2% 🔺)5.397s (+12.6% 🔺)1.847s61.00x
▲ VercelNext.js (Turbopack)5.661s (+80.1% 🔺)6.980s (+54.4% 🔺)1.319s51.60x

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

Promise.race with 50 concurrent steps

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.375s (-60.5% 🟢)2.008s (-49.9% 🟢)0.633s151.00x
🐘 PostgresNext.js (Turbopack)1.637s2.075s0.438s151.19x
🐘 PostgresExpress2.311s (-34.0% 🟢)3.176s (-20.8% 🟢)0.865s101.68x
🌐 RedisNext.js (Turbopack)3.594s4.010s0.416s82.61x
💻 LocalExpress4.730s (-46.3% 🟢)5.346s (-42.3% 🟢)0.616s63.44x
💻 LocalNitro5.397s (-41.0% 🟢)6.014s (-40.0% 🟢)0.617s53.92x
💻 LocalNext.js (Turbopack)5.562s6.014s0.453s54.04x
🌐 MongoDBNext.js (Turbopack)6.355s7.014s0.659s54.62x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro4.714s (-7.4% 🟢)6.592s (-3.3%)1.878s51.00x
▲ VercelNext.js (Turbopack)5.926s (-12.3% 🟢)8.154s (-4.6%)2.228s41.26x
▲ VercelExpress6.059s (-5.6% 🟢)8.015s (-2.0%)1.956s41.29x

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

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.437s (-46.7% 🟢)1.007s (~)0.569s601.00x
💻 LocalNitro0.459s (-53.2% 🟢)1.004s (-8.2% 🟢)0.544s601.05x
💻 LocalExpress0.567s (-42.4% 🟢)1.040s (-3.4%)0.473s581.30x
🌐 RedisNext.js (Turbopack)0.621s1.004s0.383s601.42x
🐘 PostgresNext.js (Turbopack)0.667s1.006s0.339s601.53x
🌐 MongoDBNext.js (Turbopack)0.730s1.006s0.276s601.67x
💻 LocalNext.js (Turbopack)0.737s1.005s0.268s601.68x
🐘 PostgresExpress0.905s (+7.9% 🔺)1.370s (+33.9% 🔺)0.465s452.07x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express4.958s (-73.9% 🟢)6.669s (-68.7% 🟢)1.711s91.00x
▲ VercelNitro5.116s (-76.8% 🟢)6.704s (-72.1% 🟢)1.588s101.03x
▲ VercelNext.js (Turbopack)7.017s (-51.6% 🟢)8.729s (-45.7% 🟢)1.711s71.42x

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

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.022s (-47.0% 🟢)1.585s (-24.5% 🟢)0.564s571.00x
💻 LocalNitro1.161s (-61.7% 🟢)2.005s (-46.6% 🟢)0.844s451.14x
💻 LocalExpress1.307s (-56.7% 🟢)2.006s (-44.0% 🟢)0.700s451.28x
🌐 RedisNext.js (Turbopack)1.492s2.006s0.514s451.46x
🐘 PostgresNext.js (Turbopack)1.604s2.008s0.404s451.57x
💻 LocalNext.js (Turbopack)1.792s2.006s0.214s451.75x
🌐 MongoDBNext.js (Turbopack)1.842s2.007s0.166s451.80x
🐘 PostgresExpress2.094s (+5.9% 🔺)2.560s (+13.4% 🔺)0.467s362.05x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro12.742s (-67.7% 🟢)14.987s (-63.7% 🟢)2.246s71.00x
▲ VercelExpress13.193s (-61.8% 🟢)14.863s (-59.6% 🟢)1.670s71.04x
▲ VercelNext.js (Turbopack)14.895s (-70.1% 🟢)16.716s (-67.7% 🟢)1.822s61.17x

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

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro2.012s (-51.0% 🟢)2.427s (-47.3% 🟢)0.416s501.00x
💻 LocalNitro2.667s (-71.3% 🟢)3.033s (-69.7% 🟢)0.366s401.33x
💻 LocalExpress2.912s (-68.4% 🟢)3.252s (-67.5% 🟢)0.340s371.45x
🌐 RedisNext.js (Turbopack)2.984s3.250s0.267s371.48x
🐘 PostgresNext.js (Turbopack)3.270s4.045s0.775s301.63x
💻 LocalNext.js (Turbopack)3.857s4.075s0.217s301.92x
🐘 PostgresExpress4.078s (+2.2%)4.502s (+3.0%)0.424s272.03x
🌐 MongoDBNext.js (Turbopack)4.220s5.012s0.792s242.10x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro38.819s (-59.9% 🟢)40.985s (-58.4% 🟢)2.166s31.00x
▲ VercelExpress39.658s (-69.5% 🟢)41.705s (-68.4% 🟢)2.048s31.02x
▲ VercelNext.js (Turbopack)46.146s (-56.9% 🟢)47.530s (-56.4% 🟢)1.383s31.19x

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

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.182s (-35.9% 🟢)1.006s (~)0.824s601.00x
🌐 RedisNext.js (Turbopack)0.237s1.004s0.767s601.30x
🐘 PostgresNext.js (Turbopack)0.241s1.006s0.765s601.33x
💻 LocalNitro0.447s (-26.1% 🟢)1.004s (-1.7%)0.557s602.46x
💻 LocalExpress0.478s (-14.7% 🟢)1.005s (~)0.527s602.63x
🐘 PostgresExpress0.511s (+80.8% 🔺)1.148s (+14.0% 🔺)0.637s532.81x
💻 LocalNext.js (Turbopack)0.581s1.005s0.423s603.20x
🌐 MongoDBNext.js (Turbopack)1.036s1.855s0.819s335.70x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.028s (+3.8%)3.796s (+4.4%)1.768s161.00x
▲ VercelNitro2.293s (+38.0% 🔺)4.077s (+21.7% 🔺)1.785s151.13x
▲ VercelNext.js (Turbopack)3.973s (+96.4% 🔺)5.530s (+45.8% 🔺)1.557s111.96x

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

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.310s (-37.4% 🟢)1.006s (~)0.696s901.00x
🌐 RedisNext.js (Turbopack)0.407s1.004s0.597s901.31x
🐘 PostgresNext.js (Turbopack)0.482s1.007s0.524s901.55x
🐘 PostgresExpress0.818s (+60.4% 🔺)1.341s (+33.3% 🔺)0.523s682.63x
💻 LocalExpress2.184s (-13.1% 🟢)3.010s (~)0.825s307.04x
💻 LocalNitro2.198s (-13.4% 🟢)2.944s (-2.2%)0.746s317.08x
🌐 MongoDBNext.js (Turbopack)2.606s3.007s0.400s308.39x
💻 LocalNext.js (Turbopack)2.614s3.149s0.535s298.42x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Next.js (Turbopack)6.797s (+92.3% 🔺)8.510s (+63.9% 🔺)1.713s111.00x
▲ VercelNitro7.928s (+145.8% 🔺)9.974s (+106.8% 🔺)2.046s101.17x
▲ VercelExpress8.062s (+164.6% 🔺)9.804s (+103.9% 🔺)1.742s101.19x

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

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.662s (-16.3% 🟢)1.006s (~)0.344s1201.00x
🌐 RedisNext.js (Turbopack)0.751s1.012s0.261s1191.14x
🐘 PostgresNext.js (Turbopack)0.981s1.521s0.539s801.48x
🐘 PostgresExpress1.706s (+108.3% 🔺)2.295s (+125.6% 🔺)0.589s532.58x
🌐 MongoDBNext.js (Turbopack)5.391s6.014s0.623s208.14x
💻 LocalNitro9.825s (-12.2% 🟢)10.446s (-10.4% 🟢)0.621s1214.85x
💻 LocalExpress10.179s (-9.0% 🟢)10.783s (-9.7% 🟢)0.604s1215.38x
💻 LocalNext.js (Turbopack)11.645s12.330s0.685s1017.60x

▲ Production (Vercel)

WorldFrameworkWorkflow TimeWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express18.117s (+144.2% 🔺)20.127s (+117.7% 🔺)2.009s61.00x
▲ VercelNext.js (Turbopack)19.231s (+86.2% 🔺)21.009s (+71.0% 🔺)1.778s71.06x
▲ VercelNitro23.043s (+198.4% 🔺)25.291s (+169.0% 🔺)2.248s51.27x

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

Stream Benchmarks(includes TTFB metrics)
workflow with stream

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
💻 Local🥇 Nitro1.129s (+428.1% 🔺)2.005s (+99.6% 🔺)0.011s (-14.4% 🟢)2.018s (+98.0% 🔺)0.889s101.00x
🐘 PostgresNitro1.138s (+455.3% 🔺)2.001s (+100.2% 🔺)0.001s (-13.3% 🟢)2.010s (+98.7% 🔺)0.871s101.01x
💻 LocalExpress1.143s (+474.3% 🔺)2.006s (+99.7% 🔺)0.010s (-15.7% 🟢)2.019s (+98.3% 🔺)0.875s101.01x
💻 LocalNext.js (Turbopack)1.190s2.003s0.013s2.020s0.830s101.05x
🐘 PostgresNext.js (Turbopack)1.195s2.001s0.002s2.011s0.815s101.06x
🐘 PostgresExpress1.514s (+638.4% 🔺)2.094s (+109.7% 🔺)0.378s (+23500.0% 🔺)2.508s (+148.0% 🔺)0.994s101.34x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express2.104s (-16.0% 🟢)3.360s (-17.8% 🟢)1.769s (+84.1% 🔺)5.626s (+0.6%)3.521s101.00x
▲ VercelNitro2.336s (-39.0% 🟢)3.612s (-31.6% 🟢)1.861s (+150.7% 🔺)6.014s (-7.2% 🟢)3.678s101.11x
▲ VercelNext.js (Turbopack)5.134s (-25.1% 🟢)5.213s (-39.7% 🟢)1.098s (+73.8% 🔺)7.870s (-19.6% 🟢)2.735s102.44x

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

stream pipeline with 5 transform steps (1MB)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.538s (+146.5% 🔺)2.001s (+98.8% 🔺)0.004s (-12.1% 🟢)2.025s (+98.0% 🔺)0.487s301.00x
💻 LocalExpress1.588s (+109.7% 🔺)2.011s (+95.5% 🔺)0.012s (+25.7% 🔺)2.026s (+94.8% 🔺)0.438s301.03x
🐘 PostgresNext.js (Turbopack)1.705s2.010s0.004s2.026s0.321s301.11x
💻 LocalNext.js (Turbopack)1.866s2.011s0.010s2.203s0.337s281.21x
💻 LocalNitro2.164s (+158.1% 🔺)2.010s (+98.6% 🔺)0.009s (-4.0%)2.675s (+139.7% 🔺)0.510s231.41x
🐘 PostgresExpress2.444s (+288.0% 🔺)2.731s (+171.4% 🔺)0.003s (-19.3% 🟢)2.767s (+170.4% 🔺)0.322s221.59x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express5.877s (-9.6% 🟢)7.234s (-9.7% 🟢)0.232s (-43.4% 🟢)7.955s (-10.0% 🟢)2.078s81.00x
▲ VercelNitro5.894s (-80.0% 🟢)7.169s (-76.7% 🟢)0.258s (+130.4% 🔺)7.895s (-75.2% 🟢)2.001s81.00x
▲ VercelNext.js (Turbopack)13.642s (-19.4% 🟢)13.146s (-27.9% 🟢)0.318s (+50.3% 🔺)15.510s (-18.1% 🟢)1.868s42.32x

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

10 parallel streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro0.694s (-28.3% 🟢)1.030s (-17.5% 🟢)0.000s (-57.9% 🟢)1.060s (-15.7% 🟢)0.366s571.00x
🐘 PostgresNext.js (Turbopack)0.798s1.072s0.000s1.082s0.284s561.15x
💻 LocalNext.js (Turbopack)1.451s2.014s0.000s2.017s0.566s302.09x
💻 LocalExpress1.475s (+20.4% 🔺)2.015s (~)0.000s (~)2.018s (~)0.543s302.12x
💻 LocalNitro1.486s (+21.5% 🔺)2.014s (~)0.000s (+364.3% 🔺)2.195s (+8.6% 🔺)0.709s282.14x
🐘 PostgresExpress2.079s (+116.4% 🔺)2.453s (+92.0% 🔺)0.000s (-100.0% 🟢)2.522s (+93.1% 🔺)0.443s242.99x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Express3.871s (+3.5%)5.345s (+4.7%)0.003s (+1500.0% 🔺)5.771s (+4.4%)1.900s111.00x
▲ VercelNitro3.911s (+28.2% 🔺)5.386s (+22.6% 🔺)0.000s (+254.5% 🔺)5.924s (+23.2% 🔺)2.013s111.01x
▲ VercelNext.js (Turbopack)6.210s (-39.0% 🟢)6.441s (-44.1% 🟢)0.001s (+Infinity% 🔺)7.762s (-35.6% 🟢)1.552s81.60x

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

fan-out fan-in 10 streams (1MB each)

💻 Local Development

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
🐘 Postgres🥇 Nitro1.461s (-18.5% 🟢)2.141s (~)0.000s (~)2.154s (-1.0%)0.693s281.00x
🐘 PostgresNext.js (Turbopack)1.801s2.348s0.000s2.356s0.554s261.23x
💻 LocalNext.js (Turbopack)2.779s3.293s0.001s3.298s0.519s191.90x
💻 LocalNitro2.995s (-11.6% 🟢)3.735s (-7.4% 🟢)0.000s (-89.0% 🟢)3.737s (-7.4% 🟢)0.743s172.05x
💻 LocalExpress3.279s (-5.4% 🟢)3.840s (-4.8%)0.001s (-21.9% 🟢)3.847s (-4.7%)0.568s162.24x
🐘 PostgresExpress3.897s (+119.9% 🔺)4.233s (+94.4% 🔺)0.000s (+Infinity% 🔺)4.354s (+98.0% 🔺)0.458s142.67x
🌐 MongoDBNext.js (Turbopack)⚠️missing-----
🌐 RedisNext.js (Turbopack)⚠️missing-----

▲ Production (Vercel)

WorldFrameworkWorkflow TimeTTFBSlurpWall TimeOverheadSamplesvs Fastest
▲ Vercel🥇 Nitro5.840s (+42.7% 🔺)7.408s (+37.8% 🔺)0.000s (-8.3% 🟢)7.847s (+35.4% 🔺)2.007s81.00x
▲ VercelExpress5.876s (+28.1% 🔺)7.054s (+17.1% 🔺)0.001s (+Infinity% 🔺)7.514s (+16.4% 🔺)1.638s81.01x
▲ VercelNext.js (Turbopack)8.242s (+46.7% 🔺)9.359s (+34.0% 🔺)0.000s (+33.3% 🔺)10.005s (+32.7% 🔺)1.763s61.41x

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

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World🥇 Fastest FrameworkWins
💻 LocalNitro13/21
🐘 PostgresNitro21/21
▲ VercelNitro12/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework🥇 Fastest WorldWins
Express💻 Local15/21
Next.js (Turbopack)🌐 Redis11/21
Nitro🐘 Postgres15/21
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


⚠️Community world benchmarks failed (non-blocking):

  • Community Worlds: failure

Check the workflow run for details.

@github-actions

github-actionsBot commented May 6, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

Summary

PassedFailedSkippedTotal
✅ ▲ Vercel Production120002191419
✅ 💻 Local Development158702191806
✅ 📦 Local Production158702191806
✅ 🐘 Local Postgres158702191806
✅ 🪟 Windows12900129
✅ 📋 Other7270176903
Total6817010527869

Details by Category

✅ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro103026
✅ example103026
✅ express103026
✅ fastify103026
✅ hono103026
✅ nextjs-turbopack12702
✅ nextjs-webpack12702
✅ nitro103026
✅ nuxt103026
✅ sveltekit12207
✅ vite103026
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable104025
✅ express-stable104025
✅ fastify-stable104025
✅ hono-stable104025
✅ nextjs-turbopack-canary110019
✅ nextjs-turbopack-stable-lazy-discovery-disabled12900
✅ nextjs-turbopack-stable-lazy-discovery-enabled12900
✅ nextjs-webpack-canary110019
✅ nextjs-webpack-stable-lazy-discovery-disabled12900
✅ nextjs-webpack-stable-lazy-discovery-enabled12900
✅ nitro-stable104025
✅ nuxt-stable104025
✅ sveltekit-stable12306
✅ vite-stable104025
✅ 🪟 Windows
AppPassedFailedSkipped
✅ nextjs-turbopack12900
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable104025
✅ e2e-local-dev-tanstack-start-104025
✅ e2e-local-postgres-nest-stable104025
✅ e2e-local-postgres-tanstack-start-104025
✅ e2e-local-prod-nest-stable104025
✅ e2e-local-prod-tanstack-start-104025
✅ e2e-vercel-prod-tanstack-start103026

📋 View full workflow run

@karthikscale3
karthikscale3force-pushed the karthik/fix-doc-switcher branch from 42d3fd0 to 4f0c239CompareMay 6, 2026 04:47
## Content restructuring
- Split `docs/content/docs/` into `docs/content/docs/v4/` and
`docs/content/docs/v5/` so each version is a fully independent
content tree with no shared-file coupling
- v4 excludes the four pages that are v5-only (AbortController
cancellation docs and the serializable-abort-controller internal page)
- v5 retains all pages; `preRelease` frontmatter field removed (no
longer needed now that each version is its own folder)
- Removed `AbortController` / `AbortSignal` from v4 serialization page
(section moved to v5 only)
## Fumadocs source
- Added `v4docs` and `v5docs` as separate `defineDocs()` collections in
`source.config.ts`; shared `docsSchema` (no more `preRelease` field)
- `source.ts` exports both `source` (v4, `baseUrl: /docs`) and
`v5Source` (v5, same base URL)
## Version routing
- `version-source.ts` simplified: `filterPreReleaseFromNodes` and
`isPreReleaseUrl` logic removed; v4 tree uses `source`, v5 tree uses
`v5Source` + `rewriteNodeUrls`
- v4 `page.tsx`: removed `preRelease` guard (v4Source has no such pages)
- v5 `page.tsx`: uses `v5Source` for `getPage` / `generateStaticParams`
/ `generateMetadata`; `v5Link` wrapper rewrites `/docs/…` hrefs to
`/v5/docs/…` so inline MDX links stay in the v5 context
## Versioned cookbook
- Added `app/[lang]/v5/cookbook/` layout + page (mirrors v4 but uses
`v5Source`, `rewriteCookbookUrlForVersion`, and `V5CookbookLink`)
- `getCookbookTree` accepts a `versionPrefix` parameter; sidebar URLs
are prefixed accordingly (`/v5/cookbook/…`)
- `cookbook-tree.ts`: added `skipVersions?: string[]` per-recipe field
for version-specific exclusions; `distributed-abort-controller` is
marked `skipVersions: ['v5']`
## Version switcher — state & navigation
- New `VersionProvider` context (`hooks/geistdocs/use-version.tsx`)
backed by `localStorage`: URL is source of truth on versioned pages,
`localStorage` carries the preference across non-versioned pages
(cookbook overview, worlds, etc.)
- `VersionSwitcher` uses `useVersion()` context instead of URL-only
detection; now visible on all pages including cookbook
- `DesktopMenu` and `MobileMenu` use `activeVersion` from context so
the "Docs" and "Cookbook" navbar links resolve to the correct version
prefix on every page
- `buildVersionUrl` expanded to handle `/cookbook/…` paths alongside
`/docs/…`; non-versioned routes (worlds, api) return unchanged
- `switchVersion` does a `HEAD` probe before navigating; falls back to
the versioned cookbook or docs home if the target page doesn't exist
in that version (handles v4-only → v5 and v5-only → v4 cases)
## Cookbook content (v5)
- Rewrote `agent-cancellation` recipe using a single `AbortController`
pattern; removed Hard Cancellation vs Stop Signal two-approach
comparison
- Deleted `distributed-abort-controller` recipe from v5 (native
`AbortController` serialization makes it unnecessary)
- Removed references to distributed-abort-controller from
`cookbook/index.mdx` and `common-patterns/timeouts.mdx`
Co-authored-by: Cursor <cursoragent@cursor.com>
Content moved from docs/content/docs/ to docs/content/docs/v5/ on main
(pre-release channel). Stable branch will use v4/ after backport.
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@karthikscale3@pranaygp