# Orval

Generator that produces TypeScript API clients, models and optional mocks from OpenAPI v3 and Swagger v2 specifications.


Source: https://findsoftware.frbit.cloud/orval/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://orval.dev
- repository: https://github.com/orval-labs/orval
- docs: https://orval.dev/docs/installation/
- discord: https://discord.gg/6fC2sjDU7w

### Identity

- status: active
- maintainer: Victor Bury
- maintainerType: unknown
- parent: unknown
- firstRelease: 2020
- hqCountry: unknown

### Kind

- category: dev-tool
- hosting: not applicable
- language: javascript
- runtime: node
- runtimeMin: node 22
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: unknown
- renderingModes: not applicable
- installMethod: npm, docker

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 8
- latestReleaseDate: 2026-11-14

### Adoption

- githubStargazers: 6620
- packagistDownloads: not applicable
- npmWeeklyDownloads: 3640442
- contributors: 410
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 305
- dependentPackages: 39

### Sources

- urls: https://api.github.com/repos/orval-labs/orval (read 2026-11-16)
- urls: https://api.github.com/repos/orval-labs/orval (read 2026-11-16)
- urls: https://orval.dev/docs/installation/ (read 2026-11-16)
- maintainer: https://raw.githubusercontent.com/orval-labs/orval/master/LICENSE (read 2026-11-16)
- language: https://api.github.com/repos/orval-labs/orval (read 2026-11-16)
- category: https://raw.githubusercontent.com/orval-labs/orval/master/README.md (read 2026-11-16)
- runtime: https://orval.dev/docs/installation/ (read 2026-11-16)
- runtimeMin: https://raw.githubusercontent.com/orval-labs/orval/v8.48.0/packages/orval/package.json (read 2026-11-16)
- installMethod: https://orval.dev/docs/installation/ (read 2026-11-16)
- installMethod: https://orval.dev/docs/installation/ (read 2026-11-16)
- license: https://api.github.com/repos/orval-labs/orval (read 2026-11-16)
- licenseModel: https://raw.githubusercontent.com/orval-labs/orval/master/LICENSE (read 2026-11-16)
- currentMajor: https://api.github.com/repos/orval-labs/orval/releases/latest (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/orval-labs/orval/releases/latest (read 2026-11-16)
- firstRelease: https://registry.npmjs.org/orval (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/orval-labs/orval (read 2026-11-16)
- contributors: https://api.github.com/repos/orval-labs/orval/contributors?per_page=1 (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/orval (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/orval (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/orval (read 2026-11-16)

## Notes

Orval is a generator that reads an OpenAPI v3 or Swagger v2 specification, in YAML or JSON, and writes TypeScript code for it: API clients, models and optional mocks. The generated code targets several client libraries, such as React Query, SWR, Vue Query and Angular, and the tool is installed into a project with npm as a development dependency.

Projects that cannot install it locally can run code generation with the official Docker image, which the install guide names as an alternative route.

## Worth knowing

Current releases require a recent Node.js line, so a project that runs an older one needs the Docker image to generate its code.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
