@thunder-so/thunder 1.3.1 → 1.3.2

package/docs/frameworks/nextjs-static.md

@@ -0,0 +1,160 @@
+# Deploy Next.js Static Export to AWS S3 + CloudFront
+
+Host your Next.js app as a static site on AWS using Thunder's `Static` construct. This guide covers static export mode - no server required, just HTML, CSS, and JavaScript served from [S3](https://aws.amazon.com/s3/) through [CloudFront](https://aws.amazon.com/cloudfront/).
+
+Perfect for marketing sites, blogs, documentation, and SPAs that don't need server-side rendering.
+
+## 1. Create a New Next.js Project
+
+```bash
+bunx create-next-app@latest my-nextjs-app
+cd my-nextjs-app
+```
+
+When prompted:
+- TypeScript: Yes
+- ESLint: Yes
+- Tailwind CSS: Yes (optional)
+- `src/` directory: No (optional)
+- App Router: Yes
+- Turbopack: Yes (optional)
+- Import alias: `@/*` (default)
+
+Reference: [Next.js Installation Docs](https://nextjs.org/docs/getting-started/installation)
+
+## 2. Configure Static Export
+
+Edit `next.config.ts`:
+
+```typescript
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  output: 'export',
+  // Optional: change output directory from 'out' to 'dist'
+  distDir: 'dist',
+};
+
+export default nextConfig;
+```
+
+Reference: [Next.js Static Exports](https://nextjs.org/docs/app/guides/static-exports)
+
+## 3. Build Your App
+
+```bash
+bun run build
+```
+
+This generates static files in the `dist/` directory (or `out/` if you didn't set `distDir`).
+
+## 4. Install Thunder
+
+```bash
+bun add @thunder-so/thunder --development
+```
+
+## 5. Create Stack File
+
+Create `stack/prod.ts`:
+
+```typescript
+import { Cdk, Static, type StaticProps } from '@thunder-so/thunder';
+
+const config: StaticProps = {
+  env: {
+    account: '123456789012',  // Your AWS account ID
+    region: 'us-east-1',
+  },
+  application: 'myapp',
+  service: 'web',
+  environment: 'prod',
+
+  rootDir: '.',
+  outputDir: 'dist',  // Match your next.config.ts distDir
+};
+
+new Static(
+  new Cdk.App(),
+  `${config.application}-${config.service}-${config.environment}-stack`,
+  config
+);
+```
+
+## 6. Deploy
+
+```bash
+npx cdk deploy --app "npx tsx stack/prod.ts" --profile default
+```
+
+CDK outputs the CloudFront URL:
+
+```
+Outputs:
+myapp-web-prod-stack.DistributionUrl = https://d1234abcd.cloudfront.net
+```
+
+## Custom Domain (Optional)
+
+1. [Create a Route53 Hosted Zone](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/AboutHZWorkingWith.html)
+2. [Request an ACM certificate](https://docs.aws.amazon.com/acm/latest/userguide/gs-acm-request-public.html) in **`us-east-1`**
+
+Update your stack:
+
+```typescript
+const config: StaticProps = {
+  // ...
+  domain: 'app.example.com',
+  globalCertificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/abc-123',
+  hostedZoneId: 'Z1234567890ABC',
+};
+```
+
+## Redirects and Rewrites
+
+Add URL redirects or rewrites using Lambda@Edge:
+
+```typescript
+const config: StaticProps = {
+  // ...
+  redirects: [
+    { source: '/old-page', destination: '/new-page' },
+  ],
+  rewrites: [
+    { source: '/app/*', destination: '/index.html' },  // SPA fallback
+  ],
+};
+```
+
+See [static-edge-functions.md](../static-edge-functions.md) for pattern syntax.
+
+## Custom Headers
+
+Add security or cache headers:
+
+```typescript
+const config: StaticProps = {
+  // ...
+  headers: [
+    { path: '/assets/*', name: 'Cache-Control', value: 'public, max-age=31536000, immutable' },
+  ],
+};
+```
+
+## Limitations of Static Export
+
+Next.js static export doesn't support:
+- Server-side rendering (SSR)
+- API routes
+- Image optimization (use `unoptimized: true` in `next.config.ts`)
+- Incremental Static Regeneration (ISR)
+- Dynamic routes without `generateStaticParams`
+
+For these features, use [Next.js on Fargate](./nextjs-fargate-dockerfile.md) instead.
+
+## Related
+
+- [static-basic.md](../static-basic.md) - Static construct reference
+- [static-edge-functions.md](../static-edge-functions.md) - Redirects, rewrites, headers
+- [static-full.md](../static-full.md) - Full configuration reference
+- [nextjs-fargate-dockerfile.md](./nextjs-fargate-dockerfile.md) - Next.js with SSR on Fargate

package/docs/frameworks/nuxt-fargate.md

@@ -0,0 +1,115 @@
+# Deploy Nuxt to AWS Fargate
+
+Run your Nuxt app with full SSR support on [AWS ECS Fargate](https://aws.amazon.com/fargate/) using Thunder's `Fargate` construct.
+
+## 1. Create a New Nuxt Project
+
+```bash
+bunx nuxi@latest init my-nuxt-app
+cd my-nuxt-app
+```
+
+Reference: [Nuxt Installation Docs](https://nuxt.com/docs/getting-started/installation)
+
+## 2. Create Dockerfile
+
+```dockerfile
+FROM oven/bun:latest AS builder
+WORKDIR /app
+
+COPY package.json bun.lockb ./
+RUN bun install --frozen-lockfile
+
+COPY . .
+RUN bun run build
+
+FROM oven/bun:latest AS runner
+WORKDIR /app
+
+ENV NODE_ENV=production
+ENV HOST=0.0.0.0
+ENV PORT=3000
+
+COPY --from=builder /app/.output ./
+
+EXPOSE 3000
+
+CMD ["bun", "run", "server/index.mjs"]
+```
+
+## 3. Install Thunder
+
+```bash
+bun add @thunder-so/thunder --development
+```
+
+## 4. Create Stack File
+
+Create `stack/prod.ts`:
+
+```typescript
+import { Cdk, Fargate, type FargateProps } from '@thunder-so/thunder';
+
+const config: FargateProps = {
+  env: {
+    account: '123456789012',
+    region: 'us-east-1',
+  },
+  application: 'myapp',
+  service: 'web',
+  environment: 'prod',
+  rootDir: '.',
+
+  serviceProps: {
+    dockerFile: 'Dockerfile',
+    architecture: Cdk.aws_ecs.CpuArchitecture.ARM64,
+    cpu: 512,
+    memorySize: 1024,
+    port: 3000,
+    desiredCount: 1,
+    healthCheckPath: '/',
+  },
+};
+
+new Fargate(
+  new Cdk.App(),
+  `${config.application}-${config.service}-${config.environment}-stack`,
+  config
+);
+```
+
+## 5. Deploy
+
+```bash
+npx cdk deploy --app "npx tsx stack/prod.ts" --profile default
+```
+
+## Custom Domain with HTTPS
+
+```typescript
+const config: FargateProps = {
+  // ...
+  domain: 'app.example.com',
+  regionalCertificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/abc-123',
+  hostedZoneId: 'Z1234567890ABC',
+};
+```
+
+## Environment Variables
+
+```typescript
+serviceProps: {
+  // ...
+  variables: [
+    { NODE_ENV: 'production' },
+  ],
+  secrets: [
+    { key: 'DATABASE_URL', resource: 'arn:aws:secretsmanager:us-east-1:123456789012:secret:/myapp/db-abc123' },
+  ],
+},
+```
+
+## Related
+
+- [fargate-basic.md](../fargate-basic.md) - Fargate construct reference
+- [nuxt-serverless.md](./nuxt-serverless.md) - Nuxt on Lambda

package/docs/frameworks/nuxt-serverless.md

@@ -0,0 +1,122 @@
+# Deploy Nuxt to AWS Lambda + S3 + CloudFront
+
+Deploy your Nuxt app with server-side rendering to AWS using Thunder's `Nuxt` construct. This creates a hybrid architecture: [Lambda](https://aws.amazon.com/lambda/) handles SSR and API routes, [S3](https://aws.amazon.com/s3/) hosts static assets, and [CloudFront](https://aws.amazon.com/cloudfront/) unifies both.
+
+## 1. Create a New Nuxt Project
+
+```bash
+bunx nuxi@latest init my-nuxt-app
+cd my-nuxt-app
+```
+
+Reference: [Nuxt Installation Docs](https://nuxt.com/docs/getting-started/installation)
+
+## 2. Configure Nitro for AWS Lambda
+
+Nuxt uses [Nitro](https://nitro.unjs.io/) for server-side rendering. Set the `aws-lambda` preset via environment variable:
+
+Create `.env`:
+
+```bash
+NITRO_PRESET=aws-lambda
+```
+
+Or set it in `nuxt.config.ts`:
+
+```typescript
+export default defineNuxtConfig({
+  nitro: {
+    preset: 'aws-lambda',
+  },
+});
+```
+
+Reference: [Nitro AWS Lambda Preset](https://nitro.build/deploy/providers/aws)
+
+## 3. Build Your App
+
+```bash
+bun run build
+```
+
+This generates:
+- `.output/server/` - Lambda handler
+- `.output/public/` - Static assets for S3
+
+## 4. Install Thunder
+
+```bash
+bun add @thunder-so/thunder --development
+```
+
+## 5. Create Stack File
+
+Create `stack/prod.ts`:
+
+```typescript
+import { Cdk, Nuxt, type NuxtProps } from '@thunder-so/thunder';
+
+const config: NuxtProps = {
+  env: {
+    account: '123456789012',
+    region: 'us-east-1',
+  },
+  application: 'myapp',
+  service: 'web',
+  environment: 'prod',
+  rootDir: '.',
+};
+
+new Nuxt(
+  new Cdk.App(),
+  `${config.application}-${config.service}-${config.environment}-stack`,
+  config
+);
+```
+
+## 6. Deploy
+
+```bash
+npx cdk deploy --app "npx tsx stack/prod.ts" --profile default
+```
+
+## Custom Domain
+
+```typescript
+const config: NuxtProps = {
+  // ...
+  domain: 'app.example.com',
+  hostedZoneId: 'Z1234567890ABC',
+  globalCertificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/abc-123',
+  regionalCertificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/def-456',
+};
+```
+
+## Environment Variables
+
+```typescript
+serverProps: {
+  variables: [
+    { NODE_ENV: 'production' },
+  ],
+  secrets: [
+    { key: 'DATABASE_URL', resource: 'arn:aws:secretsmanager:us-east-1:123456789012:secret:/myapp/db-abc123' },
+  ],
+},
+```
+
+## Performance Tuning
+
+```typescript
+serverProps: {
+  memorySize: 1792,
+  timeout: 10,
+  keepWarm: true,
+  tracing: true,
+},
+```
+
+## Related
+
+- [serverless.md](../serverless.md) - Serverless construct overview
+- [lambda-basic.md](../lambda-basic.md) - Lambda construct reference

package/docs/frameworks/solidstart-fargate.md

@@ -0,0 +1,115 @@
+# Deploy Solid Start to AWS Fargate
+
+Run your Solid Start app with full SSR support on [AWS ECS Fargate](https://aws.amazon.com/fargate/) using Thunder's `Fargate` construct.
+
+## 1. Create a New Solid Start Project
+
+```bash
+bunx create-solid@latest my-solid-app
+cd my-solid-app
+```
+
+Reference: [Solid Start Getting Started](https://docs.solidjs.com/solid-start/getting-started)
+
+## 2. Create Dockerfile
+
+```dockerfile
+FROM oven/bun:latest AS builder
+WORKDIR /app
+
+COPY package.json bun.lockb ./
+RUN bun install --frozen-lockfile
+
+COPY . .
+RUN bun run build
+
+FROM oven/bun:latest AS runner
+WORKDIR /app
+
+ENV NODE_ENV=production
+ENV HOST=0.0.0.0
+ENV PORT=3000
+
+COPY --from=builder /app/.output ./
+
+EXPOSE 3000
+
+CMD ["bun", "run", "server/index.mjs"]
+```
+
+## 3. Install Thunder
+
+```bash
+bun add @thunder-so/thunder --development
+```
+
+## 4. Create Stack File
+
+Create `stack/prod.ts`:
+
+```typescript
+import { Cdk, Fargate, type FargateProps } from '@thunder-so/thunder';
+
+const config: FargateProps = {
+  env: {
+    account: '123456789012',
+    region: 'us-east-1',
+  },
+  application: 'myapp',
+  service: 'web',
+  environment: 'prod',
+  rootDir: '.',
+
+  serviceProps: {
+    dockerFile: 'Dockerfile',
+    architecture: Cdk.aws_ecs.CpuArchitecture.ARM64,
+    cpu: 512,
+    memorySize: 1024,
+    port: 3000,
+    desiredCount: 1,
+    healthCheckPath: '/',
+  },
+};
+
+new Fargate(
+  new Cdk.App(),
+  `${config.application}-${config.service}-${config.environment}-stack`,
+  config
+);
+```
+
+## 5. Deploy
+
+```bash
+npx cdk deploy --app "npx tsx stack/prod.ts" --profile default
+```
+
+## Custom Domain with HTTPS
+
+```typescript
+const config: FargateProps = {
+  // ...
+  domain: 'app.example.com',
+  regionalCertificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/abc-123',
+  hostedZoneId: 'Z1234567890ABC',
+};
+```
+
+## Environment Variables
+
+```typescript
+serviceProps: {
+  // ...
+  variables: [
+    { NODE_ENV: 'production' },
+  ],
+  secrets: [
+    { key: 'DATABASE_URL', resource: 'arn:aws:secretsmanager:us-east-1:123456789012:secret:/myapp/db-abc123' },
+  ],
+},
+```
+
+## Related
+
+- [fargate-basic.md](../fargate-basic.md) - Fargate construct reference
+- [solidstart-serverless.md](./solidstart-serverless.md) - Solid Start on Lambda

package/docs/frameworks/solidstart-serverless.md

@@ -0,0 +1,116 @@
+# Deploy Solid Start to AWS Lambda + S3 + CloudFront
+
+Deploy your Solid Start app with server-side rendering to AWS using Thunder's `SolidStart` construct. This creates a hybrid architecture: [Lambda](https://aws.amazon.com/lambda/) handles SSR and API routes, [S3](https://aws.amazon.com/s3/) hosts static assets, and [CloudFront](https://aws.amazon.com/cloudfront/) unifies both.
+
+## 1. Create a New Solid Start Project
+
+```bash
+bunx create-solid@latest my-solid-app
+cd my-solid-app
+```
+
+Reference: [Solid Start Getting Started](https://docs.solidjs.com/solid-start/getting-started)
+
+## 2. Configure Nitro for AWS Lambda
+
+Solid Start uses [Nitro](https://nitro.unjs.io/) for server-side rendering. Set the `aws-lambda` preset in `app.config.ts`:
+
+```typescript
+import { defineConfig } from '@solidjs/start/config';
+
+export default defineConfig({
+  server: {
+    preset: 'aws-lambda',
+  },
+});
+```
+
+Reference: [Nitro AWS Lambda Preset](https://nitro.build/deploy/providers/aws)
+
+## 3. Build Your App
+
+```bash
+bun run build
+```
+
+This generates:
+- `.output/server/` - Lambda handler
+- `.output/public/` - Static assets for S3
+
+## 4. Install Thunder
+
+```bash
+bun add @thunder-so/thunder --development
+```
+
+## 5. Create Stack File
+
+Create `stack/prod.ts`:
+
+```typescript
+import { Cdk, SolidStart, type SolidStartProps } from '@thunder-so/thunder';
+
+const config: SolidStartProps = {
+  env: {
+    account: '123456789012',
+    region: 'us-east-1',
+  },
+  application: 'myapp',
+  service: 'web',
+  environment: 'prod',
+  rootDir: '.',
+};
+
+new SolidStart(
+  new Cdk.App(),
+  `${config.application}-${config.service}-${config.environment}-stack`,
+  config
+);
+```
+
+## 6. Deploy
+
+```bash
+npx cdk deploy --app "npx tsx stack/prod.ts" --profile default
+```
+
+## Custom Domain
+
+```typescript
+const config: SolidStartProps = {
+  // ...
+  domain: 'app.example.com',
+  hostedZoneId: 'Z1234567890ABC',
+  globalCertificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/abc-123',
+  regionalCertificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/def-456',
+};
+```
+
+## Environment Variables
+
+```typescript
+serverProps: {
+  variables: [
+    { NODE_ENV: 'production' },
+  ],
+  secrets: [
+    { key: 'DATABASE_URL', resource: 'arn:aws:secretsmanager:us-east-1:123456789012:secret:/myapp/db-abc123' },
+  ],
+},
+```
+
+## Performance Tuning
+
+```typescript
+serverProps: {
+  memorySize: 1792,
+  timeout: 10,
+  keepWarm: true,
+  tracing: true,
+},
+```
+
+## Related
+
+- [serverless.md](../serverless.md) - Serverless construct overview
+- [lambda-basic.md](../lambda-basic.md) - Lambda construct reference