deploy-stack 0.1.0 → 0.2.2

package/.github/workflows/publish.yml

@@ -7,22 +7,27 @@ on:
 jobs:
   build-and-publish:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
     steps:
       - uses: actions/checkout@v4
       
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20.x'
+          node-version: '24.x'
           registry-url: 'https://registry.npmjs.org'
-          
+
+      - name: Upgrade NPM for OIDC
+        run: npm install -g npm@latest
+
       - name: Inject Telemetry Key
-        # This securely swaps the placeholder for the real key right before publishing
         run: sed -i "s/___POSTHOG_INGESTION_KEY___/${{ secrets.POSTHOG_KEY }}/g" src/core/telemetry.js
         
-      - run: npm install
+      - name: Install dependencies
+        run: npm install
       
       - name: Publish to NPM
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --provenance

package/README.md

@@ -4,6 +4,8 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+![deploy-stack CLI demonstration](./docs/demo.gif)
+
 ---
 
 ## The Problem
@@ -43,10 +45,9 @@ 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** to customize health checks, scaling, and branch names)
-3. **AWS Region:** (e.g., `us-east-2`)
-4. **Compute Tier:** (Choose from Micro, Small, Medium, or Large with live monthly cost estimates)
-5. **Target Port & Framework:** (Generates an optimized multi-stage `Dockerfile`)
+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 `package.json` or `requirements.txt` to detect your framework (Next.js, Express, FastAPI, etc.) and dynamically configures your container port.
+4. **AWS Region & Compute Tier:** (Select your target region and Fargate size with live cost estimates)
 
 ---
 
@@ -107,7 +108,7 @@ your-project/
 
 ---
 
-### 🛡️ Telemetry & Privacy
+## 🛡️ Telemetry & Privacy
 By default, `deploy-stack` collects anonymous, hashed usage data to help improve the CLI (e.g., framework presets used, deployment success rates). **No codebase files, AWS credentials, or personal data are ever collected.**
 
 To opt out, simply append the flag:
@@ -119,11 +120,12 @@ npx deploy-stack --no-telemetry
 
 ## 🗺️ Roadmap
 
-- [x] **POC:** Interactive CLI, ECS Fargate + ALB Terraform generation, GitHub Actions CI/CD, and Secrets sync.
-- [x] **MVP:** CloudFront distribution, Remote S3 State locking, OIDC security, and CLI configuration flows.
-- [ ] **v0.9:** Zero-config framework detection (auto-discovering Next.js, Express, and FastAPI via `package.json` / `requirements.txt`).
-- [ ] **v1.0 (Pro):** Automated RDS PostgreSQL provisioning, custom domain Route 53 / ACM SSL configuration, and environment workspaces (`staging` vs `prod`).
-- [ ] **v2.0 (Enterprise):** Private VPC subnets with NAT gateways, AWS WAF integration, and automated compliance scanning.
+- [x] **Core MVP:** Interactive CLI, ECS Fargate + ALB Terraform generation, CI/CD, and Secrets sync.
+- [x] **Production Readiness:** CloudFront distribution, S3 State locking, and OIDC security.
+- [x] **Smart Experience:** Zero-config framework auto-discovery for Next.js, Express, and FastAPI.
+- [ ] **State & Storage:** Automated RDS PostgreSQL provisioning and persistent volumes.
+- [ ] **Advanced Networking:** Custom domains (Route 53), ACM SSL configuration, and environment workspaces (staging/prod).
+- [ ] **Security Hardening:** Private VPC subnets with NAT gateways, and AWS WAF integration.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deploy-stack",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "Provision production-ready AWS infrastructure and CI/CD pipelines in seconds.",
   "type": "module",
   "bin": {
@@ -14,6 +14,27 @@
     "type": "git",
     "url": "git+https://github.com/anton-codes-iac/deploy-stack.git"
   },
