Documentation
Config Reference
Lifecycle Hooks

Lifecycle Hooks

The codegen allows specifying scripts it can run for you in certain events.

You can specify hooks on the root level or specify hooks on the output level (only some of them).

Each hook has its arguments, and it passes them to your scripts using argv.

How to use?

Add your scripts to your codegen.ts file, and specify the scripts you wish to run, for example:

import { CodegenConfig } from '@graphql-codegen/cli'
 
const config: CodegenConfig = {
  schema: 'http://localhost:4000/graphql',
  documents: ['src/**/*.tsx'],
  generates: {
    './src/gql/': {
      preset: 'client'
    }
  },
  hooks: {
    afterOneFileWrite: ['prettier --write']
  }
}
 
export default config

Or, for specific output:

import { CodegenConfig } from '@graphql-codegen/cli'
 
const config: CodegenConfig = {
  schema: 'http://localhost:4000/graphql',
  documents: ['src/**/*.tsx'],
  generates: {
    './src/gql/': {
      preset: 'client',
      hooks: {
        afterOneFileWrite: ['prettier --write']
      }
    }
  }
}
 
export default config

Root Level

The following lifecycle hooks are supported on the root level:

afterStart

Triggered with no arguments when the codegen starts (after the codegen.ts has been loaded).

onWatchTriggered

Triggered every time a file changes when using watch mode. Triggered with two arguments: the type of the event (for example, changed) and the file’s path.

onError

Triggered in case of a general error in the codegen. The argument is a string containing the error.

beforeAllFileWrite

Executed after the codegen has created the output and before writing the files to the file system.

Triggered with multiple arguments - paths for all relevant files.

💡

Not all the files will be written to the file system, because this is triggered before checking if the file has changed since last execution.

beforeOneFileWrite

Triggered before a file is written to the file system. Executed with the path for the file.

If the content of the file hasn’t changed since the last execution - this hook won’t be triggered.

afterOneFileWrite

Triggered after a file is written to the file system. Executed with the path for the file. If the content of the file hasn’t changed since the last execution - this hook won’t be triggered.

💡
This is a very useful hook, you can use it for integration with Prettier or other linters.

afterAllFileWrite

Executed after writing all the files to the file system. Triggered with multiple arguments - paths for all files.

beforeDone

Triggered with no arguments, right before the codegen closes or when watch mode is stopped.

Output Level

The following hooks are available for a single output file: beforeOneFileWrite and afterOneFileWrite.

Output level hooks are triggered before root level hooks.

Naming ConventionMulti Project