feat: add nextjs-app example template

crates/alien-cli/src/commands/init.rs

@@ -58,6 +58,10 @@ const KNOWN_TEMPLATES: &[(&str, &str)] = &[
         "webhook-api-ts",
         "Receive webhooks and expose an API inside the customer's cloud.",
     ),
+    (
+        "nextjs-app",
+        "Deploy a Next.js app as a single container in the customer's cloud.",
+    ),
 ];
 
 fn fallback_templates() -> Vec<TemplateInfo> {

examples/README.md

@@ -10,6 +10,7 @@ Each example is a self-contained template you can initialize with `alien init`.
 | [data-connector-ts](./data-connector-ts) | Query private databases behind the customer's firewall. | TypeScript |
 | [event-pipeline-ts](./event-pipeline-ts) | Process events from queues, storage changes, and cron schedules. | TypeScript |
 | [webhook-api-ts](./webhook-api-ts) | Receive webhooks and expose an API inside the customer's cloud. | TypeScript |
+| [nextjs-app](./nextjs-app) | Deploy a Next.js app as a single container in the customer's cloud. | TypeScript |
 
 ## Getting started
 

examples/nextjs-app/.dockerignore

@@ -0,0 +1,6 @@
+node_modules
+.next
+.alien
+alien.ts
+template.toml
+README.md

examples/nextjs-app/.gitignore

@@ -0,0 +1,14 @@
+# Node
+node_modules/
+package-lock.json
+pnpm-lock.yaml
+
+# Next.js
+.next/
+next-env.d.ts
+
+# Alien
+.alien/
+
+# OS
+.DS_Store

examples/nextjs-app/Dockerfile

@@ -0,0 +1,19 @@
+FROM node:22-alpine AS build
+WORKDIR /app
+COPY package.json package-lock.json* ./
+RUN npm install
+COPY . .
+RUN npm run build
+
+FROM node:22-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+# .next/static and public are not part of the standalone output and must be
+# copied alongside it for server.js to serve them.
+COPY --from=build /app/.next/standalone ./
+COPY --from=build /app/.next/static ./.next/static
+COPY --from=build /app/public ./public
+ENV HOSTNAME=0.0.0.0
+ENV PORT=3000
+EXPOSE 3000
+CMD ["node", "server.js"]

examples/nextjs-app/README.md

@@ -0,0 +1,43 @@
+# Next.js App
+
+The smallest containerized Next.js app: one container, one page, one API route. Use it as the starting point for dashboards, internal tools, or any web app that needs to run where the customer's data lives.
+
+The app builds with the included Dockerfile (Next.js [standalone output](https://nextjs.org/docs/app/api-reference/config/next-config-js/output)) and runs as a single replica behind an HTTPS load balancer.
+
+## What's included
+
+| Resource | Type | Description |
+|----------|------|-------------|
+| `app` | Container | The Next.js app, built from the Dockerfile and exposed over HTTP |
+
+## Local development
+
+Run the Next.js dev server directly:
+
+```bash
+npm install
+npm run dev
+```
+
+Then check it works:
+
+```bash
+curl http://localhost:3000/api/health
+# {"status":"ok"}
+
+open http://localhost:3000
+```
+
+## Deploying
+
+```bash
+alien deploy production --platform aws   # or gcp / azure
+```
+
+Alien builds the container image from the Dockerfile, pushes it, and provisions the compute and load balancer. The deploy output prints the public URL.
+
+## Learn more
+
+- [Quickstart guide](https://alien.dev/docs/quickstart) -- build a worker, test locally, send remote commands
+- [How Alien Works](https://alien.dev/docs/how-alien-works) -- stacks, isolated areas, push vs pull
+- [Stacks](https://alien.dev/docs/stacks) -- workers, storage, queues, vaults

examples/nextjs-app/alien.ts

@@ -0,0 +1,18 @@
+import * as alien from "@alienplatform/core"
+
+const app = new alien.Container("app")
+  .code({ type: "source", src: ".", toolchain: { type: "docker", dockerfile: "Dockerfile" } })
+  .cpu(0.5)
+  .memory("512Mi")
+  .port(3000)
+  .expose("http")
+  // Next's standalone server reads these; HOSTNAME=0.0.0.0 binds all interfaces.
+  .environment({ PORT: "3000", HOSTNAME: "0.0.0.0" })
+  .permissions("app")
+  .build()
+
+export default new alien.Stack("nextjs-app")
+  .platforms(["aws", "gcp", "azure"])
+  .add(app, "live")
+  .permissions({ profiles: { app: {} } }) // no linked resources → empty profile
+  .build()

examples/nextjs-app/app/api/health/route.ts

@@ -0,0 +1,3 @@
+export async function GET() {
+  return Response.json({ status: "ok" })
+}

examples/nextjs-app/app/layout.tsx

@@ -0,0 +1,15 @@
+import type { Metadata } from "next"
+import type { ReactNode } from "react"
+
+export const metadata: Metadata = {
+  title: "Next.js on Alien",
+  description: "The smallest containerized Next.js app deployed with Alien.",
+}
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}

examples/nextjs-app/app/page.tsx

@@ -0,0 +1,14 @@
+export default function Home() {
+  return (
+    <main style={{ fontFamily: "sans-serif", maxWidth: "40rem", margin: "4rem auto" }}>
+      <h1>Next.js on Alien</h1>
+      <p>
+        This app runs as a single container inside the cloud account it was deployed to. Edit{" "}
+        <code>app/page.tsx</code> and redeploy to ship changes.
+      </p>
+      <p>
+        Try the API route at <a href="/api/health">/api/health</a>.
+      </p>
+    </main>
+  )
+}

examples/nextjs-app/next.config.ts

@@ -0,0 +1,8 @@
+import type { NextConfig } from "next"
+
+const nextConfig: NextConfig = {
+  // The container runs the generated .next/standalone/server.js without node_modules.
+  output: "standalone",
+}
+
+export default nextConfig

examples/nextjs-app/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "nextjs-app",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build"
+  },
+  "dependencies": {
+    "next": "^16.2.9",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@alienplatform/core": "^1.7.0",
+    "@types/node": "^24.0.15",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "typescript": "^5.8.3"
+  }
+}

examples/nextjs-app/public/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Allow: /

examples/nextjs-app/template.toml

@@ -0,0 +1,3 @@
+name = "nextjs-app"
+description = "Deploy a Next.js app as a single container in the customer's cloud."
+language = "TypeScript"

examples/nextjs-app/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}