+  "homepage": "https://github.com/anton-codes-iac/deploy-stack#readme",
+  "bugs": {
+    "url": "https://github.com/anton-codes-iac/deploy-stack/issues"
+  },
+  "keywords": [
+    "aws",
+    "terraform",
+    "github-actions",
+    "ci-cd",
+    "ecs",
+    "fargate",
+    "nextjs-deployment",
+    "infrastructure-as-code",
+    "oidc",
+    "deploy-stack",
+    "expressjs",
+    "fastapi",
+    "nextjs",
+    "static-site",
+    "nginx"
+  ],
   "license": "MIT",
   "dependencies": {
     "@aws-sdk/client-s3": "3.1115.0",

package/src/commands/init.js

@@ -4,10 +4,11 @@ import fsSync from 'fs';
 import fs from 'fs/promises';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { intro, outro, group, text, select, spinner, cancel, confirm } from '@clack/prompts';
+import { intro, outro, group, text, select, spinner, cancel, confirm, log } from '@clack/prompts';
 import color from 'picocolors';
 
 import { checkDependency } from '../utils/system.js';
+import { detectFramework } from '../utils/detector.js';
 import { trackEvent } from '../core/telemetry.js';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -41,18 +42,58 @@ export async function mainStack() {
         process.exit(0);
     }
 
+    const projectName = await text({
+        message: 'What is the name of your project? (Type "." to use current directory)',
+        placeholder: 'my-web-app',
+        validate: (value) => {
+            if (!value) return 'Please enter a name.';
+            if (value !== '.' && value.includes(' ')) return 'Name cannot contain spaces.';
+        },
+    });
+
+    if (typeof projectName === 'symbol') {
+        cancel('Operation cancelled.');
+        process.exit(0);
+    }
+
+    const actualProjectName = projectName === '.' ? path.basename(process.cwd()) : projectName;
+    const targetDir = projectName === '.' ? process.cwd() : path.join(process.cwd(), projectName);
+
+    // 2.5 Run the scanner
+    const detectedFramework = detectFramework(targetDir);
+    if (detectedFramework) {
+        log.success(`Auto-detected framework: ${detectedFramework.name}`);
+    }
+
+    // 2.6 Resolve the framework
+    let finalFramework = detectedFramework ? detectedFramework.id : null;
+
+    if (!finalFramework) {
+        finalFramework = await select({
+            message: 'Which framework preset should we configure?',
+            options: [
+                { value: 'node', label: 'Node.js / Express' },
+                { value: 'nextjs', label: 'Next.js (Standalone)' },
+                { value: 'python', label: 'Python FastAPI' },
+                { value: 'static', label: 'Static Site (Gatsby, React, plain HTML via Nginx)' },
+            ],
+        });
+
+        if (typeof finalFramework === 'symbol') {
+            cancel('Operation cancelled.');
+            process.exit(0);
+        }
+    }
+
+    // 2.7 Set intelligent defaults
+    let defaultPort = '3000';
+
+    if (finalFramework === 'static') defaultPort = '80';
+    if (finalFramework === 'python') defaultPort = '8000';
+
     // 3. Prompt Configuration Group
     const project = await group(
         {
-            name: () =>
-                text({
-                    message: 'What is the name of your project? (Type "." to use current directory)',
-                    placeholder: 'my-web-app',
-                    validate: (value) => {
-                        if (!value) return 'Please enter a name.';
-                        if (value !== '.' && value.includes(' ')) return 'Name cannot contain spaces.';
-                    },
-                }),
             region: () =>
                 select({
                     message: 'Which AWS region do you want to deploy to?',
@@ -67,11 +108,13 @@ export async function mainStack() {
             port: () =>
                 text({
                     message: 'What port does your container expose?',
-                    placeholder: '3000',
-                    defaultValue: '3000',
+                    placeholder: defaultPort,
+                    defaultValue: defaultPort,
                 }),
-            framework: () =>
-                select({
+            framework: () => {
+                if (detectedFramework) return undefined;
+
+                return select({
                     message: 'Which framework preset should we configure?',
                     options: [
                         { value: 'node', label: 'Node.js / Express' },
@@ -79,7 +122,8 @@ export async function mainStack() {
                         { value: 'python', label: 'Python FastAPI' },
                         { value: 'static', label: 'Static Site (Gatsby, React, plain HTML via Nginx)' },
                     ],
-                }),
+                });
+            },
             size: () =>
                 select({
                     message: 'Select your Fargate compute size:',
@@ -126,9 +170,6 @@ export async function mainStack() {
     );
 
     // 4. Map the user's choices and update the variables
-    const actualProjectName = project.name === '.' ? path.basename(process.cwd()) : project.name;
-    const targetDir = project.name === '.' ? process.cwd() : path.join(process.cwd(), project.name);
-
     const cpu = project.size === 'small' ? '512' : '256';
     const memory = project.size === 'small' ? '1024' : '512';
 
@@ -212,7 +253,7 @@ export async function mainStack() {
     const tfOidcPath = path.join(__dirname, '../../templates', 'terraform', 'oidc.tf');
     const tfBackendPath = path.join(__dirname, '../../templates', 'terraform', 'backend.tf');
     const tfCloudfrontPath = path.join(__dirname, '../../templates', 'terraform', 'cloudfront.tf');
-    const dockerTemplatePath = path.join(__dirname, '../../templates', 'docker', `${project.framework}.Dockerfile`);
+    const dockerTemplatePath = path.join(__dirname, '../../templates', 'docker', `${finalFramework}.Dockerfile`);
     const githubActionPath = path.join(__dirname, '../../templates', 'github', 'deploy.yml');
     const readmePath = path.join(__dirname, '../../templates', 'README.md');
     const gitignorePath = path.join(__dirname, '../../templates', '_gitignore');
@@ -293,7 +334,7 @@ export async function mainStack() {
     // 11. Track the event in telemetry
     trackEvent('project_provisioned', {
         projectName: actualProjectName,
-        framework: project.framework,
+        framework: finalFramework,
         region: project.region,
         size: project.size,
         setup_mode: setupType,
@@ -306,7 +347,7 @@ export async function mainStack() {
     // 12. Provide the Outro, Framework Warnings and Next Steps
     let frameworkWarnings = '';
 
-    if (project.framework === 'nextjs') {
+    if (finalFramework === 'nextjs') {
         frameworkWarnings =
             color.bgYellow(color.black(' ⚠️  IMPORTANT: NEXT.JS SETUP REQUIRED ')) +
             color.yellow('\n    You must modify your next.config file and create a health check route before deploying.') +

package/src/core/telemetry.js

@@ -2,7 +2,7 @@ import crypto from 'crypto';
 
 const TELEMETRY_ENDPOINT = 'https://app.posthog.com/capture';
 
-const POSTHOG_API_KEY = '___POSTHOG_INGESTION_KEY___';
+const POSTHOG_API_KEY = 'phc_o2wgA3jVT9rVDiGSDzFAR42zZeiVGhhCY53HXVHUcYGT';
 
 export function trackEvent(eventName, properties) {
     // 1. Respect privacy standards

package/src/utils/detector.js

@@ -0,0 +1,35 @@
+import fsSync from 'fs';
+import path from 'path';
+
+export function detectFramework(targetDir) {
+    const packageJsonPath = path.join(targetDir, 'package.json');
+    const requirementsTxtPath = path.join(targetDir, 'requirements.txt');
+
+    // 1. Detect Node.js Frameworks
+    if (fsSync.existsSync(packageJsonPath)) {
+        try {
+            const pkg = JSON.parse(fsSync.readFileSync(packageJsonPath, 'utf-8'));
+            // Merge dependencies and devDependencies to check both
+            const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+
+            if (deps['next']) return { id: 'nextjs', name: 'Next.js' };
+            if (deps['gatsby'] || deps['react-scripts'] || deps['vue']) return { id: 'static', name: 'Static Site' };
+            if (deps['express']) return { id: 'node', name: 'Node.js / Express' };
+        } catch (e) {
+            // Silently fail if package.json is malformed
+        }
+    }
+
+    // 2. Detect Python Frameworks
+    if (fsSync.existsSync(requirementsTxtPath)) {
+        try {
+            const reqs = fsSync.readFileSync(requirementsTxtPath, 'utf-8').toLowerCase();
+            if (reqs.includes('fastapi')) return { id: 'python', name: 'Python FastAPI' };
+        } catch (e) {
+            // Silently fail
+        }
+    }
+
+    // 3. Fallback
+    return null;
+}