webspresso 0.0.104 → 0.0.106

package/bin/commands/add-cloudflare.js

@@ -0,0 +1,240 @@
+/**
+ * Add Cloudflare Command
+ * Generate production-ready wrangler.toml and worker.js for Cloudflare Workers / Pages
+ * @module bin/commands/add-cloudflare
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Generate wrangler.toml content
+ * @param {Object} options
+ * @param {string} options.appName
+ * @param {boolean} [options.d1=true]
+ * @param {boolean} [options.kv=false]
+ * @param {boolean} [options.queue=false]
+ * @param {boolean} [options.assets=true]
+ * @returns {string}
+ */
+function generateWranglerToml({ appName, d1 = true, kv = false, queue = false, assets = true }) {
+  const lines = [
+    `# Cloudflare Workers configuration for Webspresso`,
+    `name = "${appName}"`,
+    `main = "worker.js"`,
+    `compatibility_date = "2024-09-23"`,
+    `compatibility_flags = ["nodejs_compat"]`,
+    ``,
+  ];
+
+  if (assets) {
+    lines.push(
+      `# Static asset serving via Workers Assets / Pages`,
+      `[assets]`,
+      `directory = "./public"`,
+      `binding = "ASSETS"`,
+      ``
+    );
+  }
+
+  if (d1) {
+    lines.push(
+      `# Cloudflare D1 Serverless SQL Database`,
+      `[[d1_databases]]`,
+      `binding = "DB"`,
+      `database_name = "${appName}-db"`,
+      `database_id = "YOUR_D1_DATABASE_ID_HERE"`,
+      `migrations_dir = "./migrations"`,
+      ``
+    );
+  }
+
+  if (kv) {
+    lines.push(
+      `# Cloudflare KV for fast distributed session storage`,
+      `[[kv_namespaces]]`,
+      `binding = "SESSIONS"`,
+      `id = "YOUR_KV_NAMESPACE_ID_HERE"`,
+      ``
+    );
+  }
+
+  if (queue) {
+    lines.push(
+      `# Cloudflare Queues for guaranteed background jobs`,
+      `[[queues.producers]]`,
+      `binding = "QUEUE"`,
+      `queue = "${appName}-queue"`,
+      ``,
+      `[[queues.consumers]]`,
+      `queue = "${appName}-queue"`,
+      `max_batch_size = 10`,
+      `max_batch_timeout = 5`,
+      ``
+    );
+  }
+
+  lines.push(
+    `[observability]`,
+    `enabled = true`,
+    ``
+  );
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate worker.js edge bridge entry point
+ * @param {Object} options
+ * @param {boolean} [options.d1=true]
+ * @param {boolean} [options.queue=false]
+ * @returns {string}
+ */
+function generateWorkerJs({ d1 = true, queue = false }) {
+  const d1Snippet = d1
+    ? `    // Connect Cloudflare D1 to Webspresso ORM if binding is available
+    let db;
+    if (env.DB) {
+      db = createDatabase({ client: 'd1', d1: env.DB });
+    }
+`
+    : '';
+
+  const queueConsumer = queue
+    ? `
+  /**
+   * Process background jobs from Cloudflare Queues
+   */
+  async queue(batch, env, ctx) {
+    if (app.queue && typeof app.queue.processBatch === 'function') {
+      await app.queue.processBatch(batch);
+    }
+  },`
+    : '';
+
+  return `/**
+ * Cloudflare Workers Edge Entry Point for Webspresso
+ * Generated via \`npx webspresso add:cloudflare\`
+ */
+
+import { createApp${d1 ? ', createDatabase' : ''} } from 'webspresso';
+
+// Initialize Webspresso app with high-performance Hono Edge adapter
+const app = createApp({
+  adapter: 'hono',
+});
+
+export default {
+  /**
+   * Handle incoming HTTP requests
+   */
+  async fetch(request, env, ctx) {
+${d1Snippet}    return app.handle(request, {
+      env,
+      ctx,${d1 ? '\n      db,' : ''}
+      waitUntil: (promise) => ctx.waitUntil(promise),
+    });
+  },${queueConsumer}
+};
+`;
+}
+
+/**
+ * Register command with Commander
+ * @param {import('commander').Command} program
+ */
+function registerCommand(program) {
+  program
+    .command('add:cloudflare')
+    .alias('cloudflare')
+    .alias('add-cloudflare')
+    .description('Generate production-ready wrangler.toml and worker.js for Cloudflare Workers')
+    .option('--no-d1', 'Do not configure Cloudflare D1 database binding')
+    .option('--kv', 'Configure Cloudflare KV for session storage', false)
+    .option('--queue', 'Configure Cloudflare Queues for background tasks', false)
+    .option('-f, --force', 'Overwrite existing files without prompting', false)
+    .action(async (...actionArgs) => {
+      const cmd = actionArgs[actionArgs.length - 1];
+      const options = (cmd && typeof cmd.opts === 'function')
+        ? cmd.opts()
+        : (actionArgs.find((a) => a && typeof a === 'object') || {});
+
+      const cwd = process.cwd();
+      const pkgPath = path.join(cwd, 'package.json');
+
+      if (!fs.existsSync(pkgPath)) {
+        console.error('❌ Not a Webspresso project! package.json was not found in current directory.');
+        process.exit(1);
+      }
+
+      let pkg = {};
+      try {
+        pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+      } catch (err) {
+        console.error(`❌ Failed to parse package.json: ${err.message}`);
+        process.exit(1);
+      }
+
+      const appName = pkg.name ? pkg.name.replace(/[^a-zA-Z0-9_-]/g, '-') : 'webspresso-app';
+      const force = Boolean(options.force);
+      const d1 = options.d1 !== false;
+      const kv = Boolean(options.kv);
+      const queue = Boolean(options.queue);
+
+      const wranglerPath = path.join(cwd, 'wrangler.toml');
+      const workerPath = path.join(cwd, 'worker.js');
+
+      console.log(`\n☁️  Scaffolding Cloudflare Workers configuration for "${appName}"...`);
+
+      // 1. wrangler.toml
+      if (fs.existsSync(wranglerPath) && !force) {
+        console.log(`⚠️  ${path.basename(wranglerPath)} already exists. Skipping (use --force to overwrite).`);
+      } else {
+        const tomlContent = generateWranglerToml({ appName, d1, kv, queue, assets: true });
+        fs.writeFileSync(wranglerPath, tomlContent, 'utf8');
+        console.log(`✅ Created ${path.basename(wranglerPath)}`);
+      }
+
+      // 2. worker.js
+      if (fs.existsSync(workerPath) && !force) {
+        console.log(`⚠️  ${path.basename(workerPath)} already exists. Skipping (use --force to overwrite).`);
+      } else {
+        const workerContent = generateWorkerJs({ d1, queue });
+        fs.writeFileSync(workerPath, workerContent, 'utf8');
+        console.log(`✅ Created ${path.basename(workerPath)}`);
+      }
+
+      // 3. Update package.json scripts
+      let modifiedPkg = false;
+      if (!pkg.scripts) pkg.scripts = {};
+      if (!pkg.scripts['cf:dev']) {
+        pkg.scripts['cf:dev'] = 'wrangler dev';
+        modifiedPkg = true;
+      }
+      if (!pkg.scripts['cf:deploy']) {
+        pkg.scripts['cf:deploy'] = 'wrangler deploy';
+        modifiedPkg = true;
+      }
+
+      if (modifiedPkg) {
+        try {
+          fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+          console.log(`✅ Added "cf:dev" and "cf:deploy" scripts to package.json`);
+        } catch (_) {}
+      }
+
+      console.log('\n🎉 Cloudflare Workers setup complete!');
+      console.log('\nNext steps:');
+      console.log('  1. Run `npx wrangler dev` to test locally on Cloudflare Workerd isolate');
+      console.log('  2. Create your D1 database: `npx wrangler d1 create ' + appName + '-db`');
+      console.log('  3. Deploy to the edge: `npx wrangler deploy`\n');
+    });
+}
+
+module.exports = {
+  registerCommand,
+  generateWranglerToml,
+  generateWorkerJs,
+};

package/bin/commands/add-cloudrun.js

@@ -0,0 +1,381 @@
+/**
+ * Add Cloud Run Command
+ * Generate production-ready Google Cloud Run configuration (cloudbuild.yaml, .gcloudignore, deploy-cloudrun.sh)
+ * @module bin/commands/add-cloudrun
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { generateDockerfile, generateDockerignore } = require('./add-docker');
+
+/**
+ * Generate cloudbuild.yaml for Google Cloud Build CI/CD
+ * @param {Object} options
+ * @param {string} options.appName
+ * @param {string} [options.region='us-central1']
+ * @param {string} [options.memory='512Mi']
+ * @param {string} [options.cpu='1']
+ * @param {number} [options.port=8080]
+ * @param {number} [options.minInstances=0]
+ * @param {number} [options.maxInstances=10]
+ * @param {string} [options.cloudSql]
+ * @returns {string}
+ */
+function generateCloudBuildYaml(options = {}) {
+  const {
+    appName = 'webspresso-app',
+    region = 'us-central1',
+    memory = '512Mi',
+    cpu = '1',
+    port = 8080,
+    minInstances = 0,
+    maxInstances = 10,
+    cloudSql = '',
+  } = options;
+
+  const cloudSqlArgs = cloudSql
+    ? `\n      - '--add-cloudsql-instances'\n      - '${cloudSql}'`
+    : '';
+
+  return `# ==============================================================================
+# Google Cloud Build Pipeline for Webspresso
+# Builds hardened multi-stage Docker image and deploys to Google Cloud Run
+# ==============================================================================
+
+steps:
+  # 1. Build production container using multi-stage Dockerfile with cache
+  - name: 'gcr.io/cloud-builders/docker'
+    id: 'build-image'
+    args:
+      - 'build'
+      - '-t'
+      - '$_AR_LOCATION-docker.pkg.dev/$PROJECT_ID/$_AR_REPOSITORY/$_SERVICE_NAME:$COMMIT_SHA'
+      - '-t'
+      - '$_AR_LOCATION-docker.pkg.dev/$PROJECT_ID/$_AR_REPOSITORY/$_SERVICE_NAME:latest'
+      - '--cache-from'
+      - '$_AR_LOCATION-docker.pkg.dev/$PROJECT_ID/$_AR_REPOSITORY/$_SERVICE_NAME:latest'
+      - '.'
+
+  # 2. Push image to Google Artifact Registry
+  - name: 'gcr.io/cloud-builders/docker'
+    id: 'push-image'
+    args:
+      - 'push'
+      - '$_AR_LOCATION-docker.pkg.dev/$PROJECT_ID/$_AR_REPOSITORY/$_SERVICE_NAME:$COMMIT_SHA'
+
+  # 3. Deploy to Serverless Google Cloud Run
+  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
+    id: 'deploy-cloud-run'
+    entrypoint: gcloud
+    args:
+      - 'run'
+      - 'deploy'
+      - '$_SERVICE_NAME'
+      - '--image'
+      - '$_AR_LOCATION-docker.pkg.dev/$PROJECT_ID/$_AR_REPOSITORY/$_SERVICE_NAME:$COMMIT_SHA'
+      - '--region'
+      - '$_REGION'
+      - '--platform'
+      - 'managed'
+      - '--allow-unauthenticated'
+      - '--port'
+      - '$_PORT'
+      - '--memory'
+      - '$_MEMORY'
+      - '--cpu'
+      - '$_CPU'
+      - '--min-instances'
+      - '$_MIN_INSTANCES'
+      - '--max-instances'
+      - '$_MAX_INSTANCES'
+      - '--execution-environment'
+      - 'gen2'
+      - '--set-env-vars'
+      - 'NODE_ENV=production,PORT=$_PORT'${cloudSqlArgs}
+
+substitutions:
+  _SERVICE_NAME: '${appName}'
+  _REGION: '${region}'
+  _AR_LOCATION: '${region}'
+  _AR_REPOSITORY: 'webspresso'
+  _PORT: '${port}'
+  _MEMORY: '${memory}'
+  _CPU: '${cpu}'
+  _MIN_INSTANCES: '${minInstances}'
+  _MAX_INSTANCES: '${maxInstances}'
+
+images:
+  - '$_AR_LOCATION-docker.pkg.dev/$PROJECT_ID/$_AR_REPOSITORY/$_SERVICE_NAME:$COMMIT_SHA'
+  - '$_AR_LOCATION-docker.pkg.dev/$PROJECT_ID/$_AR_REPOSITORY/$_SERVICE_NAME:latest'
+
+options:
+  logging: CLOUD_LOGGING_ONLY
+`;
+}
+
+/**
+ * Generate .gcloudignore file content
+ * @returns {string}
+ */
+function generateGCloudIgnore() {
+  return `# ==============================================================================
+# Google Cloud Ignore for Webspresso
+# Prevents sensitive files and dev artifacts from uploading to Cloud Build
+# ==============================================================================
+
+.gcloudignore
+.git
+.gitignore
+.github
+
+# Dependencies and caches
+node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Environment & Secrets (Never upload secrets into container build context)
+.env
+.env.*
+!.env.example
+
+# Local SQLite databases (Ephemeral on Cloud Run)
+*.sqlite
+*.sqlite3
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+data/*.sqlite*
+
+# Test, coverage & documentation
+tests
+coverage
+playwright-report
+test-results
+docs
+.agents
+
+# IDE files
+.idea
+.vscode
+*.swp
+.DS_Store
+`;
+}
+
+/**
+ * Generate deploy-cloudrun.sh one-line deployment shell script
+ * @param {Object} options
+ * @param {string} options.appName
+ * @param {string} [options.region='us-central1']
+ * @param {string} [options.memory='512Mi']
+ * @param {string} [options.cpu='1']
+ * @param {number} [options.port=8080]
+ * @param {number} [options.minInstances=0]
+ * @param {number} [options.maxInstances=10]
+ * @param {string} [options.cloudSql]
+ * @returns {string}
+ */
+function generateDeployScript(options = {}) {
+  const {
+    appName = 'webspresso-app',
+    region = 'us-central1',
+    memory = '512Mi',
+    cpu = '1',
+    port = 8080,
+    minInstances = 0,
+    maxInstances = 10,
+    cloudSql = '',
+  } = options;
+
+  const cloudSqlFlag = cloudSql ? ` \\\n  --add-cloudsql-instances "${cloudSql}"` : '';
+
+  return `#!/usr/bin/env bash
+set -euo pipefail
+
+# ==============================================================================
+# Webspresso Google Cloud Run Quick Deploy Script
+# Usage: ./deploy-cloudrun.sh [SERVICE_NAME] [REGION]
+# ==============================================================================
+
+SERVICE_NAME="\${1:-${appName}}"
+REGION="\${2:-${region}}"
+PORT="\${PORT:-${port}}"
+MEMORY="\${MEMORY:-${memory}}"
+CPU="\${CPU:-${cpu}}"
+MIN_INSTANCES="\${MIN_INSTANCES:-${minInstances}}"
+MAX_INSTANCES="\${MAX_INSTANCES:-${maxInstances}}"
+
+echo "🚀 Deploying '\$SERVICE_NAME' to Google Cloud Run in '\$REGION'..."
+
+gcloud run deploy "\$SERVICE_NAME" \\
+  --source . \\
+  --region "\$REGION" \\
+  --platform managed \\
+  --allow-unauthenticated \\
+  --port "\$PORT" \\
+  --memory "\$MEMORY" \\
+  --cpu "\$CPU" \\
+  --min-instances "\$MIN_INSTANCES" \\
+  --max-instances "\$MAX_INSTANCES" \\
+  --execution-environment gen2 \\
+  --set-env-vars "NODE_ENV=production,PORT=\$PORT"${cloudSqlFlag}
+
+echo "✅ Webspresso app '\$SERVICE_NAME' deployed successfully to Cloud Run!"
+`;
+}
+
+/**
+ * Register command with Commander
+ * @param {import('commander').Command} program
+ */
+function registerCommand(program) {
+  program
+    .command('add:cloudrun')
+    .alias('cloudrun')
+    .alias('add-cloudrun')
+    .description('Generate production-ready Google Cloud Run deployment configuration')
+    .option('-r, --region <region>', 'Google Cloud region', 'us-central1')
+    .option('--memory <memory>', 'Container memory allocation', '512Mi')
+    .option('--cpu <cpu>', 'Container CPU allocation', '1')
+    .option('--port <port>', 'Container port (Cloud Run defaults to 8080)', (v) => parseInt(v, 10), 8080)
+    .option('--min-instances <num>', 'Minimum container instances', (v) => parseInt(v, 10), 0)
+    .option('--max-instances <num>', 'Maximum container instances', (v) => parseInt(v, 10), 10)
+    .option('--cloud-sql <instance>', 'Cloud SQL instance connection name (e.g. project:region:instance)', '')
+    .option('-f, --force', 'Overwrite existing files without prompting', false)
+    .action(async (...actionArgs) => {
+      const cmd = actionArgs[actionArgs.length - 1];
+      const options = (cmd && typeof cmd.opts === 'function')
+        ? cmd.opts()
+        : (actionArgs.find((a) => a && typeof a === 'object') || {});
+
+      const cwd = process.cwd();
+      const pkgPath = path.join(cwd, 'package.json');
+
+      if (!fs.existsSync(pkgPath)) {
+        console.error('❌ Not a Webspresso project! package.json was not found in current directory.');
+        process.exit(1);
+      }
+
+      let pkg = {};
+      try {
+        pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+      } catch (err) {
+        console.error(`❌ Failed to parse package.json: ${err.message}`);
+        process.exit(1);
+      }
+
+      const appName = pkg.name ? pkg.name.replace(/[^a-zA-Z0-9_-]/g, '-') : 'webspresso-app';
+      const force = Boolean(options.force);
+      const region = options.region || 'us-central1';
+      const memory = options.memory || '512Mi';
+      const cpu = String(options.cpu || '1');
+      const port = options.port || 8080;
+      const minInstances = options.minInstances ?? 0;
+      const maxInstances = options.maxInstances ?? 10;
+      const cloudSql = options.cloudSql || '';
+
+      const cloudbuildPath = path.join(cwd, 'cloudbuild.yaml');
+      const gcloudignorePath = path.join(cwd, '.gcloudignore');
+      const scriptPath = path.join(cwd, 'deploy-cloudrun.sh');
+      const dockerfilePath = path.join(cwd, 'Dockerfile');
+      const dockerignorePath = path.join(cwd, '.dockerignore');
+
+      console.log(`\n☁️  Scaffolding Google Cloud Run configuration for "${appName}"...`);
+
+      // 1. Ensure Dockerfile exists (needed by Cloud Run / Cloud Build)
+      if (!fs.existsSync(dockerfilePath)) {
+        const dockerfileContent = generateDockerfile({ port, node: '22-alpine' });
+        fs.writeFileSync(dockerfilePath, dockerfileContent, 'utf8');
+        console.log(`✅ Created Dockerfile (configured for port ${port})`);
+      }
+
+      if (!fs.existsSync(dockerignorePath)) {
+        const dockerignoreContent = generateDockerignore();
+        fs.writeFileSync(dockerignorePath, dockerignoreContent, 'utf8');
+        console.log(`✅ Created .dockerignore`);
+      }
+
+      // 2. cloudbuild.yaml
+      if (fs.existsSync(cloudbuildPath) && !force) {
+        console.log(`⚠️  ${path.basename(cloudbuildPath)} already exists. Skipping (use --force to overwrite).`);
+      } else {
+        const yamlContent = generateCloudBuildYaml({
+          appName,
+          region,
+          memory,
+          cpu,
+          port,
+          minInstances,
+          maxInstances,
+          cloudSql,
+        });
+        fs.writeFileSync(cloudbuildPath, yamlContent, 'utf8');
+        console.log(`✅ Created ${path.basename(cloudbuildPath)}`);
+      }
+
+      // 3. .gcloudignore
+      if (fs.existsSync(gcloudignorePath) && !force) {
+        console.log(`⚠️  ${path.basename(gcloudignorePath)} already exists. Skipping (use --force to overwrite).`);
+      } else {
+        const ignoreContent = generateGCloudIgnore();
+        fs.writeFileSync(gcloudignorePath, ignoreContent, 'utf8');
+        console.log(`✅ Created ${path.basename(gcloudignorePath)}`);
+      }
+
+      // 4. deploy-cloudrun.sh
+      if (fs.existsSync(scriptPath) && !force) {
+        console.log(`⚠️  ${path.basename(scriptPath)} already exists. Skipping (use --force to overwrite).`);
+      } else {
+        const scriptContent = generateDeployScript({
+          appName,
+          region,
+          memory,
+          cpu,
+          port,
+          minInstances,
+          maxInstances,
+          cloudSql,
+        });
+        fs.writeFileSync(scriptPath, scriptContent, { encoding: 'utf8', mode: 0o755 });
+        console.log(`✅ Created ${path.basename(scriptPath)} (executable)`);
+      }
+
+      // 5. Update package.json scripts
+      let modifiedPkg = false;
+      if (!pkg.scripts) pkg.scripts = {};
+      if (!pkg.scripts['gcp:deploy']) {
+        pkg.scripts['gcp:deploy'] = './deploy-cloudrun.sh';
+        modifiedPkg = true;
+      }
+      if (!pkg.scripts['gcp:build']) {
+        pkg.scripts['gcp:build'] = 'gcloud builds submit --config=cloudbuild.yaml';
+        modifiedPkg = true;
+      }
+
+      if (modifiedPkg) {
+        try {
+          fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+          console.log(`✅ Added "gcp:deploy" and "gcp:build" scripts to package.json`);
+        } catch (_) {}
+      }
+
+      console.log('\n🎉 Google Cloud Run setup complete!');
+      console.log('\nNext steps:');
+      console.log('  1. Authenticate with GCP: `gcloud auth login`');
+      console.log('  2. Set active project: `gcloud config set project YOUR_PROJECT_ID`');
+      console.log('  3. Deploy directly: `npm run gcp:deploy` or `gcloud run deploy`');
+      console.log('  4. Or build via Cloud Build: `npm run gcp:build`\n');
+    });
+}
+
+module.exports = {
+  registerCommand,
+  generateCloudBuildYaml,
+  generateGCloudIgnore,
+  generateDeployScript,
+};

package/bin/commands/add-docker.js

@@ -56,13 +56,13 @@ function detectDatabase(cwd, pkg = {}) {
  * Generate production-grade multi-stage Dockerfile
  * @param {Object} options
  * @param {string} [options.node='22-alpine']
- * @param {number} [options.port=3000]
+ * @param {number} [options.port=7331]
  * @param {boolean} [options.hasBuildScript=false]
  * @returns {string}
  */
 function generateDockerfile(options = {}) {
   const nodeImage = normalizeNodeVersion(options.node || '22-alpine');
-  const port = options.port || 3000;
+  const port = options.port || 7331;
   const isAlpine = nodeImage.includes('alpine');
 
   return `# ==========================================
@@ -198,7 +198,7 @@ public/uploads/*
  * @param {string} options.appName
  * @param {'postgres'|'mysql'|'sqlite'|'none'} options.db
  * @param {boolean} [options.redis=false]
- * @param {number} [options.port=3000]
+ * @param {number} [options.port=7331]
  * @returns {string}
  */
 function generateDockerCompose(options = {}) {
@@ -206,7 +206,7 @@ function generateDockerCompose(options = {}) {
     appName = 'webspresso-app',
     db = 'sqlite',
     redis = false,
-    port = 3000,
+    port = 7331,
   } = options;
 
   let dbService = '';
@@ -338,7 +338,7 @@ function registerCommand(program) {
     .option('-n, --node <version>', 'Node.js base image version (default: 22-alpine)', '22-alpine')
     .option('-d, --db <type>', 'Database service to configure: postgres, mysql, sqlite, none (auto-detected by default)')
     .option('-r, --redis', 'Include Redis service in docker-compose.yml', false)
-    .option('-p, --port <port>', 'Application container port (default: 3000)', '3000')
+    .option('-p, --port <port>', 'Application container port (default: 7331)', '7331')
     .option('-f, --force', 'Overwrite existing Dockerfile and docker-compose.yml without prompting', false)
     .action(async (...actionArgs) => {
       const cmd = actionArgs[actionArgs.length - 1];
@@ -363,7 +363,7 @@ function registerCommand(program) {
       }
 
       const appName = pkg.name ? pkg.name.replace(/[^a-zA-Z0-9_-]/g, '-') : 'webspresso-app';
-      const port = parseInt(options.port || '3000', 10) || 3000;
+      const port = parseInt(options.port || '7331', 10) || 7331;
       const dbType = options.db || detectDatabase(cwd, pkg);
       const isRedis = Boolean(options.redis);
       const nodeVersion = options.node || '22-alpine';