chore: wip

Author: chrisbbreuer

.gitignore

@@ -41,3 +41,4 @@ stacks.log
 .stx
 .stx-serve
 .env.keys
+/storage/framework/frontend-dist

app/Actions/HealthAction.ts

@@ -0,0 +1,22 @@
+// Simple health check action that doesn't require @stacksjs/actions
+// This overrides the default framework health check
+
+import { route } from '@stacksjs/router'
+
+export default {
+  name: 'Health',
+  description: 'Health check for ECS',
+  path: '/health',
+
+  async handle() {
+    return {
+      status: 'ok',
+      timestamp: Date.now(),
+    }
+  },
+}
+
+// Also register as a route for redundancy
+route.get('/health', () => {
+  return { status: 'ok', timestamp: Date.now() }
+})

config/cloud.ts

@@ -65,12 +65,31 @@ export const tsCloud: TsCloudConfig = {
    * Define your cloud resources here
    */
   infrastructure: {
+    /**
+     * Deployment Mode
+     *
+     * - 'server': Traditional EC2-based deployment (Forge-style)
+     *   - EC2 instances running your full-stack Bun app
+     *   - Application Load Balancer for traffic distribution
+     *   - Suitable for monolithic applications
+     *
+     * - 'serverless': Container + static site deployment (Vapor-style)
+     *   - ECS Fargate for API (Bun running in containers)
+     *   - S3 + CloudFront for frontend (static assets)
+     *   - Better cost optimization and auto-scaling
+     */
+    mode: 'serverless', // 'server' | 'serverless'
+
     /**
      * Compute Configuration
      *
-     * Defines the instances running your Stacks/Bun application.
+     * For mode: 'server'
+     * Defines the EC2 instances running your Stacks/Bun application.
      * When instances > 1, load balancer is automatically enabled.
      *
+     * For mode: 'serverless'
+     * These settings are not used. See 'containers' configuration instead.
+     *
      * @example Single instance (development/staging)
      * compute: { instances: 1, size: 'micro' }
      *
@@ -124,6 +143,53 @@ export const tsCloud: TsCloudConfig = {
       // },
     },
 
+    /**
+     * Container Configuration (for serverless mode only)
+     *
+     * Defines ECS Fargate containers running your Bun API.
+     * Only used when mode: 'serverless'.
+     *
+     * @example Basic API container
+     * containers: {
+     *   api: {
+     *     cpu: 256,    // 0.25 vCPU
+     *     memory: 512, // 512 MB
+     *     port: 3000,
+     *     healthCheck: '/health',
+     *   }
+     * }
+     *
+     * @example Production API with auto-scaling
+     * containers: {
+     *   api: {
+     *     cpu: 512,
+     *     memory: 1024,
+     *     port: 3000,
+     *     desiredCount: 2,
+     *     autoScaling: {
+     *       min: 2,
+     *       max: 10,
+     *       targetCpuUtilization: 70,
+     *     },
+     *   }
+     * }
+     */
+    containers: {
+      api: {
+        cpu: 512, // 256, 512, 1024, 2048, 4096
+        memory: 1024, // Must be compatible with CPU (512 MB - 16 GB)
+        port: 3000,
+        healthCheck: '/health',
+        desiredCount: 2,
+        autoScaling: {
+          min: 1,
+          max: 10,
+          targetCpuUtilization: 70,
+          targetMemoryUtilization: 80,
+        },
+      },
+    },
+
     /**
      * Load Balancer Configuration
      *

routes/api.ts

@@ -24,7 +24,7 @@ route.post('/verify-authentication', 'Actions/Auth/VerifyAuthenticationAction')
 route.get('/coming-soon', 'Controllers/ComingSoonController@index')
 
 // route.email('/welcome')
-route.health() // adds a GET `/health` route
+await route.health() // adds a GET `/health` route
 route.get('/install', 'Actions/InstallAction')
 route.post('/ai/ask', 'Actions/AI/AskAction')
 route.post('/ai/summary', 'Actions/AI/SummaryAction')