Triggering tasks from Supabase edge functions

You can create a new project by running the following command in your terminal using the Supabase CLI:

supabase init

If your project does not already have package.json file (e.g. if you are using Deno), create it manually in your project’s root folder.

This is required for the Trigger.dev SDK to work correctly.

{
  "devDependencies": {
    "typescript": "^5.6.2"
  }
}

The easiest way to get started is to use the CLI. It will add Trigger.dev to your existing project, create a /trigger folder and give you an example task.

Run this command in the root of your project to get started:

It will do a few things:

1. Log you into the CLI if you’re not already logged in.
2. Create a trigger.config.ts file in the root of your project.
3. Ask where you’d like to create the /trigger directory.
4. Create the /trigger directory with an example task, /trigger/example.[ts/js].

Install the “Hello World” example task when prompted. We’ll use this task to test the setup.

The CLI dev command runs a server for your tasks. It watches for changes in your /trigger directory and communicates with the Trigger.dev platform to register your tasks, perform runs, and send data back and forth.

It can also update your @trigger.dev/* packages to prevent version mismatches and failed deploys. You will always be prompted first.

The CLI dev command spits out various useful URLs. Right now we want to visit the Test page

You should see our Example task in the list

Press the “Run test” button

Congratulations, you should see the run page which will live reload showing you the current state of the run.

If you go back to your terminal you’ll see that the dev command also shows the task status and links to the run log.

We’ll call this example edge-function-trigger.

In your project, run the following command in the terminal using the Supabase CLI:

supabase functions new edge-function-trigger

Replace the placeholder code in your edge-function-trigger/index.ts file with the following:

// Setup type definitions for built-in Supabase Runtime APIs
import "jsr:@supabase/functions-js/edge-runtime.d.ts";
// Import the Trigger.dev SDK - replace "<your-sdk-version>" with the version of the SDK you are using, e.g. "3.0.0". You can find this in your package.json file.
import { tasks } from "npm:@trigger.dev/[email protected]/v3";
// Import your task type from your /trigger folder
import type { helloWorldTask } from "../../../src/trigger/example.ts";
//     👆 **type-only** import

Deno.serve(async () => {
  await tasks.trigger<typeof helloWorldTask>(
    // Your task id
    "hello-world",
    // Your task payload
    "Hello from a Supabase Edge Function!"
  );
  return new Response("OK");
});

You can now deploy your edge function with the following command in your terminal:

supabase functions deploy edge-function-trigger --no-verify-jwt

Follow the CLI instructions and once complete you should now see your new edge function deployment in your Supabase edge functions dashboard.

There will be a link to the dashboard in your terminal output, or you can find it at this URL:

https://supabase.com/dashboard/project/<your-project-id>/functions

Next, deploy your hello-world task to Trigger.dev cloud.

To do this all you need to do is simply open the edge-function-trigger URL.

https://supabase.com/dashboard/project/<your-project-id>/functions

In your Supabase project, go to your Edge function dashboard, find edge-function-trigger, copy the URL, and paste it into a new window in your browser.

Once loaded you should see ‘OK’ on the new screen.

The task will be triggered when your edge function URL is accessed.

Check your cloud.trigger.dev dashboard and you should see a succesful hello-world task.

Congratulations, you have run a simple Hello World task from a Supabase edge function!