Skip to content

[DO NOT MERGE]: upgrade @vercel/geistdocs to 1.17.1 - #3170

Draft
christopherkindl wants to merge 9 commits into
mainfrom
chore/upgrade-geistdocs-1.17.1
Draft

[DO NOT MERGE]: upgrade @vercel/geistdocs to 1.17.1#3170
christopherkindl wants to merge 9 commits into
mainfrom
chore/upgrade-geistdocs-1.17.1

Conversation

@christopherkindl

Copy link
Copy Markdown
Member

Summary

Upgrades the docs app to @vercel/geistdocs@1.17.1 and applies the follow-on styling to match the new Geist heading system.

  • Bump @vercel/geistdocs 1.14.0 → 1.17.1; adopt the package's LogoWorkflowSdk (new artwork at its tuned default height) and fix the <Footer /> prop removal.
  • Use the package's default OSS product list via navbarActiveProduct: 'workflow-sdk' instead of a hand-maintained navbarOssProducts override.
  • Switch docs/cookbook/v5 surfaces to bg-background-200 to match the template.
  • Adopt the package text-heading-* utilities (Geist 450 weight) across the homepage and /worlds headings, plus the feature-grid paragraph text.
  • Homepage layout: remove the bordered section grid + vertical column dividers; make the "Get started" CTA rounded-full.

Verification

  • pnpm --filter docs build passes.
  • Verified in the browser: navbar logo, footer, OSS flyout (Workflow SDK excluded), docs/worlds backgrounds, heading weights (450), and the homepage layout changes.

Picks up the new footer (Footer no longer takes a config prop), the
heading font-weight change to 450, and the tightened navbar OSS-menu
marks. Also switches the site's own navbar logo from the vendored
geistcn LogoWorkflow fallback to the package's LogoWorkflowSdk, using
its new tuned default height instead of a hardcoded 15.

Fixes a resulting regression: navbarOssProducts entries lacked an `id`,
so resolveOssProducts' `product.id !== activeProduct` filter evaluated
to `undefined !== undefined` (false) for every entry and emptied the
OSS flyout. Added stable `id`/`label` values to each entry.
…ride

The manual navbarOssProducts array (with local logo imports/heights) is
no longer needed now that the package's DEFAULT_OSS_PRODUCTS list
already includes all these SDKs with proper id/label/section values.
navbarActiveProduct: 'workflow-sdk' now handles self-exclusion instead.
The docs, cookbook, and v5 route layouts plus the shared DocsLayout
container hardcoded bg-background-100 (pure white), so /docs/* pages
rendered on a lighter surface than the rest of the site. Switch them to
bg-background-200, matching the geistdocs template's page background.
The marketing homepage headings hardcoded font-semibold (weight 600)
plus manual responsive sizes/tracking, so they rendered heavier than
the docs headings that now use Geist's 450 heading weight. Swap each
display heading to the package's text-heading-* utilities, which bundle
the 450 weight, line-height, and tracking, mapped across breakpoints to
the nearest design-system size. Inline label/emphasis spans keep their
own weight.
Extends the homepage heading change to the /worlds section: the world
listing, detail, compare, and building-a-world pages plus their
components hardcoded font-semibold display headings. Swap each to the
package's text-heading-* utilities (450 weight + line-height +
tracking), mapped across breakpoints to the nearest design-system size.
Mono stat numbers, per-benchmark item labels, and the dialog title keep
their own weight.
The homepage sections were wrapped in a grid divide-y border-y sm:border-x
container, drawing side borders and divider lines between every section.
Drop that framing so the sections flow with whitespace separation.
Drop the divide-x column dividers still drawn inside the use-cases
(3-col), feature-grid (2-col), and templates sections, so no vertical
lines remain after the section-grid removal. Section padding keeps the
columns visually separated.
The two 2-col feature blurbs ("Deep integration with AI SDK.",
"Durable agents by default.") hardcoded their size/leading/tracking
plus font-medium/font-semibold weights. Those manual sizes already
equal text-heading-20/24, so swap to text-heading-20 lg:text-heading-24
— same sizes, but the Geist 450 heading weight (lead drops 600 -> 500
via the utility's [&>strong] rule). The lead stays gray-1000 for
emphasis; body stays gray-900.
@christopherkindl
christopherkindl requested review from a team and ijjk as code owners July 28, 2026 22:05
@changeset-bot

changeset-bot Bot commented Jul 28, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: bf849f7

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

vercel Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Jul 28, 2026 10:08pm
example-nextjs-workflow-webpack Ready Ready Preview, Comment Jul 28, 2026 10:08pm
example-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-astro-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-express-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-fastify-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-hono-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-nestjs-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-nitro-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-nuxt-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-sveltekit-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-tanstack-start-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workbench-vite-workflow Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workflow-docs Ready Ready Preview, Comment, Open in v0 Jul 28, 2026 10:08pm
workflow-swc-playground Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workflow-tarballs Ready Ready Preview, Comment Jul 28, 2026 10:08pm
workflow-web Ready Ready Preview, Comment Jul 28, 2026 10:08pm

@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

E2E Test Summary

Summary
Passed Failed Skipped Total
✅ ▲ Vercel Production 1455 0 239 1694
✅ 💻 Local Development 1621 0 227 1848
✅ 📦 Local Production 1621 0 227 1848
✅ 🐘 Local Postgres 1621 0 227 1848
✅ 🪟 Windows 154 0 0 154
✅ 📋 Other 1020 0 212 1232
✅ vercel-multi-region 27 0 0 27
Total 7519 0 1132 8651
Details by Category

✅ ▲ Vercel Production

App Passed Failed Skipped
✅ astro 126 0 28
✅ example 126 0 28
✅ express 126 0 28
✅ fastify 126 0 28
✅ hono 126 0 28
✅ nextjs-turbopack 151 0 3
✅ nextjs-webpack 151 0 3
✅ nitro 126 0 28
✅ nuxt 126 0 28
✅ sveltekit 145 0 9
✅ vite 126 0 28

✅ 💻 Local Development

App Passed Failed Skipped
✅ astro-stable 128 0 26
✅ express-stable 128 0 26
✅ fastify-stable 128 0 26
✅ hono-stable 128 0 26
✅ nextjs-turbopack-canary 135 0 19
✅ nextjs-turbopack-stable 154 0 0
✅ nextjs-webpack-canary 135 0 19
✅ nextjs-webpack-stable 154 0 0
✅ nitro-stable 128 0 26
✅ nuxt-stable 128 0 26
✅ sveltekit-stable 147 0 7
✅ vite-stable 128 0 26

✅ 📦 Local Production

App Passed Failed Skipped
✅ astro-stable 128 0 26
✅ express-stable 128 0 26
✅ fastify-stable 128 0 26
✅ hono-stable 128 0 26
✅ nextjs-turbopack-canary 135 0 19
✅ nextjs-turbopack-stable 154 0 0
✅ nextjs-webpack-canary 135 0 19
✅ nextjs-webpack-stable 154 0 0
✅ nitro-stable 128 0 26
✅ nuxt-stable 128 0 26
✅ sveltekit-stable 147 0 7
✅ vite-stable 128 0 26

✅ 🐘 Local Postgres

App Passed Failed Skipped
✅ astro-stable 128 0 26
✅ express-stable 128 0 26
✅ fastify-stable 128 0 26
✅ hono-stable 128 0 26
✅ nextjs-turbopack-canary 135 0 19
✅ nextjs-turbopack-stable 154 0 0
✅ nextjs-webpack-canary 135 0 19
✅ nextjs-webpack-stable 154 0 0
✅ nitro-stable 128 0 26
✅ nuxt-stable 128 0 26
✅ sveltekit-stable 147 0 7
✅ vite-stable 128 0 26

✅ 🪟 Windows

App Passed Failed Skipped
✅ nextjs-turbopack 154 0 0

✅ 📋 Other

App Passed Failed Skipped
✅ e2e-local-dev-nest-stable 128 0 26
✅ e2e-local-dev-tanstack-start- 128 0 26
✅ e2e-local-postgres-nest-stable 128 0 26
✅ e2e-local-postgres-tanstack-start- 128 0 26
✅ e2e-local-prod-nest-stable 128 0 26
✅ e2e-local-prod-tanstack-start- 128 0 26
✅ e2e-vercel-prod-nest 126 0 28
✅ e2e-vercel-prod-tanstack-start 126 0 28

✅ vercel-multi-region

App Passed Failed Skipped
✅ nextjs-turbopack 27 0 0

📋 View full workflow run

@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit bf849f7 · Tue, 28 Jul 2026 22:28:00 GMT · run logs

Backend: vercel · app: nextjs-turbopack

Metric Scenario Best (ms) P75 (ms) P90 (ms) P99 (ms) Samples
TTFS step 1273 (+80%) 🔻 1377 🔴 (+36%) 🔻 1406 🔴 (+38%) 🔻 1448 🔴 (-4.0%) 30
TTFS stream 1118 (+17%) 🔻 1400 🔴 (+42%) 🔻 1586 🔴 (+57%) 🔻 1886 🔴 (+79%) 🔻 30
TTFS hook + stream 1336 (+10%) 1672 🔴 (+30%) 🔻 1725 🔴 (+29%) 🔻 1938 🔴 (+20%) 🔻 30
STSO 1020 steps (1-20) 181 (+13%) 274 🔴 (+6.6%) 315 🔴 (+4.0%) 334 🔴 (-21%) 💚 19
STSO 1020 steps (101-120) 200 (+8.1%) 260 🔴 (+6.1%) 372 🔴 (+32%) 🔻 401 🔴 (-43%) 💚 19
STSO 1020 steps (1001-1020) 463 (-0.9%) 523 🔴 (-7.4%) 670 🔴 (+9.8%) 778 🔴 (+13%) 19
WO 1020 steps 398166 (+3.2%) 398166 (+3.2%) 398166 (+3.2%) 398166 (+3.2%) 1
SL stream latency 104 (+28%) 🔻 170 🔴 (+29%) 🔻 204 🔴 (+46%) 🔻 386 🔴 (+116%) 🔻 30
SO stream overhead (text) 123 (+22%) 🔻 211 (+17%) 🔻 263 (+30%) 🔻 851 (+240%) 🔻 30
SO stream overhead (structured) 116 (+17%) 🔻 180 (+11%) 198 (+1.5%) 299 (+38%) 🔻 30
ℹ️ Metric definitions & methodology

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

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) · SO: stream overhead (end-to-end write+consume time beyond the modelled generation window)

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) · stream overhead (text): writer streams 300 variable-length text token deltas paced at 100/s for 3s (a haiku-size LLM's token throughput) while a parallel reader drains the whole stream; SO is the end-to-end write+consume time beyond the 3s generation window (overhead/backpressure) · stream overhead (structured): same workload as stream overhead (text), but each delta is an AI-SDK-style structured object ({ type: 'text-delta', id, text }) instead of a raw string, so the SO gap vs the text scenario is the added serialization cost

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600 · SL 50/60/125 · SO 250/500/1000 · 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 Best column shows the fastest (warm-start) sample for comparison.

Sign up for free to 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.

1 participant