https://github.com/orval-labs/orval

orval is able to generate client with appropriate type-signatures (TypeScript) from any valid OpenAPI v3 or Swagger v2 specification, either in yaml or json formats. 🍺
https://github.com/orval-labs/orval

angular axios-client codegen faker mock msw openapi-specification orval react react-query swagger typescript

Last synced: 6 months ago
JSON representation

orval is able to generate client with appropriate type-signatures (TypeScript) from any valid OpenAPI v3 or Swagger v2 specification, either in yaml or json formats. 🍺

• Host: GitHub
• URL: https://github.com/orval-labs/orval
• Owner: orval-labs
• License: mit
• Created: 2020-02-05T08:31:50.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2025-05-02T13:24:48.000Z (6 months ago)
• Last Synced: 2025-05-06T20:19:39.877Z (6 months ago)
• Topics: angular, axios-client, codegen, faker, mock, msw, openapi-specification, orval, react, react-query, swagger, typescript
• Language: TypeScript
• Homepage: https://orval.dev
• Size: 13.7 MB
• Stars: 3,923
• Watchers: 12
• Forks: 397
• Open Issues: 145
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• toolsdk-mcp-registry - ❌ @orval/mcp - signatures (TypeScript) from any valid OpenAPI v3 or Swagger v2 specification, either in yaml or json formats.Generate, valid, cache and mock in your React, Vue, Svelte and Angular applications all with your OpenAPI specification. (node) (Developer Tools / How to Submit)
• fucking-awesome-angular - orval - Generate, validate, cache and mock in your frontend applications, based on your OpenAPI specification. (Development Utilities / Generators and Scaffolding)
• awesome-angular - orval - Generate, validate, cache and mock in your frontend applications, based on your OpenAPI specification. (Development Utilities / Generators and Scaffolding)

README

          
[![npm version](https://badge.fury.io/js/orval.svg)](https://badge.fury.io/js/orval)

![NPM Downloads](https://img.shields.io/npm/dm/orval?color=purple)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![tests](https://github.com/orval-labs/orval/actions/workflows/tests.yaml/badge.svg)](https://github.com/orval-labs/orval/actions/workflows/tests.yaml)

[![orval](https://snyk.io/advisor/npm-package/orval/badge.svg)](https://snyk.io/advisor/npm-package/orval)

[![Gurubase](https://img.shields.io/badge/Gurubase-Ask%20Orval%20Guru-006BFF)](https://gurubase.io/g/orval)



  





  Visit orval.dev for docs, guides, API and beer!



⚠️ Actively searching for contributors, if you want to help, please contact me on [discord](https://discord.gg/6fC2sjDU7w) ⚠️

### Code Generation

`orval` is able to generate client with appropriate type-signatures (TypeScript) from any valid OpenAPI v3 or Swagger v2 specification, either in `yaml` or `json` formats.

### Supported clients

`generate` models, requests, hooks, [mocks](https://mswjs.io/) and more, for these supported clients:

- [React](https://react.dev/)

- [React Query](https://tanstack.com/query/latest/docs/framework/react/overview)

- [React with swr](https://swr.vercel.app/)

- [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview)

- [Svelte Query](https://tanstack.com/query/latest/docs/framework/svelte/overview)

- [Angular](https://angular.dev/)

- [Hono](https://hono.dev/)

- [zod](https://zod.dev/)

- [native fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API)

- [mcp](https://modelcontextprotocol.io/introduction)

### Samples

You can find some samples below:

- [react app](https://github.com/orval-labs/orval/tree/master/samples/react-app)

- [react query](https://github.com/orval-labs/orval/tree/master/samples/react-query)

- [svelte query](https://github.com/orval-labs/orval/tree/master/samples/svelte-query)

- [vue query](https://github.com/orval-labs/orval/tree/master/samples/vue-query)

- [react app with swr](https://github.com/orval-labs/orval/tree/master/samples/react-app-with-swr)

- [angular app](https://github.com/orval-labs/orval/tree/master/samples/angular-app)

- [hono](https://github.com/orval-labs/orval/tree/master/samples/hono)

- [next app with fetch](https://github.com/orval-labs/orval/tree/master/samples/next-app-with-fetch)

- [mcp server](https://github.com/orval-labs/orval/tree/master/samples/mcp)

### Playground

Try Orval out for yourself using our [Playground](https://orval.dev/playground) application!

## Star History



  

    

    

    

  



### All Thanks To Our Contributors: