OrvalOrval

Configuration

Overview of Orval configuration options

Configure Orval using an orval.config.(js|mjs|ts) file at the root of your project.

Configuration Categories

CategoryDescription
InputPath to the specification, or a configuration object for transforming the specification before generation
OutputOutput path and configuration for what is generated and how
HooksScripts to run on certain events

Basic Example

orval.config.ts
import { defineConfig } from 'orval';

export default defineConfig({
  petstore: {
    input: './petstore.yaml',
    output: './petstore.ts',
    hooks: {
      afterAllFilesWrite: 'prettier --write',
    },
  },
});

Multiple Specifications

orval.config.ts
import { defineConfig } from 'orval';

export default defineConfig({
  petstore: {
    input: './petstore.yaml',
    output: './src/api/petstore.ts',
  },
  users: {
    input: './users.yaml',
    output: './src/api/users.ts',
  },
});

On this page