hey-api · mrlubos · Nov 4, 2025 · Nov 3, 2025 · Nov 3, 2025 · Nov 4, 2025
diff --git a/.changeset/seven-walls-return.md b/.changeset/seven-walls-return.md
@@ -0,0 +1,9 @@
+---
+'@hey-api/openapi-ts': minor
+---
+
+feat: remove legacy clients and plugins
+
+### Removed legacy clients
+
+This release removes support for legacy clients and plugins. Please migrate to the new clients if you haven't done so yet. If you're unable to do so due to a missing feature, let us know on [GitHub](https://github.com/hey-api/openapi-ts/issues).
diff --git a/dev/openapi-ts.config.ts b/dev/openapi-ts.config.ts
@@ -36,15 +36,15 @@ export default defineConfig(() => {
           // },
           path: path.resolve(
             getSpecsPath(),
-            '3.0.x',
-            // '3.1.x',
+            // '3.0.x',
+            '3.1.x',
             // 'circular.yaml',
             // 'dutchie.json',
             // 'invalid',
             // 'openai.yaml',
             // 'full.yaml',
-            // 'opencode.yaml',
-            'sdk-circular-bug.yaml',
+            'opencode.yaml',
+            // 'sdk-circular-bug.yaml',
             // 'sdk-instance.yaml',
             // 'string-with-format.yaml',
             // 'transformers.json',
@@ -265,14 +265,14 @@ export default defineConfig(() => {
           instance: true,
           name: '@hey-api/sdk',
           // operationId: false,
-          // paramsStructure: 'flat',
+          paramsStructure: 'flat',
           // responseStyle: 'data',
           // signature: 'auto',
           // signature: 'client',
           // signature: 'object',
           // transformer: '@hey-api/transformers',
-          transformer: true,
-          validator: true,
+          // transformer: true,
+          // validator: true,
           // validator: {
           //   request: 'zod',
           //   response: 'zod',
@@ -294,7 +294,7 @@ export default defineConfig(() => {
         {
           // bigInt: true,
           // dates: true,
-          name: '@hey-api/transformers',
+          // name: '@hey-api/transformers',
         },
         {
           // name: 'fastify',

diff --git a/dev/package.json b/dev/package.json
@@ -7,45 +7,17 @@
     "node": ">=20.19.0"
   },
   "devDependencies": {
-    "@angular-devkit/build-angular": "19.2.19",
-    "@angular/animations": "19.2.15",
-    "@angular/cli": "19.2.19",
-    "@angular/common": "19.2.15",
-    "@angular/compiler": "19.2.15",
-    "@angular/compiler-cli": "19.2.15",
-    "@angular/core": "19.2.15",
-    "@angular/forms": "19.2.15",
-    "@angular/platform-browser": "19.2.15",
-    "@angular/platform-browser-dynamic": "19.2.15",
-    "@angular/router": "19.2.15",
-    "@config/vite-base": "workspace:*",
     "@hey-api/codegen-core": "workspace:*",
-    "@hey-api/custom-client": "workspace:*",
     "@hey-api/openapi-ts": "workspace:*",
     "@pinia/colada": "0.17.7",
     "@tanstack/angular-query-experimental": "5.73.3",
     "@tanstack/react-query": "5.73.3",
     "@tanstack/solid-query": "5.73.3",
     "@tanstack/svelte-query": "5.73.3",
     "@tanstack/vue-query": "5.73.3",
-    "@types/cross-spawn": "6.0.6",
-    "ajv": "8.17.1",
     "arktype": "2.1.25",
-    "axios": "1.8.2",
-    "cross-spawn": "7.0.6",
-    "eslint": "9.17.0",
-    "fastify": "5.2.0",
-    "glob": "11.0.3",
-    "node-fetch": "3.3.2",
-    "nuxt": "3.14.1592",
-    "ofetch": "1.4.1",
-    "prettier": "3.4.2",
-    "rxjs": "7.8.2",
-    "ts-node": "10.9.2",
-    "tslib": "2.8.1",
     "typescript": "5.9.3",
     "valibot": "1.1.0",
-    "vue": "3.5.13",
     "zod": "4.1.12"
   }
 }
diff --git a/docs/.vitepress/config/en.ts b/docs/.vitepress/config/en.ts
@@ -119,10 +119,6 @@ export default defineConfig({
                 link: '/openapi-ts/clients/ky',
                 text: 'Ky <span data-soon>soon</span>',
               },
-              {
-                link: '/openapi-ts/clients/legacy',
-                text: 'Legacy',
-              },
             ],
             link: '/openapi-ts/clients',
             text: 'Clients',

diff --git a/docs/index.md b/docs/index.md
@@ -3,7 +3,7 @@ layout: home
 
 hero:
   name: One OpenAPI spec.<br/>Infinite outputs.
-  tagline: Codegen for JavaScript/TypeScript projects. Trusted over 3,000,000 times each month to generate reliable API clients and SDKs.
+  tagline: Code generator for TypeScript projects. Trusted by companies like Google, Amazon, and PayPal to generate API clients, SDKs, validators, and more.
   actions:
     - link: /openapi-ts/get-started
       text: Get Started

diff --git a/docs/openapi-ts/clients.md b/docs/openapi-ts/clients.md
@@ -34,7 +34,6 @@ Hey API natively supports the following clients.
 - [Effect](/openapi-ts/clients/effect) <span data-soon>Soon</span>
 - [Got](/openapi-ts/clients/got) <span data-soon>Soon</span>
 - [Ky](/openapi-ts/clients/ky) <span data-soon>Soon</span>
-- [Legacy](/openapi-ts/clients/legacy)
 
 Don't see your client? [Build your own](/openapi-ts/clients/custom) or let us know your interest by [opening an issue](https://github.com/hey-api/openapi-ts/issues).
 

diff --git a/docs/openapi-ts/clients/legacy.md b/docs/openapi-ts/clients/legacy.md
diff --git a/docs/openapi-ts/get-started.md b/docs/openapi-ts/get-started.md
@@ -9,7 +9,10 @@ import { embedProject } from '../embed'
 
 # Get Started
 
-[@hey-api/openapi-ts](https://github.com/hey-api/openapi-ts) is an OpenAPI to TypeScript codegen trusted over 3,000,000 times each month to generate reliable API clients and SDKs. The code is [MIT-licensed](/openapi-ts/license) and free to use. Discover available features below or view our [roadmap](https://github.com/orgs/hey-api/discussions/1495) to learn what's coming next.
+[@hey-api/openapi-ts](https://github.com/hey-api/openapi-ts) is an [open source](/openapi-ts/license) OpenAPI to TypeScript code generator trusted by companies like Google, Amazon, and PayPal to generate API clients, SDKs, validators, and more. We also build complementary tools and [services](https://app.heyapi.dev/) that help teams design, manage, and distribute APIs more effectively.
+
+> “OpenAPI codegen that just works.”
+> — Guillermo Rauch
 
 ### Demo
 

diff --git a/docs/openapi-ts/migrating.md b/docs/openapi-ts/migrating.md
@@ -7,6 +7,12 @@ description: Migrating to @hey-api/openapi-ts.
 
 While we try to avoid breaking changes, sometimes it's unavoidable in order to offer you the latest features. This page lists changes that require updates to your code. If you run into a problem with migration, please [open an issue](https://github.com/hey-api/openapi-ts/issues).
 
+## v0.87.0
+
+### Removed legacy clients
+
+This release removes support for legacy clients and plugins. Please migrate to the new clients if you haven't done so yet. If you're unable to do so due to a missing feature, let us know on [GitHub](https://github.com/hey-api/openapi-ts/issues).
+
 ## v0.86.0
 
 ### Removed Node 18 support

diff --git a/eslint.config.js b/eslint.config.js
@@ -66,8 +66,6 @@ export default tseslint.config(
       'temp/',
       'dev/.gen/',
       'examples/openapi-ts-openai/src/client/**/*.ts',
-      'packages/openapi-ts/src/legacy/handlebars/compiled/**/*.js',
-      'packages/openapi-ts/src/legacy/handlebars/templates/**/*.hbs',
       '**/test/generated/',
       '**/__snapshots__/',
       '**/.next/',

diff --git a/packages/codegen-core/README.md b/packages/codegen-core/README.md
@@ -15,17 +15,13 @@
   <a href="https://github.com/hey-api/openapi-ts/issues">Issues</a>
   <span>&nbsp;•&nbsp;</span>
   <a href="https://heyapi.dev/openapi-ts/community/contributing">Contribute</a>
-  <span>&nbsp;•&nbsp;</span>
-  <a href="https://heyapi.dev/openapi-ts/community/spotlight#core-team">Join Core Team</a>
 </p>
 
 <br/>
 
 ## Dashboard
 
-Hey API is an ecosystem of products helping you build better APIs. Superpower your codegen and APIs with Hey API Platform.
-
-[Sign In](https://app.heyapi.dev) to Hey API Platform.
+Access your projects and OpenAPI specifications in the [Hey API Platform](https://app.heyapi.dev/).
 
 ## Contributing
 

diff --git a/packages/nuxt/README.md b/packages/nuxt/README.md
@@ -20,9 +20,7 @@
 
 ## Dashboard
 
-Hey API is an ecosystem of products helping you build better APIs. Superpower your codegen and APIs with Hey API Platform.
-
-[Sign In](https://app.heyapi.dev) to Hey API Platform.
+Access your projects and OpenAPI specifications in the [Hey API Platform](https://app.heyapi.dev/).
 
 ## Contributing
 

diff --git a/packages/openapi-ts-tests/main/package.json b/packages/openapi-ts-tests/main/package.json
@@ -43,7 +43,6 @@
     "cross-spawn": "7.0.6",
     "eslint": "9.17.0",
     "fastify": "5.2.0",
-    "glob": "11.0.3",
     "node-fetch": "3.3.2",
     "nuxt": "3.14.1592",
     "ofetch": "1.4.1",

diff --git a/packages/openapi-ts-tests/main/test/__snapshots__/test/generated/v2/core/ApiError.ts.snap b/packages/openapi-ts-tests/main/test/__snapshots__/test/generated/v2/core/ApiError.ts.snap
diff --git a/...openapi-ts-tests/main/test/__snapshots__/test/generated/v2/core/ApiRequestOptions.ts.snap b/...openapi-ts-tests/main/test/__snapshots__/test/generated/v2/core/ApiRequestOptions.ts.snap
diff --git a/packages/openapi-ts-tests/main/test/__snapshots__/test/generated/v2/core/ApiResult.ts.snap b/packages/openapi-ts-tests/main/test/__snapshots__/test/generated/v2/core/ApiResult.ts.snap