Skip to content

chore(docs): update @vercel/geistdocs to 1.14.0 - #3002

Merged
VaguelySerious merged 3 commits into
mainfrom
docs-geistdocs-1.13.0
Jul 20, 2026
Merged

chore(docs): update @vercel/geistdocs to 1.14.0#3002
VaguelySerious merged 3 commits into
mainfrom
docs-geistdocs-1.13.0

Conversation

@molebox

@moleboxmolebox commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Update the docs app from @vercel/geistdocs 1.11.4 to 1.14.0
  • Move the #nd-page mobile padding and breadcrumb-hiding overrides from viewport-based max-md: rules into a @container (max-width: 960px) block, matching the new container-responsive sidebar (same change as the eve docs update, chore(docs): update @vercel/geistdocs to 1.13.0 eve#955)
  • Wire the new version-switch fallback from geistdocs 1.14.0 (vercel/geistdocs#163): GeistdocsVersionSelect now receives per-version paths (docs + cookbook + worlds, computed with collectVersionPaths), so switching versions from a page that doesn't exist in the target version lands on the nearest existing ancestor — or /docs — instead of a 404 (e.g. /v5/docs/configuration → v4 previously 404'd)

What's in 1.11.4 → 1.14.0

  • 1.14.0: version switcher falls back to the nearest existing page in the target version when given paths (release); Next.js base path support
  • 1.13.0: Vercel Docs-style root and section sidebar navigation, preserving the existing Fumadocs page-tree config, mobile menu APIs, and the v4/v5 version selector; sidebar badges via badge frontmatter (release)
  • 1.12.0: split Copy page menu beside the page title, TOC slots (release)

Version-switch fallback wiring

New docs/lib/geistdocs/version-switch-paths.ts builds the per-version path sets from the existing public-URL route sources (geistdocsSource/cookbookSource/worldsSourceBundle and the /v5 variants); DocsLayout passes them to GeistdocsVersionSelect from all four docs/cookbook layouts.

Complements the static redirects in #3003 (which cover direct links/bookmarks to version-mismatched URLs); this handles the switcher itself for any future page divergence without maintaining redirect lists.

Testing

  • pnpm install, pnpm --filter docs build
  • Runtime-verified against next start: the RSC payload on /v5/docs/configuration carries both path sets (v4: 164 paths without /docs/configuration; v5: 187 paths with it) plus fallbacks, so the v5→v4 switch resolves to /docs → getting-started instead of a 404
  • tsc --noEmit on the docs app: no new errors (pre-existing errors in BenchmarkChart.tsx/github.ts untouched)
  • Biome check passes on the touched files

No changeset needed: docs-app-only change.

@molebox
molebox requested review from a team and ijjk as code ownersJuly 20, 2026 12:17
@vercel

vercelBot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

@changeset-bot

changeset-botBot commented Jul 20, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 38fbfb7

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

@github-actions

github-actionsBot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

Some tests failed

Summary

PassedFailedSkippedTotal
❌ ▲ Vercel Production145212301683
✅ 💻 Local Development161702191836
✅ 📦 Local Production161702191836
✅ 🐘 Local Postgres161702191836
✅ 📋 Other89401771071
✅ vercel-multi-region270027
Total7224110648289

❌ Failed Tests

▲ Vercel Production (1 failed)

nextjs-turbopack (1 failed):

  • AbortController abortVoidSleepTimeoutWorkflow: documented void sleep().then(abort) pattern works

Details by Category

❌ ▲ Vercel Production
AppPassedFailedSkipped
✅ astro126027
✅ example126027
✅ express126027
✅ fastify126027
✅ hono126027
❌ nextjs-turbopack14913
✅ nextjs-webpack15003
✅ nitro126027
✅ nuxt126027
✅ sveltekit14508
✅ vite126027
✅ 💻 Local Development
AppPassedFailedSkipped
✅ astro-stable128025
✅ express-stable128025
✅ fastify-stable128025
✅ hono-stable128025
✅ nextjs-turbopack-canary134019
✅ nextjs-turbopack-stable15300
✅ nextjs-webpack-canary134019
✅ nextjs-webpack-stable15300
✅ nitro-stable128025
✅ nuxt-stable128025
✅ sveltekit-stable14706
✅ vite-stable128025
✅ 📦 Local Production
AppPassedFailedSkipped
✅ astro-stable128025
✅ express-stable128025
✅ fastify-stable128025
✅ hono-stable128025
✅ nextjs-turbopack-canary134019
✅ nextjs-turbopack-stable15300
✅ nextjs-webpack-canary134019
✅ nextjs-webpack-stable15300
✅ nitro-stable128025
✅ nuxt-stable128025
✅ sveltekit-stable14706
✅ vite-stable128025
✅ 🐘 Local Postgres
AppPassedFailedSkipped
✅ astro-stable128025
✅ express-stable128025
✅ fastify-stable128025
✅ hono-stable128025
✅ nextjs-turbopack-canary134019
✅ nextjs-turbopack-stable15300
✅ nextjs-webpack-canary134019
✅ nextjs-webpack-stable15300
✅ nitro-stable128025
✅ nuxt-stable128025
✅ sveltekit-stable14706
✅ vite-stable128025
✅ 📋 Other
AppPassedFailedSkipped
✅ e2e-local-dev-nest-stable128025
✅ e2e-local-dev-tanstack-start-128025
✅ e2e-local-postgres-nest-stable128025
✅ e2e-local-postgres-tanstack-start-128025
✅ e2e-local-prod-nest-stable128025
✅ e2e-local-prod-tanstack-start-128025
✅ e2e-vercel-prod-tanstack-start126027
✅ vercel-multi-region
AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run


Some E2E test jobs failed:

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

Check the workflow run for details.

@github-actions

github-actionsBot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit 38fbfb7 · Mon, 20 Jul 2026 18:10:33 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioAvg (ms)P10 (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep928 (-7.9%)2491274 🔴1295 🔴1869 🔴30
TTFSstream935 (-9.4%)2371250 🔴1272 🔴1304 🔴30
TTFShook + stream1368 (+6.2%)5701530 🔴1637 🔴1775 🔴30
STSO1020 steps (1-20)230 (-6.9%)175256 🔴294 🔴336 🔴19
STSO1020 steps (101-120)263 (+7.8%)219283 🔴380 🔴395 🔴19
STSO1020 steps (1001-1020)539 (+5.1%)469519 🔴562 🔴1159 🔴19
WO1020 steps405727 (+2.3%)4057274057274057274057271
SLstream latency146 (+15%)107165 🔴180 🔴258 🔴30
📜 Previous results (2)

cd76863

Mon, 20 Jul 2026 14:22:18 GMT · run logs

vercel / nextjs-turbopack

MetricScenarioAvg (ms)P10 (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep891 (-19%)2321282 🔴1340 🔴1877 🔴30
TTFSstream1052 (-1.2%)2551279 🔴1310 🔴1347 🔴30
TTFShook + stream1413 (-1.6%)5761545 🔴1611 🔴1699 🔴30
STSO1020 steps (1-20)269 (±0%)197273 🔴510 🔴587 🔴19
STSO1020 steps (101-120)250 (-7.8%)213276 🔴303 🔴337 🔴19
STSO1020 steps (1001-1020)582 (+1.4%)507620 🔴714 🔴745 🔴19
WO1020 steps413953 (-6.7%)4139534139534139534139531
SLstream latency181 (+20%)122192 🔴214 🔴534 🔴30

a0480f8

Mon, 20 Jul 2026 12:32:27 GMT · run logs

vercel / nextjs-turbopack

MetricScenarioAvg (ms)P10 (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep895 (-19%)2411254 🔴1275 🔴1346 🔴30
TTFSstream978 (-8.2%)3171237 🔴1315 🔴1554 🔴30
TTFShook + stream1361 (-5.2%)5261534 🔴1617 🔴1795 🔴30
STSO1020 steps (1-20)255 (-5.0%)199264 🔴325 🔴484 🔴19
STSO1020 steps (101-120)265 (-2.5%)205301 🔴356 🔴375 🔴19
STSO1020 steps (1001-1020)519 (-9.6%)495536 🔴564 🔴571 🔴19
WO1020 steps410461 (-7.5%)4104614104614104614104611
SLstream latency153 (+1.9%)113164 🔴185 🔴437 🔴30

Avg deltas compare against the most recent benchmark run on main at the time of this run.

Metrics — TTFS: time to first step body (in-deployment start() → first step body, deployment clocks) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · SL: stream latency (in-deployment write → read propagation, readAt - writtenAt)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · stream latency: parallel reader/writer steps on a dedicated stream; SL is the in-deployment write->read propagation (readAt - writtenAt)

🟢/🔴 mark percentiles within/above target. Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · STSO (1-20) 20/30/60 · STSO (101-120) 30/45/90 · STSO (1001-1020) 40/60/120

All metrics are measured from deployment-side timestamps only. Runs are triggered by an in-deployment route that stamps the anchor (clientStart) right before start(), so the CI runner’s request and its path through api.vercel.com sit outside every measured window. TTFS = in-deployment start() → first step body (turbo uses the in-process fast path, non-turbo the dispatch path), and includes the VQS dispatch hop plus any /flow cold start. STSO/WO are measured between step bodies on the deployment. SL is measured inside the workflow (parallel reader/writer steps), so it no longer includes the api.vercel.com read path.

Cold starts are kept in the numbers on purpose — they are part of real bursty-workload latency. The workbench deployment cold-starts the /flow invocation for a large fraction of runs, inflating P75+; the P10 column shows the warm-start floor for comparison.

@socket-security

socket-securityBot commented Jul 20, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Addednpm/​@​vercel/​geistdocs@​1.14.0771007399100

View full report

@VaguelySerious
VaguelySerious merged commit 21448a8 into mainJul 20, 2026
101 of 104 checks passed
@VaguelySerious
VaguelySerious deleted the docs-geistdocs-1.13.0 branch July 20, 2026 18:23
@github-actions

Copy link
Copy Markdown
Contributor

No backport to stable for 21448a8 (AI decision).

All changes are confined to the docs app outside of docs/content/ (layouts, components, styles, docs/package.json), which is not maintained on stable — documentation is deployed only from main. The pnpm-lock.yaml change is purely a derived artifact of the docs-app dependency bump, so there is nothing meaningful to backport.

To override, re-run the Backport to stable workflow manually via workflow_dispatch and paste this commit SHA into the ref input:

21448a8ab3c27508a974a923990c9ede03ea3875

pranaygp added a commit that referenced this pull request Jul 21, 2026
* origin/main: (21 commits)
docs(agents): note lint/format/typecheck are advisory, not blocking (#2886)
Retry transient connection timeouts (#3013)
fix(world-vercel): append caller User-Agent products instead of discarding them (#2998)
[ci] Enable NestJS e2e-vercel-prod and add to docs as "experimental" (#3011)
[ci] Benchmark comment: Best column + best/p75/p99 deltas (drop Avg/P10) (#3005)
docs: fall back to first child page for sidebar folders without an index (#3009)
[nest] Fix NestJS Vercel build output (#2988)
Avoid resolving run data for background steps (#2993)
chore(docs): update @vercel/geistdocs to 1.14.0 (#3002)
fix(docs): add version-switcher fallback redirects for pages missing in one version (#3003)
ci: update opencode to 1.18.4 and switch backport AI model to claude-fable-5 (#3006)
fix(core): batch stream writes via writeMulti (#2995)
perf(core): cache port discovery in step invocations for self-hosted worlds (#2996)
feat(web-shared): Alt+hover span measurement in the new trace viewer (#2985)
fix(world-postgres): throw EntityConflictError on duplicate run_created (#2983)
[ci] Run benchmarks in-deployment to avoid proxy overhead (#2967)
Enable additional perf optimizations when correctness guarantees are met (#2970)
perf(core): prepare replay payloads concurrently (#2980)
Fix dotted tsconfig alias workflow discovery (#2963)
Adjust helper position on trace viewer (#2968)
...
pranaygp added a commit that referenced this pull request Jul 21, 2026
* origin/main:
test: regression coverage for hook.resume() from isolated route bundles (o2flow beta.26 incident) (#3001)
docs(agents): note lint/format/typecheck are advisory, not blocking (#2886)
Retry transient connection timeouts (#3013)
fix(world-vercel): append caller User-Agent products instead of discarding them (#2998)
[ci] Enable NestJS e2e-vercel-prod and add to docs as "experimental" (#3011)
[ci] Benchmark comment: Best column + best/p75/p99 deltas (drop Avg/P10) (#3005)
docs: fall back to first child page for sidebar folders without an index (#3009)
[nest] Fix NestJS Vercel build output (#2988)
Avoid resolving run data for background steps (#2993)
chore(docs): update @vercel/geistdocs to 1.14.0 (#3002)
fix(docs): add version-switcher fallback redirects for pages missing in one version (#3003)
ci: update opencode to 1.18.4 and switch backport AI model to claude-fable-5 (#3006)
fix(core): batch stream writes via writeMulti (#2995)
pranaygp added a commit that referenced this pull request Jul 22, 2026
* origin/main: (162 commits)
Implement `max_events` per run limit (#2986)
[core] Enforce maxRetries for steps that time out (#3035)
[world-vercel] Idempotent retry policy for stream close (5xx retriable) (#3038)
[world] Guard hook_received against a concurrent run termination (#2987)
docs: fix stale/incorrect v5 API reference details (#3017)
Default WORKFLOW_PRECONDITION_GUARD on (#2946)
docs: replace migration guides with a Comparisons section (#2676)
feat(core): add experimental Hook minimum retention (#2865)
test: regression coverage for hook.resume() from isolated route bundles (o2flow beta.26 incident) (#3001)
docs(agents): note lint/format/typecheck are advisory, not blocking (#2886)
Retry transient connection timeouts (#3013)
fix(world-vercel): append caller User-Agent products instead of discarding them (#2998)
[ci] Enable NestJS e2e-vercel-prod and add to docs as "experimental" (#3011)
[ci] Benchmark comment: Best column + best/p75/p99 deltas (drop Avg/P10) (#3005)
docs: fall back to first child page for sidebar folders without an index (#3009)
[nest] Fix NestJS Vercel build output (#2988)
Avoid resolving run data for background steps (#2993)
chore(docs): update @vercel/geistdocs to 1.14.0 (#3002)
fix(docs): add version-switcher fallback redirects for pages missing in one version (#3003)
ci: update opencode to 1.18.4 and switch backport AI model to claude-fable-5 (#3006)
...
# Conflicts:
#	docs/content/docs/v4/deploying/meta.json
#	docs/content/docs/v5/deploying/meta.json
#	packages/core/src/runtime.ts
#	packages/world-local/src/index.ts
#	packages/world-postgres/src/index.ts
#	packages/world/src/events.ts
#	packages/world/src/interfaces.ts
#	packages/world/src/recovery.ts
#	workbench/nest/src/main.ts
#	workbench/sveltekit/src/hooks.server.ts
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

@molebox@VaguelySerious