@clubedge/create-clubedge-app 0.22.0 → 0.24.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to `create-clubedge-app` are documented here.
 
+## 0.24.0
+
+- Default to Starter `v0.17.0` (#61), which adds:
+  - Railway configuration as code: projects that deploy to Railway get `.railway/railway.ts` (the migrations before each release, the `/api/health` check) instead of `railway.json`, which Railway stops reading on 2026-12-01. It names the service after the package, and `pnpm clubedge deploy` applies it before each release.
+  - The deploy workflow on Railway CLI 5.
+- If you deploy to Railway: run `pnpm clubedge upgrade`, then deploy once with `pnpm clubedge deploy` (or run `railway config apply`) before 2026-12-01.
+
+## 0.23.0
+
+- `deploy` moves Railway projects to `.railway/railway.ts`, Railway's configuration as code, which replaces `railway.json`: Railway stops reading `railway.json` on 2026-12-01 (#59).
+  - When the project has no Railway configuration file, it writes one with the project's own names: the migrations before each release and the `/api/health` check, as in `railway.json`. Variables stay as `deploy` set them.
+  - It adds Railway's TypeScript SDK (`railway`) as a dev dependency, and applies the file with `railway config apply` before each release. Commit `.railway/railway.ts`, `package.json`, and `pnpm-lock.yaml`.
+  - It needs Railway CLI 5.42.1 or newer: an installed `railway`, else one npx already downloaded, and only then a download.
+- Still on Starter `v0.16.1`.
+
 ## 0.22.0
 
 - Add `deploy`: `pnpm clubedge deploy` does the first deploy of a project that uses `deploy railway`, with Railway's CLI and your Railway login (#55).

package/README.md

@@ -127,7 +127,7 @@ pnpm dlx @clubedge/create-clubedge-app my-app --yes --no-git --framework tanstac
 pnpm dlx @clubedge/create-clubedge-app my-app --ref main
 
 # Reproduce a specific Starter release or commit
-pnpm dlx @clubedge/create-clubedge-app my-app --ref v0.16.1
+pnpm dlx @clubedge/create-clubedge-app my-app --ref v0.17.0
 pnpm dlx @clubedge/create-clubedge-app my-app --ref <commit-sha>
 
 # Test local Starter changes before releasing them
@@ -146,7 +146,7 @@ pnpm clubedge add email resend payments stripe              # several modules as
 pnpm clubedge remove storage payments
 pnpm dlx @clubedge/create-clubedge-app add infra local --dry-run
 pnpm dlx @clubedge/create-clubedge-app@latest upgrade        # to the newest CLI's Starter release
-pnpm dlx @clubedge/create-clubedge-app upgrade --ref v0.16.1 # or a specific tag, branch, or commit
+pnpm dlx @clubedge/create-clubedge-app upgrade --ref v0.17.0 # or a specific tag, branch, or commit
 ```
 
 The CLI renders the project twice, from the Starter commit and modules recorded in your `package.json` and from the new state, and merges the difference into your project. The new state has other modules for `add` and `remove`, and the newer Starter with the same modules for `upgrade`. Modules a newer Starter introduces start as `none` where possible, so an upgrade never adds a service on its own.
@@ -199,34 +199,34 @@ pnpm clubedge deploy --env-file .env.production   # with your production provide
 pnpm clubedge deploy --dry-run                    # show the plan, create nothing
 ```
 
-With [Railway's CLI](https://docs.railway.com/cli) (the installed `railway`, or `npx @railway/cli`) and your Railway login, it creates or reuses a project named after the package, Postgres (and Redis with `cache redis`), the app's service, and a `*.up.railway.app` domain. It sets the variables it can: `DATABASE_URL` and `REDIS_URL` as references to those databases, `APP_URL` and `NEXT_PUBLIC_APP_URL`, `PORT`, and a generated `BETTER_AUTH_SECRET` that later runs keep. Values from `--env-file` come on top; the variables `.env.example` lists that nothing sets are reported, for the modules that need them (storage, email, payments). Then `railway up` builds the Dockerfile, Railway runs the migrations before the release and checks `/api/health`, and the URL is printed. Running `deploy` again reuses everything, so it also adds variables and ships a new release. Railway bills usage on your plan.
+With [Railway's CLI](https://docs.railway.com/cli) (the installed `railway`, or `npx @railway/cli`) and your Railway login, it creates or reuses a project named after the package, Postgres (and Redis with `cache redis`), the app's service, and a `*.up.railway.app` domain. It sets the variables it can: `DATABASE_URL` and `REDIS_URL` as references to those databases, `APP_URL` and `NEXT_PUBLIC_APP_URL`, `PORT`, and a generated `BETTER_AUTH_SECRET` that later runs keep. Values from `--env-file` come on top; the variables `.env.example` lists that nothing sets are reported, for the modules that need them (storage, email, payments). The service's settings (the migrations before each release, the `/api/health` check) go in `.railway/railway.ts`, Railway's configuration as code, which replaces `railway.json` (Railway stops reading it on 2026-12-01): `deploy` writes it when the project has none, adds Railway's TypeScript SDK (`railway`) as a dev dependency, and applies it with `railway config apply`; commit them. Then `railway up` builds the Dockerfile, and `deploy` waits for Railway's final status before printing the URL. It needs Railway CLI 5.42.1 or newer: an installed `railway`, else one npx already downloaded, else it downloads one. Running `deploy` again reuses everything, so it also adds variables and ships a new release. Railway bills usage on your plan.
 
 ## Version relationship
 
 Each CLI release is tested against one specific Starter release:
 
 ```text
-create-clubedge-app v0.22.0
+create-clubedge-app v0.24.0
         |
         v
-Clubedge Starter v0.16.1
-commit 72ff89e53a55a4e4a6262b364ce73be3b1c7a6b9
+Clubedge Starter v0.17.0
+commit 91be4541de5833527b52a8871a08578f63b89735
 ```
 
 The current relationship is:
 
 | CLI release | Default Starter release | Meaning |
 | --- | --- | --- |
-| `create-clubedge-app@0.22.0` | `clubedge-starter@v0.16.1` | The CLI's required, tested default |
+| `create-clubedge-app@0.24.0` | `clubedge-starter@v0.17.0` | The CLI's required, tested default |
 
 This means the same CLI version always scaffolds the same Starter revision by default. The CLI does not silently follow Starter `main`.
 
-The `v0.16.1` tag is expected to resolve to commit
-`72ff89e53a55a4e4a6262b364ce73be3b1c7a6b9`. The CLI verifies this before
+The `v0.17.0` tag is expected to resolve to commit
+`91be4541de5833527b52a8871a08578f63b89735`. The CLI verifies this before
 scaffolding with the default reference and fails rather than silently using a
 moved tag.
 
-When the Starter changes, its maintainers first publish a new versioned release, such as `v0.16.1`. The CLI is then updated to use that release, all generated-project checks must pass, and a new CLI version is published. This keeps Starter and CLI releases independently versioned while preserving a tested compatibility relationship.
+When the Starter changes, its maintainers first publish a new versioned release, such as `v0.17.0`. The CLI is then updated to use that release, all generated-project checks must pass, and a new CLI version is published. This keeps Starter and CLI releases independently versioned while preserving a tested compatibility relationship.
 
 Every generated project records its CLI version, Starter repository, Starter ref, Starter commit, framework, and modules in `package.json` and `README.md`.
 
@@ -281,7 +281,7 @@ CI packs the CLI with `npm pack`, scaffolds clean projects from the packed tarba
 1. Make and validate changes in `clubedge-starter`.
 2. Run lint, typecheck, unit tests, browser tests, and production build.
 3. Update the Starter package versions.
-4. Commit `main`, create a release tag such as `v0.16.1`, and publish the Starter release.
+4. Commit `main`, create a release tag such as `v0.17.0`, and publish the Starter release.
 
 ### CLI maintainers
 
@@ -313,6 +313,8 @@ Each phase ends with a Starter release and a CLI release pinned to it. The full
 | 0.20.0 | v0.15.0 | The Starter's version of each conflicted file in `.clubedge/incoming/`, several modules at once, sharing a `try` preview by claiming the VM, `try --status` |
 | 0.21.0 | v0.16.0 | Starter v0.16.0: upgrades delivered as pull requests, Node 24 actions; release tooling for maintainers |
 | 0.22.0 | v0.16.1 | `pnpm clubedge deploy`: a guided first deploy to Railway; faster Docker builds |
+| 0.23.0 | v0.16.1 | `deploy` moves Railway projects to `.railway/railway.ts` before Railway stops reading `railway.json` |
+| 0.24.0 | v0.17.0 | Starter v0.17.0: Railway configuration as code (`.railway/railway.ts`) instead of `railway.json` |
 | next | | Show the Starter's version of a conflicted file next to yours |
 
 ## Community

package/dist/core/deploy.js

@@ -129,3 +129,48 @@ export function deploymentStatus(output, id, since) {
         : deployments.find((deployment) => deployment.createdAt && new Date(deployment.createdAt).getTime() >= since.getTime() - 5_000);
     return found ? { id: found.id, status: found.status } : null;
 }
+/** The oldest Railway CLI that applies `.railway/railway.ts`: its IaC engine ships in the CLI. */
+export const minimumRailwayCli = [5, 42, 1];
+/** The version in `railway --version` output, such as "railway 5.67.1". */
+export function railwayCliVersion(output) {
+    const match = /\b(\d+)\.(\d+)\.(\d+)\b/.exec(output);
+    return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;
+}
+export function meetsMinimumCli(version) {
+    for (let i = 0; i < 3; i++) {
+        if (version[i] !== minimumRailwayCli[i])
+            return version[i] > minimumRailwayCli[i];
+    }
+    return true;
+}
+export const railwayIacPath = ".railway/railway.ts";
+/**
+ * The project's Railway configuration as code (`.railway/railway.ts`), which replaces railway.json:
+ * Railway stops reading railway.json on 2026-12-01. Railway builds the root Dockerfile by itself,
+ * the variables stay managed by `deploy` and the dashboard, and the region is Railway's default.
+ */
+export function railwayIacSource(service) {
+    const name = JSON.stringify(service);
+    return `// Railway's configuration for this project, applied with \`railway config apply\` (pnpm clubedge
+// deploy does it before each release). It replaces railway.json, which Railway stops reading on
+// 2026-12-01. Railway builds the root Dockerfile; variables are set with \`railway variable set\`.
+import { defineRailway, project, service } from "railway/iac";
+
+// This repository manages only its own resources in the Railway project.
+export const partial = ${name};
+
+export default defineRailway(() => {
+  const app = service(${name}, {
+    // Migrations run before each release; a failed migration stops it.
+    preDeploy: "node /app/migrate.mjs",
+    healthcheck: "/api/health",
+    healthcheckTimeout: 60,
+  });
+
+  return project(${name}, {
+    variables: { managed: false },
+    resources: [app],
+  });
+});
+`;
+}

package/dist/deploy.js

@@ -4,31 +4,94 @@
 import { cancel, confirm, isCancel, log, note, outro, spinner } from "@clack/prompts";
 import { spawn } from "node:child_process";
 import { randomBytes } from "node:crypto";
-import { readFile } from "node:fs/promises";
-import { join, resolve } from "node:path";
+import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
 import process from "node:process";
 import { UsageError } from "./cli/args.js";
 import { bold, dim } from "./cli/ui.js";
-import { appPort, databasesFor, deploymentStatus, exampleKeys, finalStatuses, parseDeploymentId, parseEnvFile, parseRailwayDomain, parseVariables, planVariables, railwayDatabases, serviceName, serviceNames, } from "./core/deploy.js";
+import { appPort, databasesFor, deploymentStatus, exampleKeys, finalStatuses, meetsMinimumCli, minimumRailwayCli, parseDeploymentId, parseEnvFile, parseRailwayDomain, parseVariables, planVariables, railwayCliVersion, railwayDatabases, railwayIacPath, railwayIacSource, serviceName, serviceNames, } from "./core/deploy.js";
 import { readProject } from "./core/project.js";
 import { cliCommand } from "./modify.js";
-import { commandSucceeds } from "./utils/process.js";
+import { resolvePnpm } from "./steps/install.js";
+import { pathExists } from "./utils/fs.js";
+import { run } from "./utils/process.js";
 const railwayTermsUrl = "https://railway.com/legal/terms";
 const deployDocsUrl = "https://starter.clubedge.live/docs/starter/deploy";
-// Package manager shims (npx.cmd, railway.cmd) need a shell on Windows. Every argument passed
-// here is a plain word; values go through stdin, so the shell never sees them.
-const useShell = process.platform === "win32";
-/** The Railway CLI: the installed `railway`, or the npm package through npx. */
+const windows = process.platform === "win32";
+const binaryName = windows ? "railway.exe" : "railway";
+async function cliVersion(command, shell) {
+    return await new Promise((resolveVersion) => {
+        const [file, ...args] = command;
+        const child = spawn(file, [...args, "--version"], { shell, stdio: ["ignore", "pipe", "ignore"] });
+        let out = "";
+        child.stdout?.on("data", (chunk) => (out += chunk.toString()));
+        child.once("error", () => resolveVersion(null));
+        child.once("close", (code) => resolveVersion(code === 0 ? railwayCliVersion(out) : null));
+    });
+}
+/** The railway.exe behind `railway` on PATH (npm installs a railway.cmd shim next to its package). */
+async function installedBinary() {
+    if (!windows)
+        return (await cliVersion(["railway"], false)) ? "railway" : null;
+    const found = await new Promise((resolveWhere) => {
+        const child = spawn("where", ["railway"], { stdio: ["ignore", "pipe", "ignore"] });
+        let out = "";
+        child.stdout?.on("data", (chunk) => (out += chunk.toString()));
+        child.once("error", () => resolveWhere(""));
+        child.once("close", () => resolveWhere(out));
+    });
+    for (const line of found.split(/\r?\n/).map((entry) => entry.trim()).filter(Boolean)) {
+        if (line.toLowerCase().endsWith(".exe"))
+            return line;
+        const shimmed = join(dirname(line), "node_modules", "@railway", "cli", "bin", binaryName);
+        if (await pathExists(shimmed))
+            return shimmed;
+    }
+    return null;
+}
+/** Railway CLI binaries npx already downloaded, newest first: no download on a slow connection. */
+async function cachedBinaries() {
+    const cache = process.env.npm_config_cache ||
+        (windows && process.env.LOCALAPPDATA ? join(process.env.LOCALAPPDATA, "npm-cache") : join(homedir(), ".npm"));
+    const found = [];
+    for (const entry of await readdir(join(cache, "_npx")).catch(() => [])) {
+        const path = join(cache, "_npx", entry, "node_modules", "@railway", "cli", "bin", binaryName);
+        const stats = await stat(path).catch(() => null);
+        if (stats?.isFile())
+            found.push({ path, time: stats.mtimeMs });
+    }
+    return found.sort((a, b) => b.time - a.time).map((entry) => entry.path);
+}
+/**
+ * A Railway CLI new enough for `.railway/railway.ts`: the installed one, then one npx already
+ * downloaded, and only then a download through npx.
+ */
 async function railwayCli() {
-    if (await commandSucceeds("railway", ["--version"]))
-        return ["railway"];
-    return ["npx", "--yes", "@railway/cli"];
+    const usable = async (binary) => {
+        const version = await cliVersion([binary], false);
+        return version !== null && meetsMinimumCli(version);
+    };
+    const installed = await installedBinary();
+    if (installed && (await usable(installed)))
+        return { command: [installed], executable: installed, shell: false };
+    for (const binary of await cachedBinaries()) {
+        if (await usable(binary))
+            return { command: [binary], executable: binary, shell: false };
+    }
+    await cliVersion(["npx", "--yes", "@railway/cli@latest"], windows);
+    for (const binary of await cachedBinaries()) {
+        if (await usable(binary))
+            return { command: [binary], executable: binary, shell: false };
+    }
+    throw new UsageError(`deploy needs Railway CLI ${minimumRailwayCli.join(".")} or newer. Install it with \`npm install -g @railway/cli\`, then run deploy again.`);
 }
 async function railway(cli, args, options = {}) {
-    const [command, ...prefix] = cli;
+    const [command, ...prefix] = cli.command;
     return await new Promise((resolvePromise, reject) => {
         const child = spawn(command, [...prefix, ...args], {
-            shell: useShell,
+            shell: cli.shell,
+            env: { ...process.env, _: cli.executable },
             stdio: options.inherit ? "inherit" : ["pipe", "pipe", "pipe"],
         });
         let stdout = "";
@@ -58,6 +121,7 @@ async function agree(args, service, databases) {
         `• A project with ${databases.map((db) => railwayDatabases[db]).join(" and ")}, and a service "${service}" with a public *.up.railway.app domain.`,
         "• The production variables Railway can provide; your provider keys come from --env-file.",
         "• Railway builds the Dockerfile, runs the migrations before the release, and checks /api/health; the first build takes several minutes.",
+        `• The service's settings go in ${railwayIacPath}, which replaces railway.json; the railway package is added to read it.`,
         "",
         `Railway bills usage on your plan. Running deploy again reuses all of it. Railway's terms: ${railwayTermsUrl}`,
     ].join("\n"), "Deploy to Railway");
@@ -85,6 +149,7 @@ export async function deployProject(args) {
         log.message([
             `• Railway project "${service}" with ${databases.join(" and ")}, and the service "${service}"`,
             `• A *.up.railway.app domain for port ${appPort}`,
+            `• ${railwayIacPath} (written if missing, with Railway's SDK added), applied with railway config apply`,
             `• Variables: ${Object.keys(preview.set).join(", ")}`,
             ...(preview.unset.length ? [`• Not set: ${preview.unset.join(", ")}`] : []),
             `• railway up: build, migrations, health check`,
@@ -146,7 +211,38 @@ export async function deployProject(args) {
             continue;
         await railway(rw, ["variable", "set", key, "--stdin", "--service", service, "--skip-deploys"], { input: value });
     }
+    // The service's settings as code: .railway/railway.ts replaces railway.json, which Railway stops
+    // reading on 2026-12-01. It needs Railway's TypeScript SDK, and applies before each release.
+    const iacFiles = [railwayIacPath, ".railway/railway.py", ".railway/railway.go"];
+    const changed = [];
+    let hasIac = false;
+    for (const file of iacFiles)
+        if (await pathExists(join(project.root, file)))
+            hasIac = true;
+    if (!hasIac) {
+        await mkdir(join(project.root, ".railway"), { recursive: true });
+        await writeFile(join(project.root, railwayIacPath), railwayIacSource(service));
+        changed.push(railwayIacPath);
+    }
+    if (await pathExists(join(project.root, railwayIacPath))) {
+        const manifest = JSON.parse(await readFile(join(project.root, "package.json"), "utf8"));
+        if (!manifest.devDependencies?.railway && !manifest.dependencies?.railway) {
+            const pnpm = await resolvePnpm();
+            if (!pnpm)
+                throw new UsageError("pnpm was not found. Enable it with `corepack enable`, then run deploy again.");
+            progress.stop("Adding Railway's TypeScript SDK (railway), which .railway/railway.ts imports");
+            const [command, ...prefix] = pnpm;
+            await run(command, [...prefix, "add", "--save-dev", "--workspace-root", "railway"], project.root);
+            changed.push("package.json", "pnpm-lock.yaml");
+            progress.start("Applying .railway/railway.ts");
+        }
+    }
+    progress.message(`Applying ${railwayIacPath}`);
+    await railway(rw, ["config", "apply", "--yes"]);
     progress.stop(`Railway is ready: ${url}`);
+    if (changed.length) {
+        log.info(`Commit ${changed.join(", ")}: Railway reads the service's settings from ${railwayIacPath} now. railway.json is no longer needed (Railway stops reading it on 2026-12-01).`);
+    }
     // Start the deploy detached, then follow its status: `railway up` can return before the build
     // ends, and only Railway's final status says whether the release went live.
     const deploying = spinner();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/create-clubedge-app",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Create a Next.js or TanStack Start application from the Clubedge Starter reference implementation.",
   "type": "module",
   "packageManager": "pnpm@10.9.0",
@@ -22,8 +22,8 @@
   },
   "clubedge": {
     "starterRepository": "Clubedge/clubedge-starter",
-    "starterRef": "v0.16.1",
-    "starterCommit": "72ff89e53a55a4e4a6262b364ce73be3b1c7a6b9"
+    "starterRef": "v0.17.0",
+    "starterCommit": "91be4541de5833527b52a8871a08578f63b89735"
   },
   "license": "Apache-2.0",
   "repository": {

package/template/.github/workflows/deploy.yml

@@ -54,8 +54,9 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v7
-      # Uploads this checkout; Railway builds the image and runs the pre-deploy migrations.
-      - run: npx --yes @railway/cli@4 up --ci --service "$RAILWAY_SERVICE"
+      # Uploads this checkout; Railway builds the image and runs the pre-deploy migrations set by
+      # .railway/railway.ts (applied with `pnpm clubedge deploy` or `railway config apply`).
+      - run: npx --yes @railway/cli@5 up --ci --service "$RAILWAY_SERVICE"
         env:
           RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
           RAILWAY_SERVICE: ${{ vars.RAILWAY_SERVICE }}

package/template/.railway/railway.ts

@@ -0,0 +1,35 @@
+// Railway's configuration for this project, as code: the migrations before each release and the
+// health check. `pnpm clubedge deploy` applies it before each release; elsewhere, run
+// `railway config apply` once. Railway builds the root Dockerfile; set variables with
+// `railway variable set` or the dashboard.
+import { readFileSync } from "node:fs";
+import { defineRailway, project, service } from "railway/iac";
+
+// The Railway service is named after the package, as `pnpm clubedge deploy` creates it. A service
+// you created yourself under another name: put that name here.
+const packageName: string = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+).name;
+const name =
+  packageName
+    .replace(/^@[^/]+\//, "")
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, "-")
+    .replace(/^-+|-+$/g, "") || "web";
+
+// This repository manages only its own resources in the Railway project.
+export const partial = name;
+
+export default defineRailway(() => {
+  const app = service(name, {
+    // Migrations run before each release; a failed migration stops it.
+    preDeploy: "node /app/migrate.mjs",
+    healthcheck: "/api/health",
+    healthcheckTimeout: 60,
+  });
+
+  return project(name, {
+    variables: { managed: false },
+    resources: [app],
+  });
+});

package/template/README.md

@@ -74,7 +74,7 @@ Every combination in the CI matrix is generated as a real project and runs its f
 - A production image that includes its own migrator (`node /app/migrate.mjs`), for running migrations before each release.
 - A manual deploy workflow for the chosen platform, and a readiness endpoint (`/api/ready`) that checks the database.
 - Deployment to Fly.io with `fly.toml`: migrations run as the release command. <!-- clubedge:only deploy=fly -->
-- Deployment to Railway with `railway.json`: migrations run before each deploy. <!-- clubedge:only deploy=railway -->
+- Deployment to Railway with `.railway/railway.ts`: migrations run before each release, and `pnpm clubedge deploy` sets up the project. <!-- clubedge:only deploy=railway -->
 - Deployment to Render with a `render.yaml` Blueprint: migrations run before each deploy. <!-- clubedge:only deploy=render -->
 - Deployment to Vercel with `apps/web/vercel.json`: migrations run during the build. <!-- clubedge:only deploy=vercel -->
 - Deployment to Netlify with `apps/web/netlify.toml`: migrations run during the build. <!-- clubedge:only deploy=netlify -->

package/template/SETUP.md

@@ -390,7 +390,9 @@ Set the other production variables listed below with `fly secrets set`. Each dep
 <!-- clubedge:end -->
 <!-- clubedge:if deploy=railway -->
 
-`railway.json` deploys the production image to [Railway](https://railway.com): create a project from this repository, add the production variables listed below to the service, and deploy. Railway runs `node /app/migrate.mjs` as the pre-deploy command, so a failed migration stops the release, and checks `/api/health` before switching traffic.
+`.railway/railway.ts` is the service's configuration on [Railway](https://railway.com), as code: Railway builds the root `Dockerfile`, runs `node /app/migrate.mjs` before each release, so a failed migration stops it, and checks `/api/health` before switching traffic.
+
+The quickest first deploy is `pnpm clubedge deploy`: it creates the project, Postgres, the service, its domain and variables, applies `.railway/railway.ts`, and deploys. To deploy another way, add Railway's TypeScript SDK with `pnpm add -D -w railway`, run `railway config apply` once (Railway CLI 5.42.1 or newer), and add the production variables listed below to the service. The file names the service after the package; if yours has another name, change it there.
 
 <!-- clubedge:end -->
 <!-- clubedge:if deploy=render -->

package/template/apps/start/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/start",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/web",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "scripts": {

package/template/clubedge.template.json

@@ -397,7 +397,7 @@
         },
         "railway": {
           "name": "Railway",
-          "files": ["railway.json"]
+          "files": [".railway/railway.ts"]
         },
         "render": {
           "name": "Render",

package/template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clubedge-starter-v1",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.9.0",

package/template/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/auth-better-auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth-better-auth",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Better Auth adapter for @clubedge/auth, storing users and sessions in your own PostgreSQL.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/auth-supabase/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/auth-supabase",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Supabase Auth adapter for @clubedge/auth.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/cache/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/cache",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/cache-redis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/cache-redis",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Redis rate limiter and cache for @clubedge/cache.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/core",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/db/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/db",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/email/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/email",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Email interface, console and in-memory providers, and message templates.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/email-resend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/email-resend",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Resend provider for @clubedge/email, through Resend's HTTP API.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/email-smtp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/email-smtp",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "SMTP provider for @clubedge/email, for any SMTP server.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/jobs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/jobs",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Background jobs interface: job definitions, a queue contract, and an in-memory queue.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/jobs-pg-boss/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/jobs-pg-boss",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "pg-boss provider for @clubedge/jobs: a job queue stored in the project's PostgreSQL.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/local-db/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/local-db",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "PostgreSQL for development without Docker: PGlite served over the PostgreSQL protocol.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/observability/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/observability",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Observability interface: error reports and spans for @clubedge/core's telemetry hooks, and an in-memory provider for tests.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/observability-otel/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/observability-otel",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "OpenTelemetry provider for @clubedge/observability: traces and error logs exported over OTLP to any collector.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/observability-sentry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/observability-sentry",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Sentry provider for @clubedge/observability: server and browser errors, traces, and source map uploads.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/payments/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/payments",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Provider-neutral payments: the PaymentProvider interface, billing logic, and subscription tables.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/payments-stripe/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/payments-stripe",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Stripe provider for @clubedge/payments: Checkout, the customer portal, and verified webhooks.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template/packages/storage-s3/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage-s3",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "S3-compatible adapter for @clubedge/storage.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/storage-supabase/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/storage-supabase",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Supabase Storage adapter for @clubedge/storage.",
   "private": true,
   "license": "Apache-2.0",

package/template/packages/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/ui",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

package/template.lock.json

@@ -1,7 +1,7 @@
 {
   "repository": "Clubedge/clubedge-starter",
-  "ref": "v0.16.1",
-  "commit": "72ff89e53a55a4e4a6262b364ce73be3b1c7a6b9",
+  "ref": "v0.17.0",
+  "commit": "91be4541de5833527b52a8871a08578f63b89735",
   "files": [
     ".dockerignore",
     ".env.example",
@@ -16,6 +16,7 @@
     "_gitignore",
     ".prettierignore",
     ".prettierrc.json",
+    ".railway/railway.ts",
     "AGENTS.md",
     "CODE_OF_CONDUCT.md",
     "CONTRIBUTING.md",
@@ -378,7 +379,6 @@
     "playwright.config.ts",
     "pnpm-lock.yaml",
     "pnpm-workspace.yaml",
-    "railway.json",
     "render.yaml",
     "scripts/build-migrator.mjs",
     "scripts/migrate.mjs",

package/template/railway.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "https://railway.com/railway.schema.json",
-  "build": {
-    "builder": "DOCKERFILE",
-    "dockerfilePath": "Dockerfile"
-  },
-  "deploy": {
-    "preDeployCommand": ["node /app/migrate.mjs"],
-    "healthcheckPath": "/api/health",
-    "healthcheckTimeout": 60,
-    "restartPolicyType": "ON_FAILURE"
-  }
-}