@nexical/cli 0.11.3 → 0.11.4

package/dist/index.js

@@ -15,7 +15,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@nexical/cli",
-  version: "0.11.3",
+  version: "0.11.4",
   type: "module",
   bin: {
     nexical: "./dist/index.js"

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts","../package.json"],"sourcesContent":["#!/usr/bin/env node\nimport { CLI, findProjectRoot } from '@nexical/cli-core';\nimport { fileURLToPath } from 'node:url';\nimport { discoverCommandDirectories } from './src/utils/discovery.js';\nimport pkg from './package.json';\nimport path from 'node:path';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst commandName = 'nexical';\nconst projectRoot = (await findProjectRoot(commandName, process.cwd())) || process.cwd();\nconst coreCommandsDir = path.resolve(__dirname, './src/commands');\nconst additionalCommands = discoverCommandDirectories(projectRoot);\n\n// Filter out duplicate core commands and source versions\nconst filteredAdditional = additionalCommands.filter((dir) => {\n  const resolvedDir = path.resolve(dir);\n  const resolvedCore = path.resolve(coreCommandsDir);\n\n  if (resolvedDir === resolvedCore) return false;\n\n  // Check if this is another instance of the core CLI commands (by checking path suffix)\n  const coreSuffix = path.join('@nexical', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixSrc = path.join('packages', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixRawSrc = path.join('packages', 'cli', 'src', 'commands');\n\n  if (\n    resolvedDir.endsWith(coreSuffix) ||\n    resolvedDir.endsWith(coreSuffixSrc) ||\n    resolvedDir.endsWith(coreSuffixRawSrc)\n  ) {\n    return false;\n  }\n\n  // Handle mismatch between dist/src and src/\n  if (resolvedCore.includes(path.join(path.sep, 'dist', 'src', 'commands'))) {\n    const srcVersion = resolvedCore.replace(\n      path.join(path.sep, 'dist', 'src', 'commands'),\n      path.join(path.sep, 'src', 'commands'),\n    );\n    if (resolvedDir === srcVersion) return false;\n  }\n\n  return true;\n});\n\nconst app = new CLI({\n  version: pkg.version,\n  commandName: commandName,\n  searchDirectories: [...new Set([coreCommandsDir, ...filteredAdditional])],\n});\napp.start();\n","{\n  \"name\": \"@nexical/cli\",\n  \"version\": \"0.11.3\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"nexical\": \"./dist/index.js\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"start\": \"node dist/index.js\",\n    \"test\": \"npm run test:unit && npm run test:integration && npm run test:e2e\",\n    \"test:unit\": \"vitest run --config vitest.config.ts --coverage\",\n    \"test:integration\": \"vitest run --config vitest.integration.config.ts\",\n    \"test:e2e\": \"npm run build && vitest run --config vitest.e2e.config.ts\",\n    \"test:watch\": \"vitest\",\n    \"format\": \"prettier --write .\",\n    \"lint\": \"eslint .\",\n    \"lint:fix\": \"eslint . --fix\",\n    \"prepare\": \"husky\"\n  },\n  \"lint-staged\": {\n    \"**/*\": [\n      \"prettier --write --ignore-unknown\"\n    ],\n    \"**/*.{js,jsx,ts,tsx,astro}\": [\n      \"eslint --fix\"\n    ]\n  },\n  \"dependencies\": {\n    \"@nexical/cli-core\": \"^0.1.12\",\n    \"yaml\": \"^2.3.4\",\n    \"fast-glob\": \"^3.3.3\"\n  },\n  \"devDependencies\": {\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/node\": \"^20.10.0\",\n    \"@vitest/coverage-v8\": \"^4.0.15\",\n    \"execa\": \"^9.6.1\",\n    \"fs-extra\": \"^11.3.2\",\n    \"tsup\": \"^8.0.1\",\n    \"tsx\": \"^4.21.0\",\n    \"typescript\": \"^5.3.3\",\n    \"vitest\": \"^4.0.15\",\n    \"@eslint/js\": \"^9.39.2\",\n    \"eslint\": \"^9.39.2\",\n    \"eslint-config-prettier\": \"^10.1.8\",\n    \"eslint-plugin-astro\": \"^1.5.0\",\n    \"eslint-plugin-jsx-a11y\": \"^6.10.2\",\n    \"eslint-plugin-react\": \"^7.37.5\",\n    \"eslint-plugin-react-hooks\": \"^7.0.1\",\n    \"globals\": \"^17.2.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^16.2.7\",\n    \"prettier\": \"^3.8.1\",\n    \"typescript-eslint\": \"^8.54.0\"\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,SAAS,KAAK,uBAAuB;AACrC,SAAS,qBAAqB;;;ACF9B;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,MAAQ;AAAA,EACR,KAAO;AAAA,IACL,SAAW;AAAA,EACb;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,KAAO;AAAA,IACP,OAAS;AAAA,IACT,MAAQ;AAAA,IACR,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,QAAU;AAAA,IACV,MAAQ;AAAA,IACR,YAAY;AAAA,IACZ,SAAW;AAAA,EACb;AAAA,EACA,eAAe;AAAA,IACb,QAAQ;AAAA,MACN;AAAA,IACF;AAAA,IACA,8BAA8B;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA,EACA,cAAgB;AAAA,IACd,qBAAqB;AAAA,IACrB,MAAQ;AAAA,IACR,aAAa;AAAA,EACf;AAAA,EACA,iBAAmB;AAAA,IACjB,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,uBAAuB;AAAA,IACvB,OAAS;AAAA,IACT,YAAY;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,YAAc;AAAA,IACd,QAAU;AAAA,IACV,cAAc;AAAA,IACd,QAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,6BAA6B;AAAA,IAC7B,SAAW;AAAA,IACX,OAAS;AAAA,IACT,eAAe;AAAA,IACf,UAAY;AAAA,IACZ,qBAAqB;AAAA,EACvB;AACF;;;ADpDA,OAAO,UAAU;AAEjB,IAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE7D,IAAM,cAAc;AACpB,IAAM,cAAe,MAAM,gBAAgB,aAAa,QAAQ,IAAI,CAAC,KAAM,QAAQ,IAAI;AACvF,IAAM,kBAAkB,KAAK,QAAQ,WAAW,gBAAgB;AAChE,IAAM,qBAAqB,2BAA2B,WAAW;AAGjE,IAAM,qBAAqB,mBAAmB,OAAO,CAAC,QAAQ;AAC5D,QAAM,cAAc,KAAK,QAAQ,GAAG;AACpC,QAAM,eAAe,KAAK,QAAQ,eAAe;AAEjD,MAAI,gBAAgB,aAAc,QAAO;AAGzC,QAAM,aAAa,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AACzE,QAAM,gBAAgB,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AAC5E,QAAM,mBAAmB,KAAK,KAAK,YAAY,OAAO,OAAO,UAAU;AAEvE,MACE,YAAY,SAAS,UAAU,KAC/B,YAAY,SAAS,aAAa,KAClC,YAAY,SAAS,gBAAgB,GACrC;AACA,WAAO;AAAA,EACT;AAGA,MAAI,aAAa,SAAS,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU,CAAC,GAAG;AACzE,UAAM,aAAa,aAAa;AAAA,MAC9B,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU;AAAA,MAC7C,KAAK,KAAK,KAAK,KAAK,OAAO,UAAU;AAAA,IACvC;AACA,QAAI,gBAAgB,WAAY,QAAO;AAAA,EACzC;AAEA,SAAO;AACT,CAAC;AAED,IAAM,MAAM,IAAI,IAAI;AAAA,EAClB,SAAS,gBAAI;AAAA,EACb;AAAA,EACA,mBAAmB,CAAC,GAAG,oBAAI,IAAI,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,CAAC;AAC1E,CAAC;AACD,IAAI,MAAM;","names":[]}
+{"version":3,"sources":["../index.ts","../package.json"],"sourcesContent":["#!/usr/bin/env node\nimport { CLI, findProjectRoot } from '@nexical/cli-core';\nimport { fileURLToPath } from 'node:url';\nimport { discoverCommandDirectories } from './src/utils/discovery.js';\nimport pkg from './package.json';\nimport path from 'node:path';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst commandName = 'nexical';\nconst projectRoot = (await findProjectRoot(commandName, process.cwd())) || process.cwd();\nconst coreCommandsDir = path.resolve(__dirname, './src/commands');\nconst additionalCommands = discoverCommandDirectories(projectRoot);\n\n// Filter out duplicate core commands and source versions\nconst filteredAdditional = additionalCommands.filter((dir) => {\n  const resolvedDir = path.resolve(dir);\n  const resolvedCore = path.resolve(coreCommandsDir);\n\n  if (resolvedDir === resolvedCore) return false;\n\n  // Check if this is another instance of the core CLI commands (by checking path suffix)\n  const coreSuffix = path.join('@nexical', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixSrc = path.join('packages', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixRawSrc = path.join('packages', 'cli', 'src', 'commands');\n\n  if (\n    resolvedDir.endsWith(coreSuffix) ||\n    resolvedDir.endsWith(coreSuffixSrc) ||\n    resolvedDir.endsWith(coreSuffixRawSrc)\n  ) {\n    return false;\n  }\n\n  // Handle mismatch between dist/src and src/\n  if (resolvedCore.includes(path.join(path.sep, 'dist', 'src', 'commands'))) {\n    const srcVersion = resolvedCore.replace(\n      path.join(path.sep, 'dist', 'src', 'commands'),\n      path.join(path.sep, 'src', 'commands'),\n    );\n    if (resolvedDir === srcVersion) return false;\n  }\n\n  return true;\n});\n\nconst app = new CLI({\n  version: pkg.version,\n  commandName: commandName,\n  searchDirectories: [...new Set([coreCommandsDir, ...filteredAdditional])],\n});\napp.start();\n","{\n  \"name\": \"@nexical/cli\",\n  \"version\": \"0.11.4\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"nexical\": \"./dist/index.js\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"start\": \"node dist/index.js\",\n    \"test\": \"npm run test:unit && npm run test:integration && npm run test:e2e\",\n    \"test:unit\": \"vitest run --config vitest.config.ts --coverage\",\n    \"test:integration\": \"vitest run --config vitest.integration.config.ts\",\n    \"test:e2e\": \"npm run build && vitest run --config vitest.e2e.config.ts\",\n    \"test:watch\": \"vitest\",\n    \"format\": \"prettier --write .\",\n    \"lint\": \"eslint .\",\n    \"lint:fix\": \"eslint . --fix\",\n    \"prepare\": \"husky\"\n  },\n  \"lint-staged\": {\n    \"**/*\": [\n      \"prettier --write --ignore-unknown\"\n    ],\n    \"**/*.{js,jsx,ts,tsx,astro}\": [\n      \"eslint --fix\"\n    ]\n  },\n  \"dependencies\": {\n    \"@nexical/cli-core\": \"^0.1.12\",\n    \"yaml\": \"^2.3.4\",\n    \"fast-glob\": \"^3.3.3\"\n  },\n  \"devDependencies\": {\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/node\": \"^20.10.0\",\n    \"@vitest/coverage-v8\": \"^4.0.15\",\n    \"execa\": \"^9.6.1\",\n    \"fs-extra\": \"^11.3.2\",\n    \"tsup\": \"^8.0.1\",\n    \"tsx\": \"^4.21.0\",\n    \"typescript\": \"^5.3.3\",\n    \"vitest\": \"^4.0.15\",\n    \"@eslint/js\": \"^9.39.2\",\n    \"eslint\": \"^9.39.2\",\n    \"eslint-config-prettier\": \"^10.1.8\",\n    \"eslint-plugin-astro\": \"^1.5.0\",\n    \"eslint-plugin-jsx-a11y\": \"^6.10.2\",\n    \"eslint-plugin-react\": \"^7.37.5\",\n    \"eslint-plugin-react-hooks\": \"^7.0.1\",\n    \"globals\": \"^17.2.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^16.2.7\",\n    \"prettier\": \"^3.8.1\",\n    \"typescript-eslint\": \"^8.54.0\"\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,SAAS,KAAK,uBAAuB;AACrC,SAAS,qBAAqB;;;ACF9B;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,MAAQ;AAAA,EACR,KAAO;AAAA,IACL,SAAW;AAAA,EACb;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,KAAO;AAAA,IACP,OAAS;AAAA,IACT,MAAQ;AAAA,IACR,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,QAAU;AAAA,IACV,MAAQ;AAAA,IACR,YAAY;AAAA,IACZ,SAAW;AAAA,EACb;AAAA,EACA,eAAe;AAAA,IACb,QAAQ;AAAA,MACN;AAAA,IACF;AAAA,IACA,8BAA8B;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA,EACA,cAAgB;AAAA,IACd,qBAAqB;AAAA,IACrB,MAAQ;AAAA,IACR,aAAa;AAAA,EACf;AAAA,EACA,iBAAmB;AAAA,IACjB,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,uBAAuB;AAAA,IACvB,OAAS;AAAA,IACT,YAAY;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,YAAc;AAAA,IACd,QAAU;AAAA,IACV,cAAc;AAAA,IACd,QAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,6BAA6B;AAAA,IAC7B,SAAW;AAAA,IACX,OAAS;AAAA,IACT,eAAe;AAAA,IACf,UAAY;AAAA,IACZ,qBAAqB;AAAA,EACvB;AACF;;;ADpDA,OAAO,UAAU;AAEjB,IAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE7D,IAAM,cAAc;AACpB,IAAM,cAAe,MAAM,gBAAgB,aAAa,QAAQ,IAAI,CAAC,KAAM,QAAQ,IAAI;AACvF,IAAM,kBAAkB,KAAK,QAAQ,WAAW,gBAAgB;AAChE,IAAM,qBAAqB,2BAA2B,WAAW;AAGjE,IAAM,qBAAqB,mBAAmB,OAAO,CAAC,QAAQ;AAC5D,QAAM,cAAc,KAAK,QAAQ,GAAG;AACpC,QAAM,eAAe,KAAK,QAAQ,eAAe;AAEjD,MAAI,gBAAgB,aAAc,QAAO;AAGzC,QAAM,aAAa,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AACzE,QAAM,gBAAgB,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AAC5E,QAAM,mBAAmB,KAAK,KAAK,YAAY,OAAO,OAAO,UAAU;AAEvE,MACE,YAAY,SAAS,UAAU,KAC/B,YAAY,SAAS,aAAa,KAClC,YAAY,SAAS,gBAAgB,GACrC;AACA,WAAO;AAAA,EACT;AAGA,MAAI,aAAa,SAAS,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU,CAAC,GAAG;AACzE,UAAM,aAAa,aAAa;AAAA,MAC9B,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU;AAAA,MAC7C,KAAK,KAAK,KAAK,KAAK,OAAO,UAAU;AAAA,IACvC;AACA,QAAI,gBAAgB,WAAY,QAAO;AAAA,EACzC;AAEA,SAAO;AACT,CAAC;AAED,IAAM,MAAM,IAAI,IAAI;AAAA,EAClB,SAAS,gBAAI;AAAA,EACb;AAAA,EACA,mBAAmB,CAAC,GAAG,oBAAI,IAAI,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,CAAC;AAC1E,CAAC;AACD,IAAI,MAAM;","names":[]}

package/dist/src/commands/deploy.d.ts

@@ -3,6 +3,9 @@ import { BaseCommand } from '@nexical/cli-core';
 interface DeployOptions {
     dryRun: boolean;
     railwayToken?: string;
+    railwayName?: string;
+    backendName: string;
+    frontendName: string;
     cloudflareToken?: string;
     cloudflareAccount?: string;
 }
@@ -17,12 +20,16 @@ declare class DeployCommand extends BaseCommand {
             name: string;
             description: string;
             default?: undefined;
+        } | {
+            name: string;
+            description: string;
+            default: string;
         })[];
     };
     run(options: DeployOptions): Promise<void>;
     private setupRailway;
     private setupCloudflare;
