feat(cli,webapp): default new projects to node-24

Author: carderne

.changeset/node-24-project-default.md

@@ -0,0 +1,5 @@
+---
+"trigger.dev": patch
+---
+
+New projects created with `trigger init` use Node.js 24 by default. Deployments whose config omits `runtime` now use their project's configured default runtime.

.server-changes/default-new-project-runtime-node-24.md

@@ -0,0 +1,6 @@
+---
+area: webapp
+type: feature
+---
+
+New projects use Node.js 24 when their deployment config does not specify a runtime.

apps/webapp/app/models/project.server.ts

@@ -113,6 +113,7 @@ export async function createProject(
       // for historical rows; the V1->V2 upgrade guards on worker-register / deploy
       // stay in place to migrate existing legacy projects.
       engine: "V2",
+      defaultRuntime: "node-24",
       onboardingData,
     },
     include: {

apps/webapp/app/routes/api.v1.projects.$projectRef.$env.ts

@@ -1,5 +1,5 @@
 import { json, type LoaderFunctionArgs } from "@remix-run/server-runtime";
-import { type GetProjectEnvResponse } from "@trigger.dev/core/v3";
+import { BuildRuntime, type GetProjectEnvResponse } from "@trigger.dev/core/v3";
 import { z } from "zod";
 import { env as processEnv } from "~/env.server";
 import {
@@ -65,6 +65,7 @@ export async function loader({ request, params }: LoaderFunctionArgs) {
       name: environment.project.name,
       apiUrl: processEnv.API_ORIGIN ?? processEnv.APP_ORIGIN,
       projectId: environment.project.id,
+      defaultRuntime: BuildRuntime.nullable().parse(environment.project.defaultRuntime),
     };
 
     return json(result);

apps/webapp/app/routes/api.v1.projects.$projectRef.ts

@@ -1,5 +1,5 @@
 import { json } from "@remix-run/server-runtime";
-import type { GetProjectResponseBody } from "@trigger.dev/core/v3";
+import { BuildRuntime, type GetProjectResponseBody } from "@trigger.dev/core/v3";
 import { z } from "zod";
 import { prisma } from "~/db.server";
 import { DeleteProjectService } from "~/services/deleteProject.server";
@@ -53,6 +53,7 @@ export const loader = createLoaderPATApiRoute(
       slug: project.slug,
       createdAt: project.createdAt,
       defaultRegion: project.defaultWorkerGroup?.name ?? null,
+      defaultRuntime: BuildRuntime.nullable().parse(project.defaultRuntime),
       organization: {
         id: project.organization.id,
         title: project.organization.title,

apps/webapp/app/v3/services/initializeDeployment.server.ts

@@ -253,7 +253,7 @@ export class InitializeDeploymentService extends BaseService {
             imagePlatform: env.DEPLOY_IMAGE_PLATFORM,
             git: payload.gitMeta ?? undefined,
             commitSHA: payload.gitMeta?.commitSha ?? undefined,
-            runtime: payload.runtime ?? undefined,
+            runtime: payload.runtime ?? environment.project.defaultRuntime ?? undefined,
             triggeredVia: payload.triggeredVia ?? undefined,
             startedAt: initialStatus === "BUILDING" ? new Date() : undefined,
           };

internal-packages/database/prisma/migrations/20260817111521_add_project_default_runtime/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "Project" ADD COLUMN "defaultRuntime" TEXT;

internal-packages/database/prisma/schema.prisma

@@ -474,6 +474,9 @@ model Project {
   /// Set the first time the CLI `init` command completes against this project. Drives the dev onboarding progress.
   initializedAt DateTime?
 
+  /// Runtime used when a deployment config does not specify one. Null preserves the legacy Node 20 fallback.
+  defaultRuntime String?
+
   version ProjectVersion   @default(V2)
   engine  RunEngineVersion @default(V1)
 
@@ -790,26 +793,26 @@ model WebhookEndpoint {
 
   source           String // provider tag e.g. "stripe","slack","github"
   handlerWebhookId String // declared webhook() id (string ref, GOLDEN LAW, no relation)
-  routingTarget    Json   // RoutingTarget tagged union ({ type: "task" } | { type: "session" })
-  verifierArtifact Json   // VerifierArtifact tagged union (config|preset in P1)
+  routingTarget    Json // RoutingTarget tagged union ({ type: "task" } | { type: "session" })
+  verifierArtifact Json // VerifierArtifact tagged union (config|preset in P1)
   filter           String? // source filter DSL string (display/round-trip)
-  filterAst        Json?   // compiled FilterAst, evaluated at ingest; null = route all
-  filterAstVersion Int?    // re-parse `filter` on a format bump
-  metadata         Json   @default("{}") // arbitrary user metadata; flows into the webhook task
+  filterAst        Json? // compiled FilterAst, evaluated at ingest; null = route all
+  filterAstVersion Int? // re-parse `filter` on a format bump
+  metadata         Json    @default("{}") // arbitrary user metadata; flows into the webhook task
 
   // who supplies the secret/key; drives the Connect UI (paste vs generate). From the source.
   secretProvisioning String @default("either") // "provider" | "integrator" | "either"
 
   /// SecretReference.key string. Plain String, NO @relation -> no FK to SecretReference.
   signingSecretKey String?
 
-  status    WebhookEndpointStatus @default(ACTIVE)
+  status                WebhookEndpointStatus @default(ACTIVE)
   /// When an operator disabled the endpoint via the dashboard/API. Null means the declarative sync
   /// owns the status: a redeploy that re-declares a previously-removed (auto-deactivated) webhook
   /// reactivates it. Non-null means the operator disabled it, so the sync leaves the status alone.
   manuallyDeactivatedAt DateTime?
-  createdAt DateTime              @default(now())
-  updatedAt DateTime              @updatedAt
+  createdAt             DateTime              @default(now())
+  updatedAt             DateTime              @updatedAt
 
   @@unique([runtimeEnvironmentId, handlerWebhookId, endpointTenantId, endpointExternalRef]) // deploy-sync key
   @@index([runtimeEnvironmentId, source])
@@ -842,8 +845,8 @@ model WebhookDelivery {
   /// Set from the x-trigger-test ingress header; marks console/test-send deliveries so the list can filter them.
   isTest Boolean @default(false)
 
-  parsedEvent  Json?   // size-capped snapshot of the verified event (full event lives in ClickHouse)
-  headers      Json?   // inbound request headers, surfaced to the webhook task via onEvent({ headers })
+  parsedEvent  Json? // size-capped snapshot of the verified event (full event lives in ClickHouse)
+  headers      Json? // inbound request headers, surfaced to the webhook task via onEvent({ headers })
   rawBodyHash  String? // sha256 of raw bytes; cheap P2 replay anchor
   errorMessage String?
   filterReason String? // why a FILTERED delivery was not routed (failing clause + actual value)
@@ -2370,8 +2373,8 @@ model TaskSchedule {
   timezone String @default("UTC")
 
   // Cron spread
-  windowDurationSeconds       Int?
-  windowPercentage            Int?
+  windowDurationSeconds Int?
+  windowPercentage      Int?
 
   ///Can be provided by the user then accessed inside a run
   externalId String?

packages/cli-v3/src/commands/deploy.ts

@@ -300,7 +300,7 @@ async function _deployCommand(dir: string, options: DeployCommandOptions) {
     logger.debug("Using project ref from env", { ref: envVars.TRIGGER_PROJECT_REF });
   }
 
-  const resolvedConfig = await loadConfig({
+  let resolvedConfig = await loadConfig({
     cwd: projectPath,
     overrides: { project: options.projectRef ?? envVars.TRIGGER_PROJECT_REF },
     configFile: options.config,
@@ -364,6 +364,15 @@ async function _deployCommand(dir: string, options: DeployCommandOptions) {
     throw new Error("Failed to get project client");
   }
 
+  if (projectClient.defaultRuntime) {
+    resolvedConfig = await loadConfig({
+      cwd: projectPath,
+      overrides: { project: options.projectRef ?? envVars.TRIGGER_PROJECT_REF },
+      configFile: options.config,
+      defaultRuntime: projectClient.defaultRuntime,
+    });
+  }
+
   if (options.nativeBuildServer) {
     await handleNativeBuildServerDeploy({
       apiClient: projectClient.client,

packages/cli-v3/src/commands/init.ts

@@ -50,7 +50,7 @@ const InitCommandOptions = CommonCommandOptions.extend({
   overrideConfig: z.boolean().default(false),
   tag: z.string().default(cliVersion),
   skipPackageInstall: z.boolean().default(false),
-  runtime: z.string().default("node"),
+  runtime: z.string().default("node-24"),
   pkgArgs: z.string().optional(),
   gitRef: z.string().default("main"),
   javascript: z.boolean().default(false),
@@ -94,8 +94,8 @@ Examples:
       )
       .option(
         "-r, --runtime <runtime>",
-        "Which runtime to use for the project. Supported: node, node-22, bun",
-        "node"
+        "Which runtime to use for the project. Supported: node, node-22, node-24, node-26, bun",
+        "node-24"
       )
       .option("--skip-package-install", "Skip installing the @trigger.dev/sdk package")
       .option("--override-config", "Override the existing config file if it exists")