Build extensions

Customize how your project is built and deployed to Trigger.dev with build extensions

Build extensions allow you to hook into the build system and customize the build process or the resulting bundle and container image (in the case of deploying).

You can use pre-built extensions by installing the @trigger.dev/build package into your devDependencies, or you can create your own.

Build extensions are added to your trigger.config.ts file under the build.extensions property:

import { defineConfig } from "@trigger.dev/sdk/v3";

export default defineConfig({
  project: "my-project",
  build: {
    extensions: [
      {
        name: "my-extension",
        onBuildStart: async (context) => {
          console.log("Build starting!");
        },
      },
    ],
  },
});

If you are using a pre-built extension, you can import it from the @trigger.dev/build package:

import { defineConfig } from "@trigger.dev/sdk/v3";
import { ffmpeg } from "@trigger.dev/build/extensions/core";

export default defineConfig({
  project: "my-project",
  build: {
    extensions: [ffmpeg()],
  },
});

Built-in extensions

Trigger.dev provides a set of built-in extensions that you can use to customize how your project is built and deployed. These extensions are available out of the box and can be configured in your trigger.config.ts file.

Extension	Description
prismaExtension	Using prisma in your Trigger.dev tasks
pythonExtension	Execute Python scripts in your project
puppeteer	Use Puppeteer in your Trigger.dev tasks
ffmpeg	Use FFmpeg in your Trigger.dev tasks
aptGet	Install system packages in your build image
additionalFiles	Copy additional files to your build image
additionalPackages	Install additional npm packages in your build image
syncEnvVars	Automatically sync environment variables from external services to Trigger.dev
syncVercelEnvVars	Automatically sync environment variables from Vercel to Trigger.dev
esbuildPlugin	Add existing or custom esbuild extensions to customize your build process
emitDecoratorMetadata	Enable emitDecoratorMetadata in your TypeScript build
audioWaveform	Add Audio Waveform to your build image

Custom extensions

If one of the built-in extensions doesn’t meet your needs, you can create your own custom extension. See our guide on creating custom build extensions for more information.