Output

You must set the output so we know where to generate your files.

Output

Output can be a path to the destination folder or an object containing the destination folder path and optional settings.

path

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: 'src/client', 
};

object

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: { 
    path: 'src/client', 
    // ...other options
  }, 
};

Format

To format your output folder contents, set output.format to a valid formatter.

disabled

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    format: false, 
    path: 'src/client',
  },
};

prettier

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    format: 'prettier', 
    path: 'src/client',
  },
};

biome

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    format: 'biome', 
    path: 'src/client',
  },
};

You can also prevent your output from being formatted by adding your output path to the formatter's ignore file.

Lint

To lint your output folder contents, set output.lint to a valid linter.

disabled

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    lint: false, 
    path: 'src/client',
  },
};

eslint

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    lint: 'eslint', 
    path: 'src/client',
  },
};

biome

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    lint: 'biome', 
    path: 'src/client',
  },
};

oxlint

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    lint: 'oxlint', 
    path: 'src/client',
  },
};

You can also prevent your output from being linted by adding your output path to the linter's ignore file.

TSConfig Path

We use the TSConfig file to generate output matching your project's settings. By default, we attempt to find a TSConfig file starting from the location of the @hey-api/openapi-ts configuration file and traversing up. If your file is located in a different place or you want to disable this setting, set output.tsConfigPath to a string.

custom

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    path: 'src/client',
    tsConfigPath: './config/tsconfig.custom.json', 
  },
};

off

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    path: 'src/client',
    tsConfigPath: 'off', 
  },
};

Custom Files

By default, you can't keep custom files in the output.path folder because it's emptied on every run. If you're sure you need to disable this behavior, set output.clean to false.

export default {
  input: 'hey-api/backend', // sign up at app.heyapi.dev
  output: {
    clean: false, 
    path: 'src/client',
  },
};

WARNING

Setting output.clean to false may result in broken output. Ensure you typecheck your code.

Examples

You can view live examples on StackBlitz.

Sponsors

Help Hey API stay around for the long haul by becoming a sponsor.

Gold

• 

  Best-in-class SDKs and MCP for your API.

  stainless.com

Silver

• scalar.com
• fastapi.tiangolo.com

Bronze

•