Astro Quick Start

You can either:

• Use the Trigger.dev Cloud.
• Or self-host the service.

Once you've created an account, follow the steps in the app to:

1. Complete your account details.
2. Create your first Organization and Project.

1. Go to the "Environments & API Keys" page in your project.

2. Copy the DEV SERVER API key.

The easiest way to get started it to use the CLI. It will add Trigger.dev to your existing project, setup a route and give you an example file.

In a terminal window run:

npx @trigger.dev/cli@latest init

It will ask you a couple of questions

1. Are you using the Trigger.dev Cloud or self-hosting?
2. Enter your development API key. Enter the key you copied earlier.

Make sure your site is running locally, we will connect to it to register your Jobs.

npm run dev

The CLI dev command allows the Trigger.dev service to send messages to your site. This is required for registering Jobs, triggering them and running tasks. To achieve this it creates a tunnel (using ngrok) so Trigger.dev can send messages to your machine.

You should leave the dev command running when you're developing.

In a new terminal window or tab run:

npx @trigger.dev/cli@latest dev

npm install concurrently --save-dev

//...
"scripts": {
  "dev": "concurrently --kill-others npm:dev:*",
  //your normal astro dev command would go here
  "dev:astro": "astro dev",
  "dev:trigger": "npx @trigger.dev/cli dev",
  //...
}
//...

The CLI init command created a simple Job for you. There will be a new file src/jobs/example.(ts/js).

In there is this Job:

// Your first job
// This Job will be triggered by an event, log a joke to the console, and then wait 5 seconds before logging the punchline
client.defineJob({
  // This is the unique identifier for your Job, it must be unique across all Jobs in your project
  id: "example-job",
  name: "Example Job: a joke with a delay",
  version: "0.0.1",
  // This is triggered by an event using eventTrigger. You can also trigger Jobs with webhooks, on schedules, and more: https://trigger.dev/docs/documentation/concepts/triggers/introduction
  trigger: eventTrigger({
    name: "example.event",
  }),
  run: async (payload, io, ctx) => {
    // This logs a message to the console
    await io.logger.info("🧪 Example Job: a joke with a delay");
    await io.logger.info("How do you comfort a JavaScript bug?");
    // This waits for 5 seconds, the second parameter is the number of seconds to wait, you can add delays of up to a year
    await io.wait("Wait 5 seconds for the punchline...", 5);
    await io.logger.info("You console it! 🤦");
    await io.logger.info(
      "✨ Congratulations, You just ran your first successful Trigger.dev Job! ✨"
    );
    // To learn how to write much more complex (and probably funnier) Jobs, check out our docs: https://trigger.dev/docs/documentation/guides/create-a-job
  },
});

If you navigate to your Trigger.dev project you will see this Job in the “Jobs” section:

There are two way to trigger this Job.

1. Use the "Test" functionality in the dashboard.
2. Use the Trigger.dev API (either via our SDK or a web request)

"Testing" from the dashboard

Click into the Job and then open the "Test" tab. You should see this page:

This Job doesn't have a payload schema (meaning it takes an empty object), so you can simple click the "Run test" button.

Congratulations, you should get redirected so you can see your first Run!