/* Tooltip style on the code block */
div[class="absolute top-11 left-1/2 transform -translate-x-1/2 -translate-y-1/2 hidden group-hover:block text-white rounded-lg px-1.5 py-0.5 text-xs bg-primary-dark"] {
  color:#1A1B1F;
  border-radius: 0.25rem;
}

/* Link anchor active state - icon container */
div[class="mr-4 rounded-md p-1"] {
  border-radius: 0.25rem;
  border: 1px solid #464748;
}

/* Link anchor default state - icon container */
div[class="mr-4 rounded-md p-1 zinc-box group-hover:brightness-100 group-hover:ring-0 ring-1 ring-gray-950/5 dark:ring-gray-700/40"] {
  border-radius: 0.25rem;
  border: 1px solid transparent;
}

Writing tasks

Our library of examples, guides and projects

Tasks are the core of Trigger.dev. They are long-running processes that are triggered by events.

Overview

Writing tasks: Overview

Trigger.dev

Welcome to the Trigger.dev v3 documentation.

Introduction

How to get started in 3 minutes using the CLI and SDK.

Quick start

Go from zero to a working task in your Next.js app in 10 minutes.

Video walkthrough

Understand how Trigger.dev works and how it can help you.

How it works

There are some hard and soft limits that you might hit.

Limits

Tasks need to be triggered in order to run.

Triggering

Understanding the lifecycle of task run execution in Trigger.dev

Runs

How to authenticate with Trigger.dev so you can trigger tasks.

API keys

The `trigger.dev dev` command is used to run your tasks locally.

CLI dev command

You can use the dashboard to run a test of your tasks.

Run tests

The `trigger.dev deploy` command can be used to deploy your tasks to our infrastructure.

CLI deploy command

Any environment variables used in your tasks need to be added so the deployed code will run successfully.

Environment Variables

You can easily deploy your tasks with GitHub actions.

GitHub Actions

How to use the built-in logging and tracing system.

Logging and tracing

How to deal with errors and write reliable tasks.

Errors & Retrying

Configure what you want to happen when there is more than one run at a time.

Concurrency & Queues

We use atomic versioning to ensure that started tasks are not affected by changes to the task code.

Versioning

Configure the number of vCPUs and GBs of RAM you want the task to use.

Machines

An API call or operation is “idempotent” if it has the same result when called more than once.

Idempotency

A replay is a copy of a run with the same payload but against the latest version in that environment. This is useful if something went wrong and you want to try again with the latest version of your code.

Replaying

Set a maximum duration for a task to run.

Max duration

Tags allow you to easily filter runs in the dashboard and when using the SDK.

Metadata

Run metadata

Get compute duration and cost from inside a run, or for a specific block of code.

Usage

Context

Perform actions like replay and cancel on multiple runs at once.

Bulk actions

Ready-to-use examples to help you get started with Trigger.dev.

Guides & examples

Using the Trigger.dev SDK from your frontend application.

Overview & Auth

Overview & Authentication

Realtime overview

Stream data in realtime from inside your tasks

Streams

Realtime streams

Subscribes to all changes to a run in a React component.

React hooks

Realtime React hooks

subscribeToRun

runs.subscribeToRun

Subscribes to all changes to runs with a specific tag.

subscribeToRunsWithTag

runs.subscribeToRunsWithTag

Subscribes to all changes for runs in a batch.

subscribeToBatch

runs.subscribeToBatch

The Trigger.dev CLI has a number of options and commands to help you develop locally, self host, and deploy your tasks.

You can self-host Trigger.dev on your own infrastructure.

Self-hosting

You can contribute to Trigger.dev in many ways.

Contributing

GitHub repo

Changelog

Roadmap

Some common problems you might experience and their solutions

Common problems

When we release fixes and new features we recommend you upgrade your Trigger.dev packages.

Upgrading packages

How to upgrade the Trigger.dev packages

Beta upgrade

Upgrade to new build system

Get alerted when runs or deployments fail, or when deployments succeed.

Alerts

Uptime Status

GitHub Issues

Request a feature

Discord Community

Slack support

Email us

An ever growing list of guides and examples to help you get setup with Trigger.dev.

Frameworks, guides and examples overview

This guide will show you how to setup Trigger.dev with Bun

Bun guide

This guide will show you how to setup Trigger.dev in your existing Next.js project, test an example task, and view the run.

Next.js

Next.js setup guide

This guide will show you how to setup Trigger.dev in your existing Node.js project, test an example task, and view the run.

Node.js

Node.js setup guide

This guide will show you how to setup Trigger.dev in your existing Remix project, test an example task, and view the run.

Remix

Remix setup guide

This guide will show you how to set up Prisma with Trigger.dev

Prisma setup guide

This guide will show you how to set up Drizzle ORM with Trigger.dev

Drizzle setup guide

This guide will show you how to trigger tasks from database changes using Sequin

Sequin database triggers

This example Next.js project generates an image from a prompt using Fal.ai and shows the progress of the task on the frontend using Trigger.dev Realtime.

Realtime image gen with Fal.ai

Image generation with Fal.ai and Trigger.dev Realtime

This example Next.js project evaluates multiple LLM models using the Vercel AI SDK and streams updates to the frontend using Trigger.dev Realtime.

