# @nahkies/openapi-code-generator

> Typescript client SDK and server stub generator for OpenAPI 3 specifications

Latest version **0.26.0** (published 2026-06-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nahkies/openapi-code-generator
pnpm add @nahkies/openapi-code-generator
yarn add @nahkies/openapi-code-generator
bun add @nahkies/openapi-code-generator
```

Provides the command `openapi-code-generator`.

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.26.0 |
| Published | 2026-06-13 |
| First published | 2023-09-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22 |
| Dependencies | 14 |
| Unpacked size | 5.8 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 34 |
| Author | Michael Nahkies |
| Maintainers | mnahkies |
| Keywords | openapi, openapi3, typespec, swagger, typescript, zod, api, sdk, generator, codegen, koa, express, fetch, axios, angular |

## Links

- npm: https://www.npmjs.com/package/@nahkies/openapi-code-generator
- Repository: https://github.com/mnahkies/openapi-code-generator
- Homepage: https://openapi-code-generator.nahkies.co.nz/
- Issues: https://github.com/mnahkies/openapi-code-generator/issues
- npm.io page: https://npm.io/package/@nahkies/openapi-code-generator

## Dependencies (14)

- [ajv](https://npm.io/package/ajv.md) ^8.20.0
- [zod](https://npm.io/package/zod.md) ^4.3.6
- [json5](https://npm.io/package/json5.md) ^2.2.3
- [tslib](https://npm.io/package/tslib.md) ^2.8.1
- [lodash](https://npm.io/package/lodash.md) ^4.18.1
- [js-yaml](https://npm.io/package/js-yaml.md) ^4.1.1
- [commander](https://npm.io/package/commander.md) ^14.0.3
- [typescript](https://npm.io/package/typescript.md) ^6.0.3
- [ajv-formats](https://npm.io/package/ajv-formats.md) ^3.0.1
- [ajv-draft-04](https://npm.io/package/ajv-draft-04.md) ^1.0.0
- [@biomejs/biome](https://npm.io/package/@biomejs/biome.md) 2.4.15
- [@biomejs/js-api](https://npm.io/package/@biomejs/js-api.md) 4.0.0
- [@biomejs/wasm-nodejs](https://npm.io/package/@biomejs/wasm-nodejs.md) 2.4.15
- [@commander-js/extra-typings](https://npm.io/package/@commander-js/extra-typings.md) ^14.0.0

## Alternatives

- [launchdarkly-js-client-sdk](https://npm.io/package/launchdarkly-js-client-sdk.md) — 2.5M weekly downloads
- [@elastic/elasticsearch](https://npm.io/package/@elastic/elasticsearch.md) — 2.1M weekly downloads
- [@c8y/client](https://npm.io/package/@c8y/client.md) — 15.3K weekly downloads
- [@signaldb/maverickjs](https://npm.io/package/@signaldb/maverickjs.md) — 1.7K weekly downloads
- [@bbc/http-transport-cache](https://npm.io/package/@bbc/http-transport-cache.md) — 1.2K weekly downloads

## Recent versions

- 0.26.0 (latest) — 2026-06-13
- 0.22.0-alpha.0 (alpha) — 2025-10-26
- 0.3.1-mn-feat-responder-pattern.7 (mn-feat-responder-pattern) — 2023-12-02
- 0.2.1-mn-feat-typescript-axios-response-validation.8 (mn-feat-typescript-axios-response-validation) — 2023-11-30
- 0.1.2-mn-chore-use-branch-dist-tag.2 (mn-chore-use-branch-dist-tag) — 2023-11-11
- 0.25.0 — 2026-05-31
- 0.24.0 — 2026-05-27
- 0.23.0 — 2026-05-09
- 0.22.0 — 2025-11-02
- 0.21.1 — 2025-08-13
- 0.21.0 — 2025-07-26
- 0.20.1 — 2025-05-31
- 0.20.0 — 2025-05-05
- 0.19.2 — 2025-04-19
- 0.19.1 — 2025-04-18
- … 30 more at https://npm.io/package/@nahkies/openapi-code-generator/versions

## README

# @nahkies/openapi-code-generator

[![CI/CD](https://github.com/mnahkies/openapi-code-generator/actions/workflows/ci.yml/badge.svg)](https://github.com/mnahkies/openapi-code-generator/actions?query=branch%3Amain+event%3Apush)
[![npm](https://img.shields.io/npm/dm/%40nahkies%2Fopenapi-code-generator.svg)](https://www.npmjs.com/package/@nahkies/openapi-code-generator)

`@nahkies/openapi-code-generator` is a CLI tool that aims to generate high quality typescript client SDK's,
and API server scaffolding (routing, validation, serialization) from OpenAPI 3 specifications.

Currently, [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.4.html), [OpenAPI 3.1.x](https://spec.openapis.org/oas/v3.1.1.html),
and [TypeSpec](https://typespec.io/) are supported as input specifications.

<!-- toc -->

* [Documentation](#documentation)
* [Changelog](#changelog)
* [Stability](#stability)
* [More information / contributing](#more-information--contributing)

<!-- tocstop -->

## Documentation

Visit https://openapi-code-generator.nahkies.co.nz/ for detailed documentation including
quick start guides and reference material.

## Changelog

Please see the [Github releases](https://github.com/mnahkies/openapi-code-generator/releases)
for handwritten release notes, or [CHANGELOG.md](https://github.com/mnahkies/openapi-code-generator/blob/main/CHANGELOG.md) for release notes generated by lerna.

## Stability

This project is still in beta, and breaking changes are still likely to be made before moving to v1.
However, these are considered thoughtfully and we aim to minimise disruption.

In general, what is implemented works well, but there are still parts of the OpenAPI specification that
haven't been implemented, so YMMV.

## More information / contributing

Refer to top level [README.md](../../README.md) / [CONTRIBUTING.md](../../CONTRIBUTING.md)

---
_Source: https://npm.io/package/@nahkies/openapi-code-generator · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
