deploy-stack 0.17.1 → 0.17.2

package/docs/guides/headless.md

@@ -0,0 +1,46 @@
+# Headless Mode & Automation Guide
+
+The `deploy-stack` CLI is designed to be fully automatable for CI/CD pipelines, custom scripts, and framework plugins (like `vite-plugin-deploy-stack`). 
+
+By passing the `--headless` flag, you bypass all interactive terminal prompts.
+
+## Required Flags
+To use headless mode, simply include the `--headless` flag. 
+
+If `deploy-stack` cannot auto-detect your framework, you should also provide the `--framework` flag to ensure the correct infrastructure is generated.
+
+* **Valid `--framework` options:** `node`, `nextjs`, `nuxt`, `python`, `django`, `rails`, `go`, `static`
+
+## Optional Configuration Flags
+
+You can append any of these flags to customize the generated architecture. These map exactly to the options available in the interactive setup:
+
+| Flag | Description | Default |
+|---|---|---|
+| `--region=<region>` | The AWS region to deploy to (e.g., `us-east-1`, `eu-west-1`). | `us-east-2` |
+| `--size=<size>` | The Fargate compute size (`micro` or `small`). | `micro` |
+| `--port=<number>` | The internal port your container exposes. | Framework dependent (`3000`, `8080`, `8000`) |
+| `--healthCheckPath=<path>`| The ALB health check endpoint path. | `/` |
+| `--desiredCount=<number>` | Number of container replicas to run (`1` or `2`). | `1` |
+| `--branch=<name>` | The primary Git deployment branch for CI/CD. | `main` |
+| `--dir=<path>` | The directory to generate files into (use `.` for current).| `.` |
+| `--enablePrPreviews` | Generates workflows for Ephemeral PR Previews. | `false` |
+| `--yes` | Automatically bypasses confirmation prompts during apply/destroy. | `false` |
+| `--no-telemetry` | Disables anonymous usage analytics. | `false` |
+
+## Example Usage
+
+**Standard Static Site Automation (e.g., Vite/React):**
+```bash
+npx deploy-stack --headless --framework=static --region=eu-west-1 --size=micro
+```
+
+**Next.js High-Availability CI/CD Generation:**
+```bash
+npx deploy-stack --headless --framework=nextjs --size=small --desiredCount=2 --yes
+```
+
+**Node.js Backend with PR Previews:**
+```bash
+npx deploy-stack --headless --framework=node --port=4000 --enablePrPreviews
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deploy-stack",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "Provision production-ready AWS infrastructure and CI/CD pipelines in seconds.",
   "engines": {
     "node": ">=18.0.0"

package/src/utils/detector.js

@@ -21,6 +21,9 @@ export function detectFramework(targetDir) {
             if (deps['nuxt']) return { id: 'nuxt', name: 'Nuxt 3 (SSR)' };
             if (deps['express']) return { id: 'node', name: 'Node.js / Express' };
 
+            // Explicit SvelteKit SSR Detection
+            if (deps['@sveltejs/kit']) return { id: 'svelte', name: 'SvelteKit SSR', buildDir: 'build' };
+
             // Static Site Generators & SPAs (with precise build directories)
             if (deps['@sveltejs/kit']) return { id: 'static', name: 'SvelteKit', buildDir: 'build' };
             if (deps['react-scripts']) return { id: 'static', name: 'Create React App', buildDir: 'build' };

package/src/utils/prompts.js

@@ -60,6 +60,7 @@ export async function getProjectConfig(isHeadless, headlessOptions, targetDir, d
                 { value: 'node', label: 'Node.js / Express' },
                 { value: 'nextjs', label: 'Next.js (Standalone)' },
                 { value: 'nuxt', label: 'Nuxt 3 (SSR)' },
+                { value: 'svelte', label: 'SvelteKit (SSR)' },
                 { value: 'python', label: 'Python FastAPI' },
                 { value: 'django', label: 'Django (Python)' },
                 { value: 'rails', label: 'Ruby on Rails' },

package/templates/docker/svelte.Dockerfile

@@ -0,0 +1,25 @@
+FROM node:22-alpine
+
+# 1. DevSecOps: Patch underlying Alpine OS vulnerabilities
+RUN apk update && apk upgrade --no-cache
+
+# 2. Set production environment
+ENV NODE_ENV=production
+WORKDIR /app
+
+# 3. Copy manifests and install ONLY production dependencies
+COPY --chown=node:node package*.json ./
+RUN npm ci --omit=dev && npm cache clean --force
+
+# 4. Copy the compiled SvelteKit server generated by adapter-node
+COPY --chown=node:node build/ ./build/
+COPY --chown=node:node package.json ./
+
+# 5. DevSecOps: Remove NPM to eliminate Trivy vulnerabilities
+RUN rm -rf /usr/local/lib/node_modules/npm /usr/local/bin/npm /usr/local/bin/npx
+
+USER node
+EXPOSE {{PORT}}
+
+# 6. Execute the raw Node server directly (Bypassing NPM)
+CMD ["node", "build/index.js"]