deploy-stack 0.9.14 → 0.10.0

package/README.md

@@ -2,8 +2,10 @@
 
 > The zero-lock-in cloud generator. Eject your containerized web app from expensive PaaS platforms to production-ready, highly available AWS infrastructure in 60 seconds.
 
+[![NPM Version](https://img.shields.io/npm/v/deploy-stack.svg?color=blue&logo=npm)](https://www.npmjs.com/package/deploy-stack)
+[![Node.js Support](https://img.shields.io/node/v/deploy-stack.svg?color=brightgreen)](https://www.npmjs.com/package/deploy-stack)
+[![Security: Trivy](https://img.shields.io/badge/Security-Trivy_Scanned-blue.svg?logo=docker)](https://trivy.dev/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Security: Trivy](https://img.shields.io/badge/Security-Trivy_Scanned-blue.svg)](https://trivy.dev/)
 
 <!-- ![deploy-stack CLI demonstration](./docs/demo.gif) -->
 
@@ -25,21 +27,26 @@ You retain complete ownership of your infrastructure code without relying on bla
 
 ## ✨ Features
 
-* **Zero Vendor Lock-In:** Generates standard, clean `.tf` files. Modify, expand, or decouple them at any time.
-* **Automated DevSecOps:** Integrated Trivy vulnerability scanning for your infrastructure (IaC) and Docker containers on every GitHub Actions run.
-* **Hardened, Unprivileged Containers:** Built-in Dockerfile generators explicitly drop root privileges and utilize `nginx-unprivileged` for maximum Fargate security compliance.
-* **Cost & Observability Baselines:** Prevents runaway AWS bills with explicit 14-day CloudWatch log retention policies and auto-generates 5XX error alerting.
-* **Safe Overwrite Flow:** Idempotent CLI safely backs up existing configurations to timestamped `.bak` files and updates `.gitignore` to guarantee zero data loss during rapid iteration.
-* **Framework Agnostic:** Tailored container presets for Next.js, Express.js, FastAPI, and **Zero-Config Static Sites** (React, Vue, SvelteKit, Astro, Vite).
-* **Smart Git Integration:** Automatically detects your working branch (`main`, `master`, `develop`) and binds it directly to the generated GitHub Actions pipeline.
-* **Production-Grade Defaults:** Automatically provisions an Amazon ECS Fargate cluster fronted by an Application Load Balancer across multiple availability zones.
-* **Global Edge Acceleration:** Includes an integrated AWS CloudFront CDN distribution with SSL termination and optimized caching.
-* **Keyless, Zero-Secret CI/CD:** Uses AWS IAM OpenID Connect (OIDC) for automated deployments—no long-lived AWS keys stored in GitHub Secrets.
-* **Remote State with Native S3 Locking:** Automatically creates an encrypted S3 state bucket utilizing modern Terraform (1.7+) native S3 concurrency locking.
-* **Built-in Secrets Sync:** Provides a dedicated CLI workflow to securely push local `.env` variables into AWS Secrets Manager and map them directly into containers at runtime.
-* **Ecosystem Ready:** Integrated directly with the [deploy-stack GitHub Action](https://github.com/marketplace/actions/deploy-stack-aws-fargate-terraform-deploy) for a secure, boilerplate-free continuous deployment pipeline.
+**🚀 Zero-Config Deployments**
+* **Framework Agnostic:** Tailored container presets for Next.js, Express.js, FastAPI, Go, Django, Rails, Nuxt 3, and Static Sites (React, Vue, SvelteKit, Astro).
+* **Smart Discovery:** Automatically detects build output directories and generates highly optimized, multi-stage Dockerfiles.
 * **Database Scaffolding:** Automatically provisions fully isolated, zero-trust AWS RDS PostgreSQL databases for backend monoliths.
-* **Safe Teardown:** Completely remove all generated AWS resources and empty S3 state buckets with a single `destroy` command.
+
+**🛡️ DevSecOps & Security**
+* **Automated Trivy Scanning:** Integrated IaC and container vulnerability scanning on every GitHub Actions run.
+* **Hardened Containers:** Explicitly drops root privileges using `nginx-unprivileged` and distroless bases for strict Fargate security compliance.
+* **Zero-Secret CI/CD:** Utilizes AWS IAM OpenID Connect (OIDC) for automated deployments—no long-lived AWS keys in GitHub.
+* **Built-in Secrets Manager:** Push local `.env` variables directly into encrypted AWS Secrets Manager vaults with a single CLI command.
+
+**☁️ AWS Native Architecture**
+* **Production Defaults:** Provisions an Amazon ECS Fargate cluster fronted by an Application Load Balancer across multiple availability zones.
+* **Global Edge Acceleration:** Integrated AWS CloudFront CDN distribution with SSL termination and edge caching.
+* **Cost & Observability:** Prevents runaway AWS bills with explicit 14-day CloudWatch log retention and auto-generates 5XX error alerting.
+
+**🛠️ Developer Experience**
+* **Zero Vendor Lock-In:** Generates standard, readable Terraform (`.tf`) files. You own the infrastructure.
+* **Native S3 State Locking:** Automatically creates an encrypted S3 state bucket utilizing modern Terraform concurrency locking.
+* **Safe Iteration:** Idempotent CLI safely backs up existing configurations to `.bak` files to guarantee zero data loss.
 
 ---
 
@@ -47,60 +54,44 @@ You retain complete ownership of your infrastructure code without relying on bla
 
 Run the CLI directly in your project root:
 
-```bash
+\`\`\`bash
 npx deploy-stack
-```
+\`\`\`
 
-The interactive CLI will guide you through the setup:
-1. **Target Directory / Name:** (Type `.` to bootstrap your current directory)
-2. **Setup Mode:** (Choose **Quickstart** for sensible defaults, or **Advanced** for custom scaling and branch names)
-3. **Zero-Config Detection:** The CLI automatically scans your project to detect your framework. For static sites, it intelligently discovers your build output directory (`dist`, `build`, `.output`, etc.) and dynamically configures the hardened Nginx container.
-4. **AWS Region & Compute Tier:** (Select your target region and Fargate size with live cost estimates)
+The interactive wizard will analyze your codebase, detect your framework, estimate your AWS costs, and generate your Terraform and GitHub Actions configurations.
 
 ---
 
-## 🔑 Securely Managing Secrets
+## 🧰 CLI Command Reference
 
-Avoid committing sensitive environment files to version control. Push local variables directly to AWS:
+`deploy-stack` manages the entire lifecycle of your infrastructure.
 
-```bash
-npx deploy-stack secrets push .env.production
-```
-*This command encrypts your values in AWS Secrets Manager and updates `terraform/secret_keys.json` to expose those variables inside your ECS tasks at boot.*
+* **`npx deploy-stack apply`**
+  Wraps Terraform execution in a beautiful, terminal-friendly UI. Automatically provisions your AWS infrastructure and outputs your live CDN and Load Balancer URLs.
+  
+* **`npx deploy-stack secrets push <file>`**
+  Securely encrypts your local environment variables (e.g., `.env.production`) into AWS Secrets Manager and maps them to your ECS container at runtime.
 
----
+* **`npx deploy-stack doctor`**
+  Scans your local environment and generated files to ensure all required dependencies (Docker, Terraform, AWS CLI) are installed and configured correctly.
 
-## 🛠️ Next Steps After Generation
-
-1. **Provision Infrastructure:**
-   ```bash
-   cd terraform
-   terraform init
-   terraform apply
-   ```
-2. **Push to GitHub:**
-   ```bash
-   git add .
-   git commit -m "feat: infrastructure and deployment pipeline"
-   git push origin main
-   ```
-3. **Automated Deployment:** GitHub Actions securely authenticates via OIDC, builds your container, pushes to Amazon ECR, and executes a zero-downtime rolling deployment to ECS.
+* **`npx deploy-stack destroy`**
+  Safely tears down your ECS cluster, Load Balancers, and networking resources to stop AWS billing. Includes an interactive prompt to optionally retain or delete your S3 remote state bucket.
 
----
-
-## 🗑️ Infrastructure Teardown
-To safely completely remove your ECS cluster, load balancers, and empty the remote S3 state bucket, run:
-`npx deploy-stack destroy`
+* **`npx deploy-stack eject`**
+  Strips all `deploy-stack` metadata and management tags from your project, leaving behind pure, standard Terraform and GitHub Actions files. You retain 100% ownership.
 
 ---
 
 ## 📁 Generated File Structure
 
-Running the CLI generates a modular architecture tailored to your service:
+Running the CLI seamlessly integrates a modular, DevSecOps-hardened architecture into your repository:
 
-```text
+\`\`\`text
 your-project/
 ├── Dockerfile                  # Multi-stage container preset
+├── .dockerignore               # Prevents secret leaks into container builds
+├── .gitignore                  # Automatically updated to ignore tfstate and .bak files
 ├── .github/
 │   └── workflows/
 │       └── deploy.yml          # Keyless OIDC CI/CD deployment pipeline
@@ -112,7 +103,7 @@ your-project/
     ├── secrets.tf              # AWS Secrets Manager integration
     ├── backend.tf              # S3 Remote State backend with native locking
     └── secret_keys.json        # Dynamic key map for injected environment variables
-```
+\`\`\`
 
 ---
 
@@ -125,6 +116,10 @@ your-project/
 * **[Create React App](https://github.com/anton-codes-iac/deploy-stack-cra-example):** Validates backward compatibility with legacy Webpack pipelines and `build/` auto-detection.
 * **[Astro Static Site](https://github.com/anton-codes-iac/deploy-stack-astro-example):** Demonstrates modern static site generation (SSG).
 * **[SvelteKit Application](https://github.com/anton-codes-iac/deploy-stack-svelte-example):** Demonstrates static adapter integration and custom output folder detection.
+* **[Ruby on Rails](https://github.com/anton-codes-iac/deploy-stack-rails-example):** A production Rails 7+ setup featuring an auto-provisioned PostgreSQL database and secure `.auto.tfvars` Master Key injection.
+* **[Nuxt 3 (SSR)](https://github.com/anton-codes-iac/deploy-stack-nuxt-example):** Demonstrates a fully server-side rendered Nuxt application using Nitro's optimized Node output.
+* **[Django / Python](https://github.com/anton-codes-iac/deploy-stack-django-example):** A secure Gunicorn/WSGI implementation with PostgreSQL and unprivileged container adapters.
+* **[Go / Fiber](https://github.com/anton-codes-iac/deploy-stack-go-example):** A distroless, compiled Go binary deployment demonstrating ultra-low memory footprints and instant boot times.
 ---
 
 ## 🛡️ Telemetry & Privacy
@@ -139,8 +134,6 @@ npx deploy-stack --no-telemetry
 
 ## 🗺️ Roadmap
 
-## 🗺️ Roadmap
-
 ### Phase 1–3: The Core Engine (Completed)
 - [x] **Core MVP:** Interactive CLI, ECS Fargate + ALB generation, CI/CD, and Secrets sync.
 - [x] **Production Readiness:** CloudFront CDN edge distribution, native S3 state locking, and secure OIDC integration.
@@ -153,9 +146,10 @@ npx deploy-stack --no-telemetry
 - [x] **Zero Vendor Lock-In:** Explicit `npx deploy-stack eject` command to safely strip `ManagedBy` tags and CLI metadata, leaving behind pure IaC.
 - [x] **Heavy Backend Monoliths:** Hardened, unprivileged container adapters for Go, Nuxt.js, Django, and Rails, complete with automated zero-trust RDS PostgreSQL provisioning.
 
-### Phase 5: The Activation Engine (Pre-1.0 Growth Loops)
+### Phase 5: The Activation Engine (v0.10.0 - Current)
+- [x] **Local Execution Wrapper:** Native `deploy-stack apply` command with terminal-optimized streaming to eliminate Terraform context switching.
+- [ ] **Ecosystem Integrations:** Publishing official plugins to the Astro Integrations directory and backend framework ecosystems.
 - [ ] **Ephemeral PR Previews:** Generating live preview URLs on every GitHub Pull Request, turning single-user tests into team-wide advertisements.
-- [ ] **Next.js Image Optimization Handler:** A drop-in AWS Serverless handler (Lambda + CloudFront) to process images affordably, removing a massive Vercel lock-in hurdle.
 - [ ] **GitHub Deployments UI Sync:** Wiring up the native GitHub "Environments" tab for instant visual validation that the CLI succeeded in the background.
 
 ### Phase 6: Workflow Interception (IDE, AI, & Local Bridges)

package/bin/cli.js

@@ -5,6 +5,7 @@ import { destroyStack } from '../src/commands/destroy.js';
 import { runDoctor } from '../src/commands/doctor.js';
 import { pushSecrets } from '../src/commands/secrets.js';
 import { ejectStack } from '../src/commands/eject.js';
+import { applyStack } from '../src/commands/apply.js';
 
 // 1. Extract the telemetry flag and set the environment variable
 const rawArgs = process.argv.slice(2);
@@ -22,6 +23,8 @@ if (args[0] === 'secrets' && args[1] === 'push') {
     const envFile = args[2] || '.env';
     const projectName = path.basename(process.cwd());
     pushSecrets(envFile, projectName).catch(console.error);
+} else if (args[0] === 'apply') {
+    applyStack().catch(console.error);
 } else if (args[0] === 'doctor') {
     runDoctor().catch(console.error);
 } else if (args[0] === 'destroy') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deploy-stack",
-  "version": "0.9.14",
+  "version": "0.10.0",
   "description": "Provision production-ready AWS infrastructure and CI/CD pipelines in seconds.",
   "type": "module",
   "bin": {

package/src/commands/apply.js

@@ -0,0 +1,133 @@
+import { spawn } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import { intro, outro, spinner, log, cancel } from '@clack/prompts';
+import color from 'picocolors';
+
+// Helper to run a command while piping the latest stdout line into a @clack spinner
+function runTerraformCommand(args, cwd, spin, loadingPrefix) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('terraform', args, { cwd });
+        let errorOutput = '';
+        let isDone = false;
+
+        child.stdout.on('data', (data) => {
+            if (isDone) return;
+            const lines = data.toString().split('\n').filter(line => line.trim() !== '');
+            if (lines.length > 0) {
+                const latestLine = lines[lines.length - 1].trim();
+                const display = latestLine.length > 120 ? latestLine.substring(0, 117) + '...' : latestLine;
+                spin.message(`${loadingPrefix} - ${color.dim(display)}`);
+            }
+        });
+
+        child.stderr.on('data', (data) => {
+            errorOutput += data.toString();
+        });
+
+        child.on('close', (code) => {
+            isDone = true;
+            if (code === 0) {
+                resolve();
+            } else {
+                reject(new Error(errorOutput || `Terraform exited with code ${code}`));
+            }
+        });
+
+        child.on('error', (err) => {
+            isDone = true;
+            reject(err);
+        });
+    });
+}
+
+// Helper to pull JSON outputs from Terraform
+function getTerraformOutputs(cwd) {
+    return new Promise((resolve) => {
+        const child = spawn('terraform', ['output', '-json'], { cwd });
+        let outputData = '';
+
+        child.stdout.on('data', (data) => {
+            outputData += data.toString();
+        });
+
+        child.on('close', (code) => {
+            if (code === 0) {
+                try {
+                    resolve(JSON.parse(outputData));
+                } catch {
+                    resolve({});
+                }
+            } else {
+                resolve({});
+            }
+        });
+
+        child.on('error', () => {
+            resolve({});
+        });
+    });
+}
+
+export async function applyStack() {
+    intro(color.bgCyan(color.black(' deploy-stack apply ☁️  ')));
+
+    const targetDir = process.cwd();
+    const tfDir = path.join(targetDir, 'terraform');
+
+    // 1. Verify that the user is inside a project generated by deploy-stack
+    if (!fs.existsSync(tfDir) || !fs.existsSync(path.join(tfDir, 'main.tf'))) {
+        log.error(color.red('✖ No terraform directory found in current path.'));
+        log.message('Please run "npx deploy-stack" first to generate your infrastructure templates.');
+        process.exit(1);
+    }
+
+    const s = spinner();
+
+    try {
+        // 2. Run terraform init
+        s.start('Initializing Terraform plugins...');
+        await runTerraformCommand(['init', '-upgrade'], tfDir, s, 'Initializing');
+        log.success('Terraform initialized.');
+
+        // 3. Run terraform apply
+        s.start('Provisioning AWS infrastructure (this may take 3–5 minutes)...');
+        await runTerraformCommand(['apply', '-auto-approve'], tfDir, s, 'Provisioning');
+        s.stop('AWS infrastructure provisioned successfully!');
+
+        // 4. Extract and print the outputs
+        const outputs = await getTerraformOutputs(tfDir);
+
+        const cfUrl = outputs.cloudfront_url?.value;
+        const albUrl = outputs.alb_direct_url?.value;
+
+        let finalMessage = color.green('✅ Infrastructure is live!');
+        if (cfUrl) finalMessage += `\n  🌍 CDN: ${color.cyan(cfUrl)}`;
+        if (albUrl) finalMessage += `\n  🚦 ALB: ${color.gray(albUrl)}`;
+
+        outro(`${finalMessage}\n\n  ${color.yellow('Push code to deploy your app and clear the 503 error:')}\n  ${color.cyan('git add . && git commit -m "ci: infra" && git push origin main')}`);
+
+        process.exit(0);
+
+    } catch (error) {
+        s.stop(color.red('❌ Terraform apply failed.'));
+
+        const errString = error.message || "";
+
+        if (errString.includes('EntityAlreadyExists') && errString.includes('token.actions.githubusercontent.com')) {
+            log.error(color.red('GitHub OIDC Provider Conflict Detected'));
+            log.message('AWS only allows one GitHub Actions provider per account, and you already have one configured.');
+            log.message('');
+            log.message(`${color.bold('How to fix this:')}`);
+            log.message(`1. Open ${color.cyan('terraform/oidc.tf')}`);
+            log.message(`2. Change ${color.green('create_oidc_provider = true')} to ${color.green('create_oidc_provider = false')}`);
+            log.message(`3. Run ${color.cyan('npx deploy-stack apply')} again.`);
+        } else {
+            // Generic fallback for unknown errors
+            log.error(color.red(errString));
+            log.message(`${color.bold('To debug manually, navigate to your terraform folder:')}`);
+            log.message(color.cyan('cd terraform && terraform apply'));
+        }
+        process.exit(1);
+    }
+}

package/src/commands/destroy.js

@@ -2,11 +2,45 @@ import fsSync from 'fs';
 import path from 'path';
 import { intro, outro, confirm, spinner, cancel } from '@clack/prompts';
 import color from 'picocolors';
-import { execSync } from 'child_process';
+import { execSync, spawn } from 'child_process';
 import { teardownStateBucket } from '../utils/aws.js';
 import { checkDependency } from '../utils/system.js';
 import { trackEvent, flushTelemetry } from '../core/telemetry.js';
 
+// Helper to run a command while piping the latest stdout line into a @clack spinner
+function runTerraformCommand(args, cwd, spin, loadingPrefix) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('terraform', args, { cwd });
+        let errorOutput = '';
+        let isDone = false;
+
+        child.stdout.on('data', (data) => {
+            if (isDone) return;
+            const lines = data.toString().split('\n').filter(line => line.trim() !== '');
+            if (lines.length > 0) {
+                const latestLine = lines[lines.length - 1].trim();
+                const display = latestLine.length > 120 ? latestLine.substring(0, 117) + '...' : latestLine;
+                spin.message(`${loadingPrefix} - ${color.dim(display)}`);
+            }
+        });
+
+        child.stderr.on('data', (data) => {
+            errorOutput += data.toString();
+        });
+
+        child.on('close', (code) => {
+            isDone = true;
+            if (code === 0) resolve();
+            else reject(new Error(errorOutput || `Terraform exited with code ${code}`));
+        });
+
+        child.on('error', (err) => {
+            isDone = true;
+            reject(err);
+        });
+    });
+}
+
 export async function destroyStack() {
     intro(color.bgRed(color.white(' deploy-stack destroy 🗑️  ')));
 
@@ -46,23 +80,34 @@ export async function destroyStack() {
     const region = regionMatch ? regionMatch[1] : 'us-east-1';
 
     // 2. Execute Terraform Destroy
-    console.log(color.cyan('\nInitiating Terraform destroy (this may take a few minutes)...\n'));
+    s.start('Destroying AWS compute resources (this takes a few minutes)...');
     try {
-        execSync('terraform destroy -auto-approve', { cwd: tfDirPath, stdio: 'inherit' });
+        await runTerraformCommand(['destroy', '-auto-approve'], tfDirPath, s, 'Destroying');
+        s.stop('AWS compute resources destroyed.');
     } catch (error) {
-        console.error(color.red('\n✖ Terraform destroy failed. Please check the output above.'));
+        s.stop(color.red('❌ Terraform destroy failed.'));
+        console.error(color.red(error.message));
         process.exit(1);
     }
 
     // 3. Clean up the S3 State Bucket
     if (bucketName) {
-        s.start(`Emptying and deleting S3 state bucket: ${bucketName}...`);
-        try {
-            await teardownStateBucket(region, bucketName);
-            s.stop(`S3 bucket ${bucketName} successfully deleted.`);
-        } catch (error) {
-            s.stop(`❌ Failed to delete S3 bucket. You may need to delete it manually in the AWS Console.`);
-            console.error(color.red(`AWS Error: ${error.message}`));
+        const deleteS3Bucket = await confirm({
+            message: color.yellow(`AWS compute resources destroyed. Do you also want to permanently delete the S3 state bucket?\n  (Select 'No' if you plan to run 'deploy-stack apply' later to spin this back up.)`),
+            initialValue: false,
+        });
+
+        if (deleteS3Bucket && typeof deleteS3Bucket !== 'symbol') {
+            s.start(`Emptying and deleting S3 state bucket: ${bucketName}...`);
+            try {
+                await teardownStateBucket(region, bucketName);
+                s.stop(`S3 bucket ${bucketName} successfully deleted.`);
+            } catch (error) {
+                s.stop(`❌ Failed to delete S3 bucket. You may need to delete it manually in the AWS Console.`);
+                console.error(color.red(`AWS Error: ${error.message}`));
+            }
+        } else {
+            console.log(color.cyan(`\n  S3 bucket retained. You can run 'npx deploy-stack apply' anytime to restore your infrastructure.`));
         }
     }
 

package/src/commands/init.js

@@ -214,6 +214,26 @@ export async function mainStack() {
     const deployBranch = project.branch || currentGitBranch;
     const buildDir = detectedFramework?.buildDir || 'dist';
 
+    // 7.4 Check for conflicting CI boilerplate (Rails)
+    let disableDefaultCI = false;
+    if (finalFramework === 'rails') {
+        const ciPath = path.join(targetDir, '.github', 'workflows', 'ci.yml');
+        const dependabotPath = path.join(targetDir, '.github', 'dependabot.yml');
+
+        if (fsSync.existsSync(ciPath) || fsSync.existsSync(dependabotPath)) {
+            console.log('');
+            const ciContent = await confirm({
+                message: color.yellow('We detected default Rails GitHub Actions (ci.yml, dependabot.yml) that usually crash in isolated CI environments without a database. Would you like deploy-stack to safely disable them by renaming them to .bak?'),
+                initialValue: true,
+            });
+            if (typeof ciContent === 'symbol') {
+                cancel('Provisioning cancelled.');
+                process.exit(0);
+            }
+            disableDefaultCI = ciContent;
+        }
+    }
+
     // 7.5. The Pre-Flight Cost Estimator
     // We explicitly ask for financial consent to eliminate AWS billing anxiety.
     console.log(''); // Add a blank line for visual pacing
@@ -266,7 +286,8 @@ export async function mainStack() {
         BUILD_DIR: buildDir,
         finalFramework: finalFramework,
         NEEDS_DATABASE: needsDatabase,
-        DJANGO_WSGI: djangoWsgi
+        DJANGO_WSGI: djangoWsgi,
+        DISABLE_DEFAULT_CI: disableDefaultCI
     });
 
     // 11. Track the event in telemetry
@@ -292,36 +313,20 @@ export async function mainStack() {
     const isGitInitialized = fsSync.existsSync(path.join(targetDir, '.git'));
 
     const cdStep = projectName === '.' ? '' : `1. cd ${projectName}\n        `;
-    const deployStepNum = projectName === '.' ? '1' : '2';
-    const gitStepNum = projectName === '.' ? '2' : '3';
+    const applyStep = `${cdStep}npx deploy-stack apply`;
 
     const gitInstructions = isGitInitialized
-        ? `git add .\n       git commit -m "chore: add AWS infrastructure and CI/CD"\n       git push`
-        : `git init\n       git add .\n       git commit -m "chore: add AWS infrastructure and CI/CD"\n       git branch -M ${deployBranch}\n       git remote add origin https://github.com/your-username/your-repo.git\n       git push -u origin ${deployBranch}`;
-
-    outro(`
-    ${color.green('✅ Project provisioned successfully!')}
-
-    ${color.blue('🛡️ DevSecOps Enabled:')}
-       Automated Trivy vulnerability scanning for your Docker container 
-       and Terraform has been added to your CI/CD pipeline. 
-       Check the 'Summary' page of your GitHub Actions runs for reports.
-
-    ${frameworkWarnings}
-    
-    Next steps:
-    ${cdStep}${deployStepNum}. Deploy infrastructure:
-       cd terraform && terraform init && terraform apply
-
-    ${gitStepNum}. Push to GitHub to trigger CI/CD:
-       cd ..
-       ${gitInstructions}
+        ? `git add . && git commit -m "chore: add AWS infrastructure and CI/CD" && git push`
+        : `git init && git add . && git commit -m "chore: add AWS infrastructure and CI/CD" && git branch -M ${deployBranch} && git remote add origin https://github.com/your-username/your-repo.git && git push -u origin ${deployBranch}`;
 
-    ${color.cyan('Once deployed, Terraform will output your new https://*.cloudfront.net URL.')}
+    const outroMessage = `${color.green('✅ Templates generated!')} ${color.blue('🛡️ DevSecOps scanning enabled.')}
+    ${frameworkWarnings ? `\n  ${frameworkWarnings}` : ''}
+    ${color.yellow('Next steps:')}
+    1. ${color.cyan(applyStep)}
+    2. ${color.cyan(gitInstructions)}
+    ${color.magenta('🚀 Need help?')} ${color.underline('https://calendly.com/anton-codes-iac/15min')}`;
 
-    ${color.magenta('🚀 Infrastructure ready! Need help or have feedback? Grab 15 mins with Anton:')}
-    ${color.underline('https://calendly.com/anton-codes-iac/15min')}
-    `);
+    outro(outroMessage);
 
     // 13.Ensure all analytics are sent before the CLI terminates
     await flushTelemetry();

package/src/utils/generator.js

@@ -152,13 +152,17 @@ Thumbs.db
         const railsCiPath = path.join(targetDir, '.github', 'workflows', 'ci.yml');
         const dependabotPath = path.join(targetDir, '.github', 'dependabot.yml');
 
-        if (fsSync.existsSync(railsCiPath)) {
-            fsSync.renameSync(railsCiPath, `${railsCiPath}.bak`);
-            console.log('  ⚠️  Disabled default Rails ci.yml (renamed to .bak) to prevent database connection crashes in CI.');
-        }
-        if (fsSync.existsSync(dependabotPath)) {
-            fsSync.renameSync(dependabotPath, `${dependabotPath}.bak`);
-            console.log('  ⚠️  Disabled default dependabot.yml (renamed to .bak) to prevent automated PRs from triggering the broken CI suite.');
+        if (config.DISABLE_DEFAULT_CI) {
+            if (fsSync.existsSync(railsCiPath)) {
+                fsSync.renameSync(railsCiPath, `${railsCiPath}.bak`);
+                console.log('  ✅  Safely disabled default Rails ci.yml (renamed to .bak).');
+            }
+            if (fsSync.existsSync(dependabotPath)) {
+                fsSync.renameSync(dependabotPath, `${dependabotPath}.bak`);
+                console.log('  ✅  Safely disabled default dependabot.yml (renamed to .bak).');
+            }
+        } else if (fsSync.existsSync(railsCiPath) || fsSync.existsSync(dependabotPath)) {
+            console.log('  ⚠️  You chose to keep your existing GitHub Actions. Please note that default tests may fail until you configure a database service in your CI runner.');
         }
     }
 }

package/templates/README.md

@@ -67,6 +67,10 @@ Make sure your app returns a `200 OK` at your configured path:
 * **Next.js (App Router):** Create `app/api/health/route.ts` returning a 200 response.
 * **Express.js:** Add `app.get('/api/health', (req, res) => res.sendStatus(200));`
 * **FastAPI/Python:** Add `@app.get("/api/health")` returning a 200 status.
+* **Ruby on Rails:** Rails 7.1+ includes a default `/up` health check. Ensure `Rails.application.config.force_ssl = true` isn't blocking HTTP health checks from the ALB.
+* **Django:** Add a simple view in `urls.py` that returns `HttpResponse("OK", status=200)` at your configured path.
+* **Go:** Add a handler to your mux: `http.HandleFunc("/api/health", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(200) })`
+* **Nuxt 3:** Create a server route at `server/routes/health.ts` returning `200`.
 
 ### 2. Enable Standalone Output (Next.js ONLY)
 
@@ -91,6 +95,10 @@ When running inside a Docker container, your server must bind to all network int
 Make sure your app is configured correctly:
 * **Express.js:** `app.listen(port, '0.0.0.0', () => ...)`
 * **FastAPI:** `uvicorn.run(app, host="0.0.0.0", port=8000)`
+* **Ruby on Rails:** Bound automatically by the CLI's Puma command (`-b tcp://0.0.0.0:{{PORT}}`).
+* **Django:** Bound automatically by the CLI's Gunicorn command (`--bind 0.0.0.0:{{PORT}}`).
+* **Go:** Ensure your `ListenAndServe` string looks like this: `http.ListenAndServe(":8080", nil)` or `http.ListenAndServe("0.0.0.0:8080", nil)`.
+* **Nuxt 3:** Bound automatically via the `NITRO_HOST=0.0.0.0` environment variable injected by the CLI Dockerfile.
 
 ### 4. Static Sites (Vite, Astro, React, Vue, SvelteKit)