Batch LLM Evaluator

Next.js Batch LLM Evaluator

This example Next.js project demonstrates how to use Trigger.dev Realtime to build a CSV Uploader with progress updates streamed to the frontend.

Realtime CSV Importer

Next.js Realtime CSV Importer

This example Next.js project uses the Vercel AI SDK to generate images from a prompt.

Vercel AI SDK image generator

This example will show you how to generate an image using DALL·E 3 and text using GPT-4o with Trigger.dev.

DALL·E image generation

Generate an image using DALL·E 3

This example will show you how to transcribe audio using Deepgram's speech recognition API with Trigger.dev.

Deepgram audio transcription

Transcribe audio using Deepgram

This example task generates an image from a URL using Fal.ai and uploads it to Cloudflare R2.

Fal.ai image to cartoon

Convert an image to a cartoon using Fal.ai

This example task generates an image from a prompt using Fal.ai and shows the progress of the task on the frontend using Trigger.dev Realtime.

Fal.ai with Realtime

Generate an image from a prompt using Fal.ai and Trigger.dev Realtime

These examples show you how to process videos in various ways using FFmpeg with Trigger.dev.

FFmpeg video processing

Video processing with FFmpeg

This example demonstrates how to crawl a URL using Firecrawl with Trigger.dev.

Firecrawl URL crawl

Crawl a URL using Firecrawl

This example demonstrates how to convert documents to PDF using LibreOffice with Trigger.dev.

LibreOffice PDF conversion

Convert documents to PDF using LibreOffice

This example will show you how to call OpenAI with retrying using Trigger.dev.

OpenAI with retrying

Call OpenAI with retrying

This example will show you how to turn a PDF into an image using MuPDF and Trigger.dev.

PDF to image

Turn a PDF into an image using MuPDF

These examples demonstrate how to use Puppeteer with Trigger.dev.

Puppeteer

This example demonstrates how to scrape the top 3 articles from Hacker News using BrowserBase and Puppeteer, summarize them with ChatGPT and send a nicely formatted email summary to yourself every weekday using Resend.

Browserbase & Puppeteer

Scrape the top 3 articles from Hacker News and email yourself a summary every weekday

This example demonstrates how to track errors with Sentry using Trigger.dev.

Sentry error tracking

Track errors with Sentry

This example demonstrates how to process images using the Sharp library with Trigger.dev.

Sharp image processing

Process images using Sharp

These examples demonstrate how to run basic CRUD operations on a table in a Supabase database using Trigger.dev.

Supabase database operations

Supabase database operations using Trigger.dev

This example demonstrates how to upload files to Supabase Storage using Trigger.dev.

Supabase Storage upload

Uploading files to Supabase Storage

This example will show you how to generate a PDF using Trigger.dev.

React to PDF

Generate a PDF using react-pdf and save it to R2

This example will show you how to send a sequence of emails over several days using Resend with Trigger.dev.

Resend email sequence

Send a sequence of emails using Resend

This example demonstrates how to use the Vercel AI SDK with Trigger.dev.

Vercel AI SDK

Using the Vercel AI SDK

This example demonstrates how to sync environment variables from your Vercel project to Trigger.dev.

Vercel sync env vars

Syncing environment variables from your Vercel projects

This guide will show you how to create a new Trigger.dev project.

Creating a project

How to upgrade v2 jobs to v3 tasks, and how to use them together.

Upgrading from v2

Switch to v2 docs

Discord

Tasks are functions that can run for a long time and provide strong resilience to failure.

Tasks: Overview

Define tasks with a runtime payload schema and validate the payload before running the task.

Schema task

schemaTask

A task that is triggered on a recurring schedule using cron syntax.

Getting Started

Fundamentals

Development

Deployment

Writing tasks

Frontend usage

Realtime API

API reference

CLI

Open source

Troubleshooting

Help

Writing tasks: Overview

Writing tasks

Our library of examples, guides and projects

Walkthrough guides

Example tasks

Webhook guides

Example projects

Topic	Description
Logging	View and send logs and traces from your tasks.
Errors & retrying	How to deal with errors and write reliable tasks.
Wait	Wait for periods of time or for external events to occur before continuing.
Concurrency & Queues	Configure what you want to happen when there is more than one run at a time.
Realtime notifications	Send realtime notifications from your task that you can subscribe to from your backend or frontend.
Versioning	How versioning works.
Machines	Configure the CPU and RAM of the machine your task runs on
Idempotency	Protect against mutations happening twice.
Replaying	You can replay a single task or many at once with a new version of your code.
Max duration	Set a maximum duration for your task to run.
Tags	Tags allow you to easily filter runs in the dashboard and when using the SDK.
Metadata	Attach a small amount of data to a run and update it as the run progresses.
Usage	Get compute duration and cost from inside a run, or for a specific block of code.
Context	Access the context of the task run.
Bulk actions	Run actions on many task runs at once.

Getting Started

Fundamentals

Development

Deployment

Writing tasks

Frontend usage

Realtime API

API reference

CLI

Open source

Troubleshooting

Help

​Writing tasks

​Our library of examples, guides and projects

Walkthrough guides

Example tasks

Webhook guides

Example projects

Writing tasks

Our library of examples, guides and projects