Setting Up Trigger.dev Integration

This guide walks you through setting up the Trigger.dev integration in your zopio application.

Prerequisites

Before you begin, make sure you have:

  1. A Trigger.dev account (sign up at trigger.dev)
  2. Access to your zopio application codebase

Installation

The @repo/trigger package is already included in the zopio monorepo. If you’re working with a new package that needs to use Trigger.dev, add it as a dependency:

pnpm add @repo/trigger

Environment Variables

Add the following environment variables to your .env file:

TRIGGER_API_KEY=your_trigger_dev_api_key
TRIGGER_API_URL=https://api.trigger.dev  # Optional, this is the default

You can find your API key in the Trigger.dev dashboard under Project Settings.

Verifying Installation

To verify that the Trigger.dev integration is working correctly:

  1. Make sure your application is running
  2. Send a test event using the API endpoint
  3. Check the Trigger.dev dashboard to see if the event was received

Example test request:

curl -X POST http://localhost:3002/trigger \
  -H "Content-Type: application/json" \
  -d '{"event": "test.event", "payload": {"message": "Hello from Trigger.dev"}}'

Webhook Configuration

For production environments, you’ll need to configure the Trigger.dev webhook to point to your API endpoint:

  1. Go to the Trigger.dev dashboard
  2. Navigate to Project Settings > Webhooks
  3. Add a new webhook with the URL: https://your-domain.com/trigger

Troubleshooting

If you encounter issues with the setup:

  • Verify that your API key is correct
  • Check that the API endpoint is accessible
  • Review the server logs for any error messages
  • Ensure that the Trigger.dev client is properly initialized

For more detailed troubleshooting, see the Trigger.dev documentation.