Trigger.dev is an open source platform that makes it easy for developers to create event-driven background tasks directly in their code. Build, test and run workflows locally using our SDK. Subscribe to webhooks, schedule jobs, run background jobs and add long delays easily and reliably. In our web app you get full visibility of every run your workflow has ever made making it easier to monitor and debug.
- 👂 Easily subscribe to webhooks — they work locally without tunnelling.
- 🔥 Fire your own custom events—a single event can trigger multiple workflows.
- 📆 Schedule workflows—easily repeat tasks or use CRON syntax for advanced cases.
- 🚦 Add long delays inside workflows (up to a year) and they will pick up where they left off.
- 🤝 When your server goes down it’s not a problem, workflows will reconnect and continue.
- 🪧 View every step of every run, with data, previews and errors.
- 👋 Connect to and authenticate with APIs using our custom integrations.
- 🚗 If you have a custom use case, we support Fetch for calling any HTTP endpoint or webhooks for subscribing to events from APIs.
- 📡 All API calls are automatically retried with exponential back off.
- 😀 TypeScript SDK, so whether you’re using JavaScript or TypeScript you will have a great experience.
- Getting Started with Trigger.dev
- Example workflows
- Triggers:
- Functions:
- You create workflows in code on your server using our SDK
- Each API integration is a separate package, e.g.
@trigger.dev/slack
- Each workflow has an event that triggers it, e.g.
github.events.newStarEvent
,scheduleEvent
,customEvent
- Each workflow has a
run
function that is called when the event is triggered - If we don't have an integration for the API you want to use, you can use
fetch
to call any HTTP endpoint andwebhookEvent
to subscribe to webhooks
Post to Slack when a GitHub issue is created or modified
Integrations required: Slack, GitHub
import { Trigger } from "@trigger.dev/sdk";
import * as github from "@trigger.dev/github";
import * as slack from "@trigger.dev/slack";
new Trigger({
id: "new-github-star-to-slack",
name: "New GitHub Star: triggerdotdev/trigger.dev",
apiKey: "<my_api_key>",
on: github.events.newStarEvent({
repo: "triggerdotdev/trigger.dev",
}),
run: async (event) => {
await slack.postMessage("github-stars", {
channelName: "github-stars",
text: `New GitHub star from \n<${event.sender.html_url}|${event.sender.login}>`,
});
},
}).listen();
Welcome email drip campaign
Integrations required: Slack, Resend
import { customEvent, Trigger, sendEvent } from "@trigger.dev/sdk";
import * as resend from "@trigger.dev/resend";
import * as slack from "@trigger.dev/slack";
import React from "react";
import { z } from "zod";
import { getUser } from "../db";
import { InactiveEmail, TipsEmail, WelcomeEmail } from "./email-templates";
new Trigger({
id: "welcome-email-campaign",
name: "Welcome email drip campaign",
apiKey: "<my_api_key>",
on: customEvent({
name: "user.created",
schema: z.object({
userId: z.string(),
}),
}),
async run(event, context) {
//get the user data from the database
const user = await getUser(event.userId);
await slack.postMessage("send-to-slack", {
channelName: "new-users",
text: `New user signed up: ${user.name} (${user.email})`,
});
//Send the first email
const welcomeResponse = await resend.sendEmail("welcome-email", {
from: "Trigger.dev <[email protected]>",
replyTo: "James <[email protected]>",
to: user.email,
subject: "Welcome to Trigger.dev",
react: <WelcomeEmail name={user.name} />,
});
await context.logger.debug(
`Sent welcome email to ${welcomeResponse.to} with id ${welcomeResponse.id}`
);
//wait 1 day, check if the user has created a workflow and send the appropriate email
await context.waitFor("wait-a-while", { days: 1 });
const updatedUser = await getUser(event.userId);
if (updatedUser.hasOnboarded) {
await resend.sendEmail("onboarding-complete", {
from: "Trigger.dev <[email protected]>",
replyTo: "James <[email protected]>",
to: updatedUser.email,
subject: "Pro tips for workflows",
react: <TipsEmail name={updatedUser.name} />,
});
} else {
await resend.sendEmail("onboarding-incomplete", {
from: "Trigger.dev <[email protected]>",
replyTo: "James <[email protected]>",
to: updatedUser.email,
subject: "Help with your first workflow",
react: <InactiveEmail name={updatedUser.name} />,
});
}
},
}).listen();
One of the most powerful features of Trigger.dev is the runs page. All of the steps in a workflow, including the initial event, can be viewed in detail. See the status / output of each step, the logs, rich previews, errors and much more.
To run Trigger.dev locally, follow these steps.
We are open source and love contributions!
- Request a feature in our Discord community
- Open a PR
Please subscribe to the GitHub issue to be notified when it's live.
- Join our Discord community
- If you have any other questions, get in touch at [email protected]