Configuration de Trigger.dev

Lancez Trigger.dev dans votre projet en quelques minutes.

Quand l'utiliser

Ajouter Trigger.dev à un projet existant
Créer votre première task
Configurer trigger.config.ts
Se connecter au cloud Trigger.dev

Prérequis

Node.js 18+ ou Bun
Un compte Trigger.dev (https://cloud.trigger.dev)

Démarrage rapide

1. Installer le SDK

npm install @trigger.dev/sdk

2. Initialiser votre projet

npx trigger init

Cela crée :

trigger.config.ts - configuration du projet
trigger/ directory - où vivent vos tasks
trigger/example.ts - une task d'exemple

3. Configurer trigger.config.ts

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

export default defineConfig({
  project: "proj_xxxxx", // From dashboard
  dirs: ["./trigger"],
});

4. Créer votre première task

// trigger/my-task.ts
import { task } from "@trigger.dev/sdk";

export const myFirstTask = task({
  id: "my-first-task",
  run: async (payload: { name: string }) => {
    console.log(`Hello, ${payload.name}!`);
    return { message: `Processed ${payload.name}` };
  },
});

5. Lancer le serveur de développement

npx trigger dev

6. Déclencher votre task

À partir de votre code d'application :

import { tasks } from "@trigger.dev/sdk";
import type { myFirstTask } from "./trigger/my-task";

await tasks.trigger<typeof myFirstTask>("my-first-task", {
  name: "World",
});

Ou depuis l'onglet « Test » du dashboard Trigger.dev.

Structure du projet

your-project/
├── trigger.config.ts    # Required - project config
├── trigger/             # Required - task files
│   ├── my-task.ts
│   └── another-task.ts
├── package.json
└── ...

Variables d'environnement

Créez .env ou définissez dans votre environnement :

TRIGGER_SECRET_KEY=tr_dev_xxxxx  # From dashboard > API Keys

Problèmes courants

« No tasks found »

Assurez-vous que les tasks sont exportées depuis les fichiers dans les dossiers dirs
Vérifiez que trigger.config.ts pointe vers les bons répertoires

« Project not found »

Vérifiez que project dans la config correspond au dashboard
Contrôlez que TRIGGER_SECRET_KEY est défini

« Task not registered »

Redémarrez npx trigger dev après avoir ajouté des tasks
Les tasks doivent utiliser task() ou schemaTask() de @trigger.dev/sdk

Étapes suivantes

Ajouter une logique de retry → voir la skill trigger-tasks
Configurer les extensions de build → voir la skill trigger-config
Construire des workflows IA → voir la skill trigger-agents
Ajouter une UI temps réel → voir la skill trigger-realtime

trigger-setup