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: about 6 hours 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 (over 5 years ago)
• Default Branch: master
• Last Pushed: 2025-05-02T13:24:48.000Z (12 days ago)
• Last Synced: 2025-05-06T20:19:39.877Z (7 days 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

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: