Skip to content

Compare kubb v4/v5 against hey-api and orval in the migration guide - #160

Merged
stijnvanhulle merged 3 commits into
mainfrom
claude/migration-guide-timing-validation-1dnhvc
Jul 18, 2026
Merged

Compare kubb v4/v5 against hey-api and orval in the migration guide#160
stijnvanhulle merged 3 commits into
mainfrom
claude/migration-guide-timing-validation-1dnhvc

Conversation

@stijnvanhulle

Copy link
Copy Markdown
Contributor

🎯 Changes

Follow-up to #159. Adds a "Compared to other codegen tools" section to docs/5.x/migration.md, benchmarking kubb v4, kubb v5, @hey-api/openapi-ts@0.99.0, and orval@8.22.0 on the same harness (all generating TypeScript types + an axios client + Zod schemas), across small/medium/big specs:

  • A benchmark-machine table (OS, CPU, cores, memory, Node version).
  • Four <ToolComparison /> charts (time, memory, files, output size) as small multiples across spec sizes.
  • A <ToolScorecard /> per-tool profile on the big spec, plus a ranked summary table (points per metric placement).

Mirrors a shorter version of the speed comparison into blog/v5.md's existing speed section, and relabels the original <SpeedComparison /> bars from "v4"/"v5" to "kubb v4"/"kubb v5" for clarity now that other tools are compared alongside kubb (companion change in kubb-labs/platform).

Requires the ToolComparison/ToolScorecard components from the companion kubb-labs/platform PR to render correctly on the live site.

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I am using USA English (serialize, color, center, canceled, analyze, license).
  • I ran the humanizer check on any new documentation I wrote.

Generated by Claude Code

Adds a "Compared to other codegen tools" section to the migration
guide: a benchmark-machine table, per-metric ToolComparison charts
(time, memory, files, output size) across small/medium/big specs,
and an overall per-tool scorecard with a ranked summary. Mirrors a
shorter version into the v5 blog post's speed section. Labels the
existing v4-vs-v5 chart bars "kubb v4"/"kubb v5" for clarity now that
other tools are compared alongside kubb.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019xRkYw3bDucJ342j15p9yg
@changeset-bot

changeset-bot Bot commented Jul 18, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 47b92fc

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.

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

claude added 2 commits July 18, 2026 17:40
Not needed in the docs. Keeps the v4-vs-v5 Performance section as-is.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019xRkYw3bDucJ342j15p9yg
…tion

Replaces the vague "measured on the CI runner" note with the actual
OS, CPU, core count, memory, and Node version used.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019xRkYw3bDucJ342j15p9yg
@stijnvanhulle
stijnvanhulle merged commit 5b7b316 into main Jul 18, 2026
1 check passed
@github-actions
github-actions Bot deleted the claude/migration-guide-timing-validation-1dnhvc branch July 18, 2026 17:49
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.

2 participants