hey-api · mrlubos · Jul 25, 2025 · Jul 25, 2025
diff --git a/docs/.vitepress/config/en.ts b/docs/.vitepress/config/en.ts
@@ -5,6 +5,10 @@ export default defineConfig({
     '🚀 The OpenAPI to TypeScript codegen. Generate clients, SDKs, validators, and more.',
   lang: 'en-US',
   themeConfig: {
+    editLink: {
+      pattern: 'https://github.com/hey-api/openapi-ts/edit/main/docs/:path',
+      text: 'Edit',
+    },
     footer: {
       message: 'Released under the MIT License.',
     },
@@ -14,6 +18,10 @@ export default defineConfig({
         text: 'Sponsor Hey API',
       },
     ],
+    outline: {
+      label: 'Table of Contents',
+      level: 2,
+    },
     sidebar: [
       {
         items: [
@@ -236,6 +244,21 @@ export default defineConfig({
             text: 'Spotlight',
           },
           {
+            collapsed: true,
+            items: [
+              {
+                link: '/openapi-ts/community/contributing/building',
+                text: 'Building',
+              },
+              {
+                link: '/openapi-ts/community/contributing/developing',
+                text: 'Developing',
+              },
+              {
+                link: '/openapi-ts/community/contributing/testing',
+                text: 'Testing',
+              },
+            ],
             link: '/openapi-ts/community/contributing',
             text: 'Contributing',
           },

diff --git a/docs/.vitepress/config/shared.ts b/docs/.vitepress/config/shared.ts
@@ -64,7 +64,8 @@ export default defineConfig({
       provider: 'local',
     },
     socialLinks: [
-      { icon: 'npm', link: 'https://npmjs.com/package/@hey-api/openapi-ts' },
+      { icon: 'linkedin', link: 'https://linkedin.com/company/heyapi' },
+      { icon: 'x', link: 'https://x.com/mrlubos' },
       { icon: 'github', link: 'https://github.com/hey-api/openapi-ts' },
     ],
   },

diff --git a/docs/.vitepress/theme/components/FeatureStatus.vue b/docs/.vitepress/theme/components/FeatureStatus.vue
@@ -0,0 +1,23 @@
+<script setup lang="ts">
+const props = defineProps<{
+  issueNumber: number;
+  name: string;
+}>();
+</script>
+
+<template>
+  <div class="warning custom-block">
+    <p class="custom-block-title">Excited about {{ props.name }}?</p>
+    <p>
+      Help us prioritize this feature by voting on
+      <a
+        :href="`https://github.com/hey-api/openapi-ts/issues/${props.issueNumber}`"
+        rel="noreferrer"
+        target="_blank"
+        >GitHub</a
+      >
+      or consider becoming a
+      <a href="/openapi-ts/community/spotlight">contributor</a>.
+    </p>
+  </div>
+</template>
diff --git a/docs/.vitepress/theme/components/Heading.vue b/docs/.vitepress/theme/components/Heading.vue
@@ -1,5 +1,11 @@
+<script setup lang="ts">
+const props = defineProps<{
+  spaceBetween?: boolean;
+}>();
+</script>
+
 <template>
-  <div class="container">
+  <div class="container" :class="{ 'space-between': props.spaceBetween }">
     <slot />
   </div>
 </template>
@@ -10,4 +16,8 @@
   column-gap: 1rem;
   display: flex;
 }
+
+.space-between {
+  justify-content: space-between;
+}
 </style>
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
@@ -6,6 +6,7 @@ import DefaultTheme from 'vitepress/theme';
 import './custom.css';
 
 import AuthorsList from './components/AuthorsList.vue';
+import FeatureStatus from './components/FeatureStatus.vue';
 import Heading from './components/Heading.vue';
 import VersionLabel from './components/VersionLabel.vue';
 import VersionSwitcher from './components/VersionSwitcher.vue';
@@ -15,6 +16,7 @@ export default {
   Layout,
   enhanceApp: ({ app }) => {
     app.component('AuthorsList', AuthorsList);
+    app.component('FeatureStatus', FeatureStatus);
     app.component('Heading', Heading);
     app.component('VersionLabel', VersionLabel);
     app.component('VersionSwitcher', VersionSwitcher);

diff --git a/docs/openapi-ts/clients/axios.md b/docs/openapi-ts/clients/axios.md
@@ -12,10 +12,6 @@ import { embedProject } from '../../embed'
   <VersionLabel value="v1" />
 </Heading>
 
-::: warning
-Axios client is currently in beta. The interface might change before it becomes stable. We encourage you to leave feedback on [GitHub](https://github.com/hey-api/openapi-ts/issues).
-:::
-
 ### About
 
 [Axios](https://axios-http.com) is a simple promise based HTTP client for the browser and Node.js. Axios provides a simple to use library in a small package with a very extensible interface.

diff --git a/docs/openapi-ts/clients/fetch.md b/docs/openapi-ts/clients/fetch.md
@@ -9,10 +9,6 @@ import { embedProject } from '../../embed'
 
 # Fetch API
 
-::: warning
-Fetch API client is currently in beta. The interface might change before it becomes stable. We encourage you to leave feedback on [GitHub](https://github.com/hey-api/openapi-ts/issues).
-:::
-
 ### About
 
 The [Fetch API](https://developer.mozilla.org/docs/Web/API/Fetch_API) provides an interface for fetching resources (including across the network). It is a more powerful and flexible replacement for XMLHttpRequest.

diff --git a/docs/openapi-ts/clients/next-js.md b/docs/openapi-ts/clients/next-js.md
@@ -5,10 +5,6 @@ description: Next.js client for Hey API. Compatible with all our features.
 
 # Next.js
 
-::: warning
-Next.js client is currently in beta. The interface might change before it becomes stable. We encourage you to leave feedback on [GitHub](https://github.com/hey-api/openapi-ts/issues).
-:::
-
 ### About
 
 [Next.js](https://nextjs.org) is the React framework for the web. Used by some of the world's largest companies, Next.js enables you to create high-quality web applications with the power of React components.

diff --git a/docs/openapi-ts/community/contributing.md b/docs/openapi-ts/community/contributing.md
@@ -1,21 +1,42 @@
 ---
 title: Contributing
-description: Learn how to contribute to @hey-api/openapi-ts.
+description: Learn how to contribute to Hey API.
 ---
 
-# Contributing
+# Contributor Manual
 
-Thank you for considering contributing to Hey API. In order to increase the likelihood of your changes being merged, first open an issue if one does not already exist. Once an issue exists, let us know you'd like to work on it. We will confirm whether we're looking to resolve the issue and provide you with guidance if required. This is to ensure our codebase remains in good state and all features contribute to Hey API's objectives.
+## Foreword
 
-## Prerequisites
+Hey API is building an OpenAPI to TypeScript code generator ecosystem. It’s trusted by thousands of companies – from YC startups to Fortune 500 enterprises – and powers products used by millions worldwide.
 
-You should have a working knowledge of [git](https://git-scm.com), [node](https://nodejs.org/en), and [pnpm](https://pnpm.io).
+We welcome contributors of all backgrounds and experience levels. Whether you’re fixing a typo or building a new feature, your input matters. If you need guidance, help with technical writing, or want to bring a feature idea to life, we’re here to support you.
 
-## Guidelines
+::: tip
 
-Your [pull request](https://help.github.com/articles/using-pull-requests) must:
+New to open source? Take a look at the [Open Source](https://opensource.guide/) or [First Contributions](https://github.com/firstcontributions/first-contributions) guides for helpful information on contributing to open source projects.
 
-- address a single issue or add a single item of functionality
-- contain a clean history of small, incremental, logically separate commits, with no merge commits
-- use clear commit messages
-- be possible to merge automatically
+:::
+
+## First Steps
+
+There are many ways to contribute to Hey API. Most of them don't involve writing any code!
+
+- **Read the documentation**. Start with the [Get Started](/openapi-ts/get-started) guide. If you find anything broken or confusing, you can suggest improvements by clicking "Edit" at the bottom of any page.
+
+- **Browse open issues**. Help others by providing workarounds, asking for clarification, triaging, or suggesting labels on [open issues](https://github.com/hey-api/openapi-ts/issues). If you see something you would like to work on, consider opening a pull request.
+
+- **Participate in discussions**. Ask or [answer questions](https://github.com/orgs/hey-api/discussions), provide feedback, or suggest new ideas. Every idea is welcome, no matter how big or small.
+
+- **Engage on social media**. Help others discover Hey API by engaging with our posts on [LinkedIn](https://linkedin.com/company/heyapi), [Bluesky](https://bsky.app/profile/heyapi.dev), or [X](https://x.com/mrlubos). Share your experiences with Hey API on Reddit, Slack, or in your own communities and group chats.
+
+- **Create a new issue**. If you can't find a solution, [open an issue](https://github.com/hey-api/openapi-ts/issues). The issue template will guide you through the process.
+
+- **Open a pull request**. If you find an issue you would like to fix, open a pull request. If you need help, tag [`@mrlubos`](https://github.com/mrlubos) on GitHub, provide enough relevant information, and we will do our best to assist you.
+
+These are some of the best ways not only to contribute to Hey API, but also to learn, connect with others, and share ideas.
+
+## Pull Requests
+
+Ready to write some code? We have dedicated guides to help you [build](/openapi-ts/community/contributing/building), [develop](/openapi-ts/community/contributing/developing), and [test](/openapi-ts/community/contributing/testing) your feature before it's released.
+
+We are excited to see what you’ll contribute!
diff --git a/docs/openapi-ts/community/contributing/building.md b/docs/openapi-ts/community/contributing/building.md
@@ -0,0 +1,23 @@
+---
+title: Building
+description: Learn how to contribute to Hey API.
+---
+
+# Building
+
+::: warning
+This page is under construction. We appreciate your patience.
+:::
+
+## Prerequisites
+
+You should have a working knowledge of [git](https://git-scm.com), [node](https://nodejs.org/en), and [pnpm](https://pnpm.io).
+
+## Guidelines
+
+Your [pull request](https://help.github.com/articles/using-pull-requests) must:
+
+- address a single issue or add a single item of functionality
+- contain a clean history of small, incremental, logically separate commits, with no merge commits
+- use clear commit messages
+- be possible to merge automatically
diff --git a/docs/openapi-ts/community/contributing/developing.md b/docs/openapi-ts/community/contributing/developing.md
@@ -0,0 +1,10 @@
+---
+title: Developing
+description: Learn how to contribute to Hey API.
+---
+
+# Developing
+
+::: warning
+This page is under construction. We appreciate your patience.
+:::
diff --git a/docs/openapi-ts/community/contributing/testing.md b/docs/openapi-ts/community/contributing/testing.md
@@ -0,0 +1,10 @@
+---
+title: Testing
+description: Learn how to contribute to Hey API.
+---
+
+# Testing
+
+::: warning
+This page is under construction. We appreciate your patience.
+:::
diff --git a/docs/openapi-ts/community/spotlight.md b/docs/openapi-ts/community/spotlight.md
@@ -1,6 +1,6 @@
 ---
 title: Spotlight
-description: Meet the people behind @hey-api/openapi-ts.
+description: Meet the people behind Hey API.
 ---
 
 <script setup lang="ts">
@@ -11,30 +11,67 @@ import { hallOfFame } from '../../data/hallOfFame.js'
 
 # Spotlight
 
-Meet the people behind `@hey-api/openapi-ts`.
+Meet the people behind Hey API. To join this list, please refer to the [contributing](/openapi-ts/community/contributing) guide.
 
 ## Core Team
 
-These people actively maintain this project.
+These people actively maintain Hey API.
 
-<VPTeamMembers size="small" :members="coreTeam" />
+<VPTeamMembers class="people" size="small" :members="coreTeam" />
 
 Do you want to join the core team? Send us a short [email](mailto:lubos@heyapi.dev?subject=Join%20Core%20Team) describing your interest in Hey API, any relevant experience, and what you're hoping to work on.
 
 ## Hall of Fame
 
 These are the people with significant contributions to Hey API. A special thank you goes to [Ferdi Koomen](https://madebyferdi.com) for allowing us to use the original source code from OpenAPI TypeScript Codegen. None of this would've been possible without you!
 
-<VPTeamMembers size="small" :members="hallOfFame" />
+<VPTeamMembers class="people" size="small" :members="hallOfFame" />
 
 ## Contributors
 
-A complete list of contributors to `@hey-api/openapi-ts`.
+The complete list of contributors to Hey API.
 
 <div class="contributors-list">
 
 <!--@include: ../../partials/contributors-list.md-->
 
 </div>
 
-Thank you for contributing to Hey API!
+A sincere thank you for your contributions.
+
+<style>
+.vp-doc .VPTeamMembers.people.small .container {
+  grid-template-columns: repeat(auto-fit, minmax(284px, 1fr)) !important;
+}
+
+@media (max-width: 640px) {
+  .vp-doc .VPTeamMembers.people.small .container {
+    max-width: 100% !important;
+  }
+}
+
+.VPTeamMembersItem.small {
+  max-width: 400px;
+}
+
+.VPTeamMembersItem.small .profile {
+  align-items: center;
+  display: flex;
+  padding: 1rem 1.4rem !important;
+}
+
+.VPTeamMembersItem.small .profile .avatar {
+  margin: 0 1rem 0 0;
+}
+
+.VPTeamMembersItem.small .profile .data {
+  padding: 0;
+  text-align: left;
+}
+
+.VPTeamMembersItem.small .profile .data .links {
+  justify-content: initial;
+  margin: 0 -8px -20px;
+  padding: 4px 0;
+}
+</style>
diff --git a/docs/openapi-ts/plugins/ajv.md b/docs/openapi-ts/plugins/ajv.md
@@ -5,9 +5,7 @@ description: Ajv plugin for Hey API. Compatible with all our features.
 
 # Ajv <span data-soon>soon</span>
 
-::: warning
-This feature isn't in development yet. Help us prioritize it by voting on [GitHub](https://github.com/hey-api/openapi-ts/issues/1476).
-:::
+<FeatureStatus issueNumber=1476 name="Ajv" />
 
 ### About
 

diff --git a/docs/openapi-ts/plugins/arktype.md b/docs/openapi-ts/plugins/arktype.md
@@ -5,9 +5,7 @@ description: Arktype plugin for Hey API. Compatible with all our features.
 
 # Arktype <span data-soon>soon</span>
 
-::: warning
-This feature isn't in development yet. Help us prioritize it by voting on [GitHub](https://github.com/hey-api/openapi-ts/issues/1473).
-:::
+<FeatureStatus issueNumber=1473 name="Arktype" />
 
 ### About
 

diff --git a/docs/openapi-ts/plugins/express.md b/docs/openapi-ts/plugins/express.md
@@ -5,9 +5,7 @@ description: Express plugin for Hey API. Compatible with all our features.
 
 # Express <span data-soon>soon</span>
 
-::: warning
-This feature isn't in development yet. Help us prioritize it by voting on [GitHub](https://github.com/hey-api/openapi-ts/issues/1484).
-:::
+<FeatureStatus issueNumber=1484 name="Express" />
 
 ### About
 

diff --git a/docs/openapi-ts/plugins/faker.md b/docs/openapi-ts/plugins/faker.md
@@ -5,9 +5,7 @@ description: Faker plugin for Hey API. Compatible with all our features.
 
 # Faker <span data-soon>soon</span>
 
-::: warning
-This feature isn't in development yet. Help us prioritize it by voting on [GitHub](https://github.com/hey-api/openapi-ts/issues/1485).
-:::
+<FeatureStatus issueNumber=1485 name="Faker" />
 
 ### About
 

diff --git a/docs/openapi-ts/plugins/hono.md b/docs/openapi-ts/plugins/hono.md
@@ -5,9 +5,7 @@ description: Hono plugin for Hey API. Compatible with all our features.
 
 # Hono <span data-soon>soon</span>
 
-::: warning
-This feature isn't in development yet. Help us prioritize it by voting on [GitHub](https://github.com/hey-api/openapi-ts/issues/1483).
-:::
+<FeatureStatus issueNumber=1483 name="Hono" />
 
 ### About
 

diff --git a/docs/openapi-ts/plugins/joi.md b/docs/openapi-ts/plugins/joi.md
@@ -5,9 +5,7 @@ description: Joi plugin for Hey API. Compatible with all our features.
 
 # Joi <span data-soon>soon</span>
 
-::: warning
-This feature isn't in development yet. Help us prioritize it by voting on [GitHub](https://github.com/hey-api/openapi-ts/issues/1477).
-:::
+<FeatureStatus issueNumber=1477 name="Joi" />
 
 ### About