-    private setupGitHubSecrets;
+    private setupGitHubConfig;
 }
 
 export { DeployCommand as default };

package/dist/src/commands/deploy.js

@@ -5,12 +5,36 @@ import {
 
 // src/commands/deploy.ts
 init_esm_shims();
-import { BaseCommand, runCommand } from "@nexical/cli-core";
+import { BaseCommand } from "@nexical/cli-core";
 import { exec } from "child_process";
 import { promisify } from "util";
+import path from "path";
 var execAsync = promisify(exec);
 var DeployCommand = class extends BaseCommand {
-  static description = "Deploy the application to Railway and Cloudflare.";
+  static description = `Deploy the application to Railway and Cloudflare.
+
+ENVIRONMENT SETUP & PREREQUISITES:
+1. Install Required CLIs:
+   - Railway CLI: npm i -g @railway/cli
+   - Wrangler (Cloudflare): npm i -g wrangler
+   - GitHub CLI: https://cli.github.com/
+
+2. Authentication:
+   - Railway: Run 'railway login'
+   - GitHub: Run 'gh auth login'
+   - Cloudflare: Obtain an API Token (with Pages edit permissions) and your Account ID from the dashboard.
+
+3. Configuration:
+   Run this command with --cloudflare-token and --cloudflare-account to automate the full setup.
+   Optional: Use --railway-token if you prefer not to use the interactive login.
+   Optional: Use --railway-name to specify a custom Railway project name.
+   Optional: Use --backend-name to specify the Railway service name (default: nexical-backend).
+   Optional: Use --frontend-name to specify the Cloudflare Pages project name (default: nexical-frontend).
+
+PROCESS:
+- Provisions a PostgreSQL database on Railway (if missing).
+- Creates a Cloudflare Pages project for the frontend.
+- Syncs all necessary deployment secrets and variables to GitHub for CI/CD automation.`;
   static args = {
     options: [
       {
@@ -22,6 +46,20 @@ var DeployCommand = class extends BaseCommand {
         name: "--railway-token <token>",
         description: "Railway Project Token (optional if already logged in)."
       },
+      {
+        name: "--railway-name <name>",
+        description: "Railway Project Name (used during initialization)."
+      },
+      {
+        name: "--backend-name <name>",
+        description: "Backend service name on Railway.",
+        default: "nexical-backend"
+      },
+      {
+        name: "--frontend-name <name>",
+        description: "Frontend project name on Cloudflare.",
+        default: "nexical-frontend"
+      },
       {
         name: "--cloudflare-token <token>",
         description: "Cloudflare API Token."
@@ -40,7 +78,7 @@ var DeployCommand = class extends BaseCommand {
     try {
       await this.setupRailway(options);
       await this.setupCloudflare(options);
-      await this.setupGitHubSecrets(options);
+      await this.setupGitHubConfig(options);
       this.success("Deployment setup complete! Your application is being deployed.");
     } catch (error) {
       if (error instanceof Error) {
@@ -54,25 +92,25 @@ var DeployCommand = class extends BaseCommand {
   async setupRailway(options) {
     this.info("Configuring Railway...");
     if (options.dryRun) {
-      this.info("[Dry Run] Would run: railway init");
+      const initCmd = options.railwayName ? `railway init --name ${options.railwayName}` : "railway init";
+      this.info(`[Dry Run] Would run: ${initCmd}`);
       this.info("[Dry Run] Would run: railway add --database postgres");
       return;
     }
     try {
       this.info("Ensuring Railway project is linked...");
-      if (options.railwayToken) {
-        process.env.RAILWAY_TOKEN = options.railwayToken;
-      }
+      const backendDir = path.join(process.cwd(), "apps/backend");
       try {
-        await runCommand("railway status");
+        await execAsync("railway status", { cwd: backendDir });
       } catch {
-        this.info("No Railway project detected. Initializing...");
-        await runCommand("railway init");
+        const initCmd = options.railwayName ? `railway init --name ${options.railwayName}` : "railway init";
+        this.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);
+        await execAsync(initCmd, { cwd: backendDir });
       }
-      this.info("Adding PostgreSQL service if missing...");
-      const { stdout: status } = await execAsync("railway status");
+      this.info(`Adding PostgreSQL service if missing for "${options.backendName}"...`);
+      const { stdout: status } = await execAsync("railway status", { cwd: backendDir });
       if (!status.includes("postgres")) {
-        await runCommand("railway add --database postgres");
+        await execAsync("railway add --database postgres", { cwd: backendDir });
       }
     } catch (e) {
       this.warn(
@@ -84,7 +122,7 @@ var DeployCommand = class extends BaseCommand {
   async setupCloudflare(options) {
     this.info("Configuring Cloudflare Pages...");
     if (options.dryRun) {
-      this.info("[Dry Run] Would run: wrangler pages project create nexical-frontend");
+      this.info(`[Dry Run] Would run: wrangler pages project create ${options.frontendName}`);
       return;
     }
     if (!options.cloudflareToken || !options.cloudflareAccount) {
@@ -93,7 +131,7 @@ var DeployCommand = class extends BaseCommand {
       return;
     }
     try {
-      const projectName = "nexical-frontend";
+      const projectName = options.frontendName;
       this.info(`Ensuring Cloudflare Pages project "${projectName}" exists...`);
       try {
         await execAsync(`wrangler pages project create ${projectName} --production-branch main`, {
@@ -111,32 +149,42 @@ var DeployCommand = class extends BaseCommand {
       throw e;
     }
   }
-  async setupGitHubSecrets(options) {
-    this.info("Configuring GitHub Secrets...");
+  async setupGitHubConfig(options) {
+    this.info("Configuring GitHub Secrets and Variables...");
     if (options.dryRun) {
       this.info("[Dry Run] Would run: gh secret set RAILWAY_TOKEN");
       this.info("[Dry Run] Would run: gh secret set CLOUDFLARE_API_TOKEN");
       this.info("[Dry Run] Would run: gh secret set CLOUDFLARE_ACCOUNT_ID");
+      this.info(
+        `[Dry Run] Would run: gh variable set RAILWAY_SERVICE_NAME --body "${options.backendName}"`
+      );
+      this.info(
+        `[Dry Run] Would run: gh variable set CLOUDFLARE_PROJECT_NAME --body "${options.frontendName}"`
+      );
       return;
     }
     try {
       if (options.railwayToken) {
         this.info("Setting RAILWAY_TOKEN in GitHub...");
-        await runCommand(`gh secret set RAILWAY_TOKEN --body "${options.railwayToken}"`);
+        await execAsync(`gh secret set RAILWAY_TOKEN --body "${options.railwayToken}"`);
       }
       if (options.cloudflareToken) {
         this.info("Setting CLOUDFLARE_API_TOKEN in GitHub...");
-        await runCommand(`gh secret set CLOUDFLARE_API_TOKEN --body "${options.cloudflareToken}"`);
+        await execAsync(`gh secret set CLOUDFLARE_API_TOKEN --body "${options.cloudflareToken}"`);
       }
       if (options.cloudflareAccount) {
         this.info("Setting CLOUDFLARE_ACCOUNT_ID in GitHub...");
-        await runCommand(
+        await execAsync(
           `gh secret set CLOUDFLARE_ACCOUNT_ID --body "${options.cloudflareAccount}"`
         );
       }
+      this.info(`Setting RAILWAY_SERVICE_NAME to "${options.backendName}" in GitHub...`);
+      await execAsync(`gh variable set RAILWAY_SERVICE_NAME --body "${options.backendName}"`);
+      this.info(`Setting CLOUDFLARE_PROJECT_NAME to "${options.frontendName}" in GitHub...`);
+      await execAsync(`gh variable set CLOUDFLARE_PROJECT_NAME --body "${options.frontendName}"`);
     } catch (e) {
       this.warn(
-        "GitHub Secrets setup failed. Ensure you have the GitHub CLI (gh) installed and are logged in."
+        "GitHub configuration failed. Ensure you have the GitHub CLI (gh) installed and are logged in."
       );
       throw e;
     }

package/dist/src/commands/deploy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/deploy.ts"],"sourcesContent":["import { BaseCommand, runCommand } from '@nexical/cli-core';\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\n\nconst execAsync = promisify(exec);\n\ninterface DeployOptions {\n  dryRun: boolean;\n  railwayToken?: string;\n  cloudflareToken?: string;\n  cloudflareAccount?: string;\n}\n\nexport default class DeployCommand extends BaseCommand {\n  static description = 'Deploy the application to Railway and Cloudflare.';\n\n  static args = {\n    options: [\n      {\n        name: '--dry-run',\n        description: 'Simulate the deployment process without making changes.',\n        default: false,\n      },\n      {\n        name: '--railway-token <token>',\n        description: 'Railway Project Token (optional if already logged in).',\n      },\n      {\n        name: '--cloudflare-token <token>',\n        description: 'Cloudflare API Token.',\n      },\n      {\n        name: '--cloudflare-account <id>',\n        description: 'Cloudflare Account ID.',\n      },\n    ],\n  };\n\n  async run(options: DeployOptions) {\n    this.info('Starting Nexical Deployment Automation...');\n\n    if (options.dryRun) {\n      this.notice('DRY RUN MODE ENABLED');\n    }\n\n    try {\n      // 1. Railway Setup\n      await this.setupRailway(options);\n\n      // 2. Cloudflare Setup\n      await this.setupCloudflare(options);\n\n      // 3. GitHub Secrets Setup\n      await this.setupGitHubSecrets(options);\n\n      this.success('Deployment setup complete! Your application is being deployed.');\n    } catch (error: unknown) {\n      if (error instanceof Error) {\n        this.error(`Deployment failed: ${error.message}`);\n      } else {\n        this.error(`Deployment failed: ${String(error)}`);\n      }\n      process.exit(1);\n    }\n  }\n\n  private async setupRailway(options: DeployOptions) {\n    this.info('Configuring Railway...');\n\n    if (options.dryRun) {\n      this.info('[Dry Run] Would run: railway init');\n      this.info('[Dry Run] Would run: railway add --database postgres');\n      return;\n    }\n\n    try {\n      // Check if railway project exists or init\n      // Note: railway init might be interactive, so we might need to handle that or assume user has linked.\n      // For now, let's assume we use 'railway link' if they passed a token or have it set.\n\n      this.info('Ensuring Railway project is linked...');\n      // If they provided a token, we should probably set it in the environment for subsequent calls\n      if (options.railwayToken) {\n        process.env.RAILWAY_TOKEN = options.railwayToken;\n      }\n\n      // Check if we are in a railway project\n      try {\n        await runCommand('railway status');\n      } catch {\n        this.info('No Railway project detected. Initializing...');\n        await runCommand('railway init');\n      }\n\n      this.info('Adding PostgreSQL service if missing...');\n      // railway add --database postgres is usually safe to run twice but we should check status\n      const { stdout: status } = await execAsync('railway status');\n      if (!status.includes('postgres')) {\n        await runCommand('railway add --database postgres');\n      }\n    } catch (e: unknown) {\n      this.warn(\n        'Railway setup encountered an issue. Ensure you are logged in with `railway login`.',\n      );\n      throw e;\n    }\n  }\n\n  private async setupCloudflare(options: DeployOptions) {\n    this.info('Configuring Cloudflare Pages...');\n\n    if (options.dryRun) {\n      this.info('[Dry Run] Would run: wrangler pages project create nexical-frontend');\n      return;\n    }\n\n    if (!options.cloudflareToken || !options.cloudflareAccount) {\n      this.warn('Cloudflare credentials missing. Skipping automated Cloudflare setup.');\n      this.info('You can manually set up Cloudflare Pages and add the secrets to GitHub.');\n      return;\n    }\n\n    try {\n      // Use wrangler to create project if it doesn't exist\n      // We assume project name 'nexical-frontend' for now, should be configurable.\n      const projectName = 'nexical-frontend';\n      this.info(`Ensuring Cloudflare Pages project \"${projectName}\" exists...`);\n\n      try {\n        await execAsync(`wrangler pages project create ${projectName} --production-branch main`, {\n          env: {\n            ...process.env,\n            CLOUDFLARE_API_TOKEN: options.cloudflareToken,\n            CLOUDFLARE_ACCOUNT_ID: options.cloudflareAccount,\n          },\n        });\n      } catch {\n        this.info('Cloudflare project might already exist.');\n      }\n    } catch (e: unknown) {\n      this.warn('Cloudflare setup failed.');\n      throw e;\n    }\n  }\n\n  private async setupGitHubSecrets(options: DeployOptions) {\n    this.info('Configuring GitHub Secrets...');\n\n    if (options.dryRun) {\n      this.info('[Dry Run] Would run: gh secret set RAILWAY_TOKEN');\n      this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_API_TOKEN');\n      this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_ACCOUNT_ID');\n      return;\n    }\n\n    try {\n      // We need the Railway Project Token.\n      // User might have provided it, or we try to get it from railway tokens?\n      // Railway CLI doesn't easily expose the project token via CLI easily without a lot of parsing.\n      // Usually users generate it in the UI.\n      // If they provided it via --railway-token, we use it.\n\n      if (options.railwayToken) {\n        this.info('Setting RAILWAY_TOKEN in GitHub...');\n        await runCommand(`gh secret set RAILWAY_TOKEN --body \"${options.railwayToken}\"`);\n      }\n\n      if (options.cloudflareToken) {\n        this.info('Setting CLOUDFLARE_API_TOKEN in GitHub...');\n        await runCommand(`gh secret set CLOUDFLARE_API_TOKEN --body \"${options.cloudflareToken}\"`);\n      }\n\n      if (options.cloudflareAccount) {\n        this.info('Setting CLOUDFLARE_ACCOUNT_ID in GitHub...');\n        await runCommand(\n          `gh secret set CLOUDFLARE_ACCOUNT_ID --body \"${options.cloudflareAccount}\"`,\n        );\n      }\n    } catch (e: unknown) {\n      this.warn(\n        'GitHub Secrets setup failed. Ensure you have the GitHub CLI (gh) installed and are logged in.',\n      );\n      throw e;\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/commands/deploy.ts"],"sourcesContent":["import { BaseCommand } from '@nexical/cli-core';\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport path from 'node:path';\n\nconst execAsync = promisify(exec);\n\ninterface DeployOptions {\n  dryRun: boolean;\n  railwayToken?: string;\n  railwayName?: string;\n  backendName: string;\n  frontendName: string;\n  cloudflareToken?: string;\n  cloudflareAccount?: string;\n}\n\nexport default class DeployCommand extends BaseCommand {\n  static description = `Deploy the application to Railway and Cloudflare.\n\nENVIRONMENT SETUP & PREREQUISITES:\n1. Install Required CLIs:\n   - Railway CLI: npm i -g @railway/cli\n   - Wrangler (Cloudflare): npm i -g wrangler\n   - GitHub CLI: https://cli.github.com/\n\n2. Authentication:\n   - Railway: Run 'railway login'\n   - GitHub: Run 'gh auth login'\n   - Cloudflare: Obtain an API Token (with Pages edit permissions) and your Account ID from the dashboard.\n\n3. Configuration:\n   Run this command with --cloudflare-token and --cloudflare-account to automate the full setup.\n   Optional: Use --railway-token if you prefer not to use the interactive login.\n   Optional: Use --railway-name to specify a custom Railway project name.\n   Optional: Use --backend-name to specify the Railway service name (default: nexical-backend).\n   Optional: Use --frontend-name to specify the Cloudflare Pages project name (default: nexical-frontend).\n\nPROCESS:\n- Provisions a PostgreSQL database on Railway (if missing).\n- Creates a Cloudflare Pages project for the frontend.\n- Syncs all necessary deployment secrets and variables to GitHub for CI/CD automation.`;\n\n  static args = {\n    options: [\n      {\n        name: '--dry-run',\n        description: 'Simulate the deployment process without making changes.',\n        default: false,\n      },\n      {\n        name: '--railway-token <token>',\n        description: 'Railway Project Token (optional if already logged in).',\n      },\n      {\n        name: '--railway-name <name>',\n        description: 'Railway Project Name (used during initialization).',\n      },\n      {\n        name: '--backend-name <name>',\n        description: 'Backend service name on Railway.',\n        default: 'nexical-backend',\n      },\n      {\n        name: '--frontend-name <name>',\n        description: 'Frontend project name on Cloudflare.',\n        default: 'nexical-frontend',\n      },\n      {\n        name: '--cloudflare-token <token>',\n        description: 'Cloudflare API Token.',\n      },\n      {\n        name: '--cloudflare-account <id>',\n        description: 'Cloudflare Account ID.',\n      },\n    ],\n  };\n\n  async run(options: DeployOptions) {\n    this.info('Starting Nexical Deployment Automation...');\n\n    if (options.dryRun) {\n      this.notice('DRY RUN MODE ENABLED');\n    }\n\n    try {\n      // 1. Railway Setup\n      await this.setupRailway(options);\n\n      // 2. Cloudflare Setup\n      await this.setupCloudflare(options);\n\n      // 3. GitHub Configuration (Secrets & Variables)\n      await this.setupGitHubConfig(options);\n\n      this.success('Deployment setup complete! Your application is being deployed.');\n    } catch (error: unknown) {\n      if (error instanceof Error) {\n        this.error(`Deployment failed: ${error.message}`);\n      } else {\n        this.error(`Deployment failed: ${String(error)}`);\n      }\n      process.exit(1);\n    }\n  }\n\n  private async setupRailway(options: DeployOptions) {\n    this.info('Configuring Railway...');\n\n    if (options.dryRun) {\n      const initCmd = options.railwayName\n        ? `railway init --name ${options.railwayName}`\n        : 'railway init';\n      this.info(`[Dry Run] Would run: ${initCmd}`);\n      this.info('[Dry Run] Would run: railway add --database postgres');\n      return;\n    }\n\n    try {\n      // Check if railway project exists or init\n      // Note: railway init might be interactive, so we might need to handle that or assume user has linked.\n      // For now, let's assume we use 'railway link' if they passed a token or have it set.\n\n      this.info('Ensuring Railway project is linked...');\n      // Note: We intentionally DO NOT set process.env.RAILWAY_TOKEN here.\n      // Management commands (init, status, add) require an interactive session (railway login).\n      // The provided --railway-token is reserved for GitHub Secrets setup (CI/CD).\n\n      const backendDir = path.join(process.cwd(), 'apps/backend');\n\n      try {\n        await execAsync('railway status', { cwd: backendDir });\n      } catch {\n        const initCmd = options.railwayName\n          ? `railway init --name ${options.railwayName}`\n          : 'railway init';\n        this.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);\n        await execAsync(initCmd, { cwd: backendDir });\n      }\n\n      this.info(`Adding PostgreSQL service if missing for \"${options.backendName}\"...`);\n      const { stdout: status } = await execAsync('railway status', { cwd: backendDir });\n      if (!status.includes('postgres')) {\n        await execAsync('railway add --database postgres', { cwd: backendDir });\n      }\n    } catch (e: unknown) {\n      this.warn(\n        'Railway setup encountered an issue. Ensure you are logged in with `railway login`.',\n      );\n      throw e;\n    }\n  }\n\n  private async setupCloudflare(options: DeployOptions) {\n    this.info('Configuring Cloudflare Pages...');\n\n    if (options.dryRun) {\n      this.info(`[Dry Run] Would run: wrangler pages project create ${options.frontendName}`);\n      return;\n    }\n\n    if (!options.cloudflareToken || !options.cloudflareAccount) {\n      this.warn('Cloudflare credentials missing. Skipping automated Cloudflare setup.');\n      this.info('You can manually set up Cloudflare Pages and add the secrets to GitHub.');\n      return;\n    }\n\n    try {\n      // Use wrangler to create project if it doesn't exist\n      const projectName = options.frontendName;\n      this.info(`Ensuring Cloudflare Pages project \"${projectName}\" exists...`);\n\n      try {\n        await execAsync(`wrangler pages project create ${projectName} --production-branch main`, {\n          env: {\n            ...process.env,\n            CLOUDFLARE_API_TOKEN: options.cloudflareToken,\n            CLOUDFLARE_ACCOUNT_ID: options.cloudflareAccount,\n          },\n        });\n      } catch {\n        this.info('Cloudflare project might already exist.');\n      }\n    } catch (e: unknown) {\n      this.warn('Cloudflare setup failed.');\n      throw e;\n    }\n  }\n\n  private async setupGitHubConfig(options: DeployOptions) {\n    this.info('Configuring GitHub Secrets and Variables...');\n\n    if (options.dryRun) {\n      this.info('[Dry Run] Would run: gh secret set RAILWAY_TOKEN');\n      this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_API_TOKEN');\n      this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_ACCOUNT_ID');\n      this.info(\n        `[Dry Run] Would run: gh variable set RAILWAY_SERVICE_NAME --body \"${options.backendName}\"`,\n      );\n      this.info(\n        `[Dry Run] Would run: gh variable set CLOUDFLARE_PROJECT_NAME --body \"${options.frontendName}\"`,\n      );\n      return;\n    }\n\n    try {\n      if (options.railwayToken) {\n        this.info('Setting RAILWAY_TOKEN in GitHub...');\n        await execAsync(`gh secret set RAILWAY_TOKEN --body \"${options.railwayToken}\"`);\n      }\n\n      if (options.cloudflareToken) {\n        this.info('Setting CLOUDFLARE_API_TOKEN in GitHub...');\n        await execAsync(`gh secret set CLOUDFLARE_API_TOKEN --body \"${options.cloudflareToken}\"`);\n      }\n\n      if (options.cloudflareAccount) {\n        this.info('Setting CLOUDFLARE_ACCOUNT_ID in GitHub...');\n        await execAsync(\n          `gh secret set CLOUDFLARE_ACCOUNT_ID --body \"${options.cloudflareAccount}\"`,\n        );\n      }\n\n      // Set variables\n      this.info(`Setting RAILWAY_SERVICE_NAME to \"${options.backendName}\" in GitHub...`);\n      await execAsync(`gh variable set RAILWAY_SERVICE_NAME --body \"${options.backendName}\"`);\n\n      this.info(`Setting CLOUDFLARE_PROJECT_NAME to \"${options.frontendName}\" in GitHub...`);\n      await execAsync(`gh variable set CLOUDFLARE_PROJECT_NAME --body \"${options.frontendName}\"`);\n    } catch (e: unknown) {\n      this.warn(\n        'GitHub configuration failed. Ensure you have the GitHub CLI (gh) installed and are logged in.',\n      );\n      throw e;\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexical/cli",
-  "version": "0.11.3",
+  "version": "0.11.4",
   "type": "module",
   "bin": {
     "nexical": "./dist/index.js"

package/src/commands/deploy.ts

@@ -1,18 +1,45 @@
-import { BaseCommand, runCommand } from '@nexical/cli-core';
+import { BaseCommand } from '@nexical/cli-core';
 import { exec } from 'node:child_process';
 import { promisify } from 'node:util';
+import path from 'node:path';
 
 const execAsync = promisify(exec);
 
 interface DeployOptions {
   dryRun: boolean;
   railwayToken?: string;
+  railwayName?: string;
+  backendName: string;
+  frontendName: string;
   cloudflareToken?: string;
   cloudflareAccount?: string;
 }
 
 export default class DeployCommand extends BaseCommand {
-  static description = 'Deploy the application to Railway and Cloudflare.';
+  static description = `Deploy the application to Railway and Cloudflare.
+
+ENVIRONMENT SETUP & PREREQUISITES:
+1. Install Required CLIs:
+   - Railway CLI: npm i -g @railway/cli
+   - Wrangler (Cloudflare): npm i -g wrangler
+   - GitHub CLI: https://cli.github.com/
+
+2. Authentication:
+   - Railway: Run 'railway login'
+   - GitHub: Run 'gh auth login'
+   - Cloudflare: Obtain an API Token (with Pages edit permissions) and your Account ID from the dashboard.
+
+3. Configuration:
+   Run this command with --cloudflare-token and --cloudflare-account to automate the full setup.
+   Optional: Use --railway-token if you prefer not to use the interactive login.
+   Optional: Use --railway-name to specify a custom Railway project name.
+   Optional: Use --backend-name to specify the Railway service name (default: nexical-backend).
+   Optional: Use --frontend-name to specify the Cloudflare Pages project name (default: nexical-frontend).
+
+PROCESS:
+- Provisions a PostgreSQL database on Railway (if missing).
+- Creates a Cloudflare Pages project for the frontend.
+- Syncs all necessary deployment secrets and variables to GitHub for CI/CD automation.`;
 
   static args = {
     options: [
@@ -25,6 +52,20 @@ export default class DeployCommand extends BaseCommand {
         name: '--railway-token <token>',
         description: 'Railway Project Token (optional if already logged in).',
       },
+      {
+        name: '--railway-name <name>',
+        description: 'Railway Project Name (used during initialization).',
+      },
+      {
+        name: '--backend-name <name>',
+        description: 'Backend service name on Railway.',
+        default: 'nexical-backend',
+      },
+      {
+        name: '--frontend-name <name>',
+        description: 'Frontend project name on Cloudflare.',
+        default: 'nexical-frontend',
+      },
       {
         name: '--cloudflare-token <token>',
         description: 'Cloudflare API Token.',
@@ -50,8 +91,8 @@ export default class DeployCommand extends BaseCommand {
       // 2. Cloudflare Setup
       await this.setupCloudflare(options);
 
-      // 3. GitHub Secrets Setup
-      await this.setupGitHubSecrets(options);
+      // 3. GitHub Configuration (Secrets & Variables)
+      await this.setupGitHubConfig(options);
 
       this.success('Deployment setup complete! Your application is being deployed.');
     } catch (error: unknown) {
@@ -68,7 +109,10 @@ export default class DeployCommand extends BaseCommand {
     this.info('Configuring Railway...');
 
     if (options.dryRun) {
-      this.info('[Dry Run] Would run: railway init');
+      const initCmd = options.railwayName
+        ? `railway init --name ${options.railwayName}`
+        : 'railway init';
+      this.info(`[Dry Run] Would run: ${initCmd}`);
       this.info('[Dry Run] Would run: railway add --database postgres');
       return;
     }
@@ -79,24 +123,26 @@ export default class DeployCommand extends BaseCommand {
       // For now, let's assume we use 'railway link' if they passed a token or have it set.
 
       this.info('Ensuring Railway project is linked...');
-      // If they provided a token, we should probably set it in the environment for subsequent calls
-      if (options.railwayToken) {
-        process.env.RAILWAY_TOKEN = options.railwayToken;
-      }
+      // Note: We intentionally DO NOT set process.env.RAILWAY_TOKEN here.
+      // Management commands (init, status, add) require an interactive session (railway login).
+      // The provided --railway-token is reserved for GitHub Secrets setup (CI/CD).
+
+      const backendDir = path.join(process.cwd(), 'apps/backend');
 
-      // Check if we are in a railway project
       try {
-        await runCommand('railway status');
+        await execAsync('railway status', { cwd: backendDir });
       } catch {
-        this.info('No Railway project detected. Initializing...');
-        await runCommand('railway init');
+        const initCmd = options.railwayName
+          ? `railway init --name ${options.railwayName}`
+          : 'railway init';
+        this.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);
+        await execAsync(initCmd, { cwd: backendDir });
       }
 
-      this.info('Adding PostgreSQL service if missing...');
-      // railway add --database postgres is usually safe to run twice but we should check status
-      const { stdout: status } = await execAsync('railway status');
+      this.info(`Adding PostgreSQL service if missing for "${options.backendName}"...`);
+      const { stdout: status } = await execAsync('railway status', { cwd: backendDir });
       if (!status.includes('postgres')) {
-        await runCommand('railway add --database postgres');
+        await execAsync('railway add --database postgres', { cwd: backendDir });
       }
     } catch (e: unknown) {
       this.warn(
@@ -110,7 +156,7 @@ export default class DeployCommand extends BaseCommand {
     this.info('Configuring Cloudflare Pages...');
 
     if (options.dryRun) {
-      this.info('[Dry Run] Would run: wrangler pages project create nexical-frontend');
+      this.info(`[Dry Run] Would run: wrangler pages project create ${options.frontendName}`);
       return;
     }
 
@@ -122,8 +168,7 @@ export default class DeployCommand extends BaseCommand {
 
     try {
       // Use wrangler to create project if it doesn't exist
-      // We assume project name 'nexical-frontend' for now, should be configurable.
-      const projectName = 'nexical-frontend';
+      const projectName = options.frontendName;
       this.info(`Ensuring Cloudflare Pages project "${projectName}" exists...`);
 
       try {
@@ -143,42 +188,49 @@ export default class DeployCommand extends BaseCommand {
     }
   }
 
-  private async setupGitHubSecrets(options: DeployOptions) {
-    this.info('Configuring GitHub Secrets...');
+  private async setupGitHubConfig(options: DeployOptions) {
+    this.info('Configuring GitHub Secrets and Variables...');
 
     if (options.dryRun) {
       this.info('[Dry Run] Would run: gh secret set RAILWAY_TOKEN');
       this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_API_TOKEN');
       this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_ACCOUNT_ID');
+      this.info(
+        `[Dry Run] Would run: gh variable set RAILWAY_SERVICE_NAME --body "${options.backendName}"`,
+      );
+      this.info(
+        `[Dry Run] Would run: gh variable set CLOUDFLARE_PROJECT_NAME --body "${options.frontendName}"`,
+      );
       return;
     }
 
     try {
-      // We need the Railway Project Token.
-      // User might have provided it, or we try to get it from railway tokens?
-      // Railway CLI doesn't easily expose the project token via CLI easily without a lot of parsing.
-      // Usually users generate it in the UI.
-      // If they provided it via --railway-token, we use it.
-
       if (options.railwayToken) {
         this.info('Setting RAILWAY_TOKEN in GitHub...');
-        await runCommand(`gh secret set RAILWAY_TOKEN --body "${options.railwayToken}"`);
+        await execAsync(`gh secret set RAILWAY_TOKEN --body "${options.railwayToken}"`);
       }
 
       if (options.cloudflareToken) {
         this.info('Setting CLOUDFLARE_API_TOKEN in GitHub...');
-        await runCommand(`gh secret set CLOUDFLARE_API_TOKEN --body "${options.cloudflareToken}"`);
+        await execAsync(`gh secret set CLOUDFLARE_API_TOKEN --body "${options.cloudflareToken}"`);
       }
 
       if (options.cloudflareAccount) {
         this.info('Setting CLOUDFLARE_ACCOUNT_ID in GitHub...');
-        await runCommand(
+        await execAsync(
           `gh secret set CLOUDFLARE_ACCOUNT_ID --body "${options.cloudflareAccount}"`,
         );
       }
+
+      // Set variables
+      this.info(`Setting RAILWAY_SERVICE_NAME to "${options.backendName}" in GitHub...`);
+      await execAsync(`gh variable set RAILWAY_SERVICE_NAME --body "${options.backendName}"`);
+
+      this.info(`Setting CLOUDFLARE_PROJECT_NAME to "${options.frontendName}" in GitHub...`);
+      await execAsync(`gh variable set CLOUDFLARE_PROJECT_NAME --body "${options.frontendName}"`);
     } catch (e: unknown) {
       this.warn(
-        'GitHub Secrets setup failed. Ensure you have the GitHub CLI (gh) installed and are logged in.',
+        'GitHub configuration failed. Ensure you have the GitHub CLI (gh) installed and are logged in.',
       );
       throw e;
     }