create-lumen 2.0.0-beta.1 → 2.0.0-beta.2

package/templates/conditional/database/prisma/seed.js

@@ -0,0 +1,16 @@
+const { PrismaClient } = require("@prisma/client");
+
+const prisma = new PrismaClient();
+
+async function main() {
+  console.log("Database seeded successfully");
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });

package/templates/conditional/database/prisma/seed.ts

@@ -0,0 +1,16 @@
+import { PrismaClient } from "@prisma/client";
+
+const prisma = new PrismaClient();
+
+async function main() {
+  console.log("Database seeded successfully");
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });

package/templates/conditional/docker/.dockerignore

@@ -0,0 +1,10 @@
+node_modules
+.next
+.git
+.gitignore
+.env*
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+README.md

package/templates/conditional/docker/Dockerfile

@@ -0,0 +1,57 @@
+FROM node:22-alpine AS base
+
+# Install dependencies only when needed
+FROM base AS deps
+# Check https://github.com/nodejs/docker-node/tree/b4117f9333da4138b03a546ec926ef50a31506c3#nodealpine to understand why libc6-compat might be needed.
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+
+# Install dependencies based on the preferred package manager
+COPY package.json package-lock.json* yarn.lock* pnpm-lock.yaml* bun.lockb* bun.lock* ./
+RUN \
+  if [ -f yarn.lock ]; then yarn --frozen-lockfile; \
+  elif [ -f pnpm-lock.yaml ]; then corepack enable pnpm && pnpm i --frozen-lockfile; \
+  elif [ -f package-lock.json ]; then npm ci; \
+  elif [ -f bun.lockb ] || [ -f bun.lock ]; then corepack enable bun && bun install --frozen-lockfile; \
+  else npm i; \
+  fi
+
+# Rebuild the source code only when needed
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+
+# Next.js collects completely anonymous telemetry data about general usage.
+# Learn more here: https://nextjs.org/telemetry
+# Uncomment the following line in case you want to disable telemetry during the build.
+ENV NEXT_TELEMETRY_DISABLED=1
+
+RUN npm run build
+
+# Production image, copy all the files and run next
+FROM base AS runner
+WORKDIR /app
+
+ENV NODE_ENV=production
+# Uncomment the following line in case you want to disable telemetry during runtime.
+ENV NEXT_TELEMETRY_DISABLED=1
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+COPY --chown=nextjs:nodejs public ./public
+
+# Automatically leverage output traces to reduce image size
+# https://nextjs.org/docs/advanced-features/output-file-tracing
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+
+EXPOSE 3000
+
+ENV PORT=3000
+ENV HOSTNAME="0.0.0.0"
+
+CMD ["node", "server.js"]

package/templates/conditional/docker/docker-compose.yml

@@ -0,0 +1,35 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    restart: always
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+      - PORT=3000
+      - DATABASE_URL=postgresql://postgres:postgres@db:5432/app?schema=public
+    depends_on:
+      db:
+        condition: service_healthy
+
+  db:
+    image: postgres:16-alpine
+    restart: always
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: app
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres -d app"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres_data:

package/templates/conditional/next/route-groups/js/src/app/(admin)/layout.jsx

@@ -0,0 +1,23 @@
+import Link from "next/link";
+
+export default function AdminLayout({ children }) {
+  return (
+    <div className="min-h-screen flex flex-col">
+      <header className="bg-red-700 text-white px-6 py-3 flex items-center justify-between text-sm">
+        <div className="font-semibold flex items-center gap-2">
+          <span className="inline-block w-2 h-2 rounded-full bg-white animate-pulse" />
+          Admin Panel (Restricted Access)
+        </div>
+        <nav className="flex gap-4">
+          <Link href="/admin" className="underline hover:no-underline">
+            Management
+          </Link>
+          <Link href="/dashboard" className="underline hover:no-underline">
+            Exit to Dashboard
+          </Link>
+        </nav>
+      </header>
+      <main className="flex-1 p-8 bg-gray-100 dark:bg-gray-900">{children}</main>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/js/src/app/(auth)/layout.jsx

@@ -0,0 +1,17 @@
+import Link from "next/link";
+
+export default function AuthLayout({ children }) {
+  return (
+    <div className="min-h-screen flex flex-col justify-center items-center bg-gray-50 dark:bg-gray-950 p-4">
+      <div className="w-full max-w-md bg-white dark:bg-gray-900 shadow-md rounded-lg p-6 border border-gray-200 dark:border-gray-800">
+        <div className="mb-6 text-center">
+          <Link href="/" className="text-xl font-bold">
+            Lumen Authentication
+          </Link>
+          <p className="text-sm text-gray-500 mt-1">Sign in to your account</p>
+        </div>
+        {children}
+      </div>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/js/src/app/(private)/layout.jsx

@@ -0,0 +1,27 @@
+import Link from "next/link";
+
+export default function PrivateLayout({ children }) {
+  return (
+    <div className="min-h-screen flex">
+      <aside className="w-64 border-r bg-gray-50 dark:bg-gray-950 p-6 flex flex-col justify-between">
+        <div>
+          <div className="font-bold text-lg mb-6">
+            <Link href="/dashboard">Private Dashboard</Link>
+          </div>
+          <nav className="flex flex-col gap-3 text-sm">
+            <Link href="/dashboard" className="text-gray-700 dark:text-gray-200 hover:text-black">
+              Overview
+            </Link>
+            <Link href="/settings" className="text-gray-700 dark:text-gray-200 hover:text-black">
+              Settings
+            </Link>
+          </nav>
+        </div>
+        <div className="text-xs text-gray-400">
+          Protected Area &bull; Authenticated
+        </div>
+      </aside>
+      <main className="flex-1 p-8">{children}</main>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/js/src/app/(public)/layout.jsx

@@ -0,0 +1,28 @@
+import Link from "next/link";
+
+export default function PublicLayout({ children }) {
+  return (
+    <div className="min-h-screen flex flex-col">
+      <header className="border-b px-6 py-4 flex items-center justify-between">
+        <div className="font-bold text-lg">
+          <Link href="/">Lumen App</Link>
+        </div>
+        <nav className="flex gap-4 text-sm">
+          <Link href="/login" className="hover:underline">
+            Sign In
+          </Link>
+          <Link href="/dashboard" className="hover:underline">
+            Dashboard
+          </Link>
+          <Link href="/admin" className="hover:underline">
+            Admin
+          </Link>
+        </nav>
+      </header>
+      <main className="flex-1">{children}</main>
+      <footer className="border-t px-6 py-4 text-center text-sm text-gray-500">
+        Public Area &copy; {new Date().getFullYear()}
+      </footer>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/js/src/app/(public)/page.jsx

@@ -0,0 +1,38 @@
+import Link from "next/link";
+
+export default function PublicPage() {
+  return (
+    <div className="max-w-4xl mx-auto py-12 px-6">
+      <h1 className="text-4xl font-extrabold tracking-tight mb-4">
+        Welcome to Route Groups Preset
+      </h1>
+      <p className="text-lg text-gray-600 mb-8">
+        This application is organized using Next.js App Router route groups:
+        (public), (auth), (private), and (admin).
+      </p>
+      <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+        <div className="border rounded-lg p-6 shadow-sm">
+          <h2 className="text-xl font-semibold mb-2">Auth Group</h2>
+          <p className="text-gray-500 mb-4">Authentication screens and login layouts.</p>
+          <Link href="/login" className="text-blue-600 hover:underline">
+            Go to Login &rarr;
+          </Link>
+        </div>
+        <div className="border rounded-lg p-6 shadow-sm">
+          <h2 className="text-xl font-semibold mb-2">Private Group</h2>
+          <p className="text-gray-500 mb-4">Protected routes guarded by auth proxy middleware.</p>
+          <Link href="/dashboard" className="text-blue-600 hover:underline">
+            Go to Dashboard &rarr;
+          </Link>
+        </div>
+        <div className="border rounded-lg p-6 shadow-sm">
+          <h2 className="text-xl font-semibold mb-2">Admin Group</h2>
+          <p className="text-gray-500 mb-4">Elevated management section requiring admin role.</p>
+          <Link href="/admin" className="text-blue-600 hover:underline">
+            Go to Admin &rarr;
+          </Link>
+        </div>
+      </div>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/js/src/middleware.js

@@ -0,0 +1,48 @@
+import { NextResponse } from "next/server";
+
+/**
+ * Auth Proxy / Route Guard Middleware
+ *
+ * Enforces role-based access control and session verification:
+ * - Unauthenticated requests to private or admin routes redirect to /login
+ * - Authenticated requests lacking the "admin" role redirect away from /admin
+ */
+export function middleware(request) {
+  const { pathname } = request.nextUrl;
+
+  const authToken = request.cookies.get("auth-token")?.value;
+  const userRole = request.cookies.get("user-role")?.value || "user";
+
+  const isAuthRoute = pathname.startsWith("/login") || pathname.startsWith("/register");
+  const isPrivateRoute = pathname.startsWith("/dashboard") || pathname.startsWith("/settings");
+  const isAdminRoute = pathname.startsWith("/admin");
+
+  // If unauthenticated user tries to access protected areas, redirect to /login
+  if ((isPrivateRoute || isAdminRoute) && !authToken) {
+    const loginUrl = new URL("/login", request.url);
+    loginUrl.searchParams.set("from", pathname);
+    return NextResponse.redirect(loginUrl);
+  }
+
+  // If authenticated user without admin role accesses admin area, forbid or redirect to dashboard
+  if (isAdminRoute && userRole !== "admin") {
+    return NextResponse.redirect(new URL("/dashboard", request.url));
+  }
+
+  // If already authenticated user visits auth routes, redirect to dashboard
+  if (isAuthRoute && authToken) {
+    return NextResponse.redirect(new URL("/dashboard", request.url));
+  }
+
+  return NextResponse.next();
+}
+
+export const config = {
+  matcher: [
+    "/dashboard/:path*",
+    "/settings/:path*",
+    "/admin/:path*",
+    "/login",
+    "/register",
+  ],
+};

package/templates/conditional/next/route-groups/ts/src/app/(admin)/layout.tsx

@@ -0,0 +1,28 @@
+import type { ReactNode } from "react";
+import Link from "next/link";
+
+export default function AdminLayout({
+  children,
+}: Readonly<{
+  children: ReactNode;
+}>) {
+  return (
+    <div className="min-h-screen flex flex-col">
+      <header className="bg-red-700 text-white px-6 py-3 flex items-center justify-between text-sm">
+        <div className="font-semibold flex items-center gap-2">
+          <span className="inline-block w-2 h-2 rounded-full bg-white animate-pulse" />
+          Admin Panel (Restricted Access)
+        </div>
+        <nav className="flex gap-4">
+          <Link href="/admin" className="underline hover:no-underline">
+            Management
+          </Link>
+          <Link href="/dashboard" className="underline hover:no-underline">
+            Exit to Dashboard
+          </Link>
+        </nav>
+      </header>
+      <main className="flex-1 p-8 bg-gray-100 dark:bg-gray-900">{children}</main>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/ts/src/app/(auth)/layout.tsx

@@ -0,0 +1,22 @@
+import type { ReactNode } from "react";
+import Link from "next/link";
+
+export default function AuthLayout({
+  children,
+}: Readonly<{
+  children: ReactNode;
+}>) {
+  return (
+    <div className="min-h-screen flex flex-col justify-center items-center bg-gray-50 dark:bg-gray-950 p-4">
+      <div className="w-full max-w-md bg-white dark:bg-gray-900 shadow-md rounded-lg p-6 border border-gray-200 dark:border-gray-800">
+        <div className="mb-6 text-center">
+          <Link href="/" className="text-xl font-bold">
+            Lumen Authentication
+          </Link>
+          <p className="text-sm text-gray-500 mt-1">Sign in to your account</p>
+        </div>
+        {children}
+      </div>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/ts/src/app/(private)/layout.tsx

@@ -0,0 +1,32 @@
+import type { ReactNode } from "react";
+import Link from "next/link";
+
+export default function PrivateLayout({
+  children,
+}: Readonly<{
+  children: ReactNode;
+}>) {
+  return (
+    <div className="min-h-screen flex">
+      <aside className="w-64 border-r bg-gray-50 dark:bg-gray-950 p-6 flex flex-col justify-between">
+        <div>
+          <div className="font-bold text-lg mb-6">
+            <Link href="/dashboard">Private Dashboard</Link>
+          </div>
+          <nav className="flex flex-col gap-3 text-sm">
+            <Link href="/dashboard" className="text-gray-700 dark:text-gray-200 hover:text-black">
+              Overview
+            </Link>
+            <Link href="/settings" className="text-gray-700 dark:text-gray-200 hover:text-black">
+              Settings
+            </Link>
+          </nav>
+        </div>
+        <div className="text-xs text-gray-400">
+          Protected Area &bull; Authenticated
+        </div>
+      </aside>
+      <main className="flex-1 p-8">{children}</main>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/ts/src/app/(public)/layout.tsx

@@ -0,0 +1,33 @@
+import type { ReactNode } from "react";
+import Link from "next/link";
+
+export default function PublicLayout({
+  children,
+}: Readonly<{
+  children: ReactNode;
+}>) {
+  return (
+    <div className="min-h-screen flex flex-col">
+      <header className="border-b px-6 py-4 flex items-center justify-between">
+        <div className="font-bold text-lg">
+          <Link href="/">Lumen App</Link>
+        </div>
+        <nav className="flex gap-4 text-sm">
+          <Link href="/login" className="hover:underline">
+            Sign In
+          </Link>
+          <Link href="/dashboard" className="hover:underline">
+            Dashboard
+          </Link>
+          <Link href="/admin" className="hover:underline">
+            Admin
+          </Link>
+        </nav>
+      </header>
+      <main className="flex-1">{children}</main>
+      <footer className="border-t px-6 py-4 text-center text-sm text-gray-500">
+        Public Area &copy; {new Date().getFullYear()}
+      </footer>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/ts/src/app/(public)/page.tsx

@@ -0,0 +1,38 @@
+import Link from "next/link";
+
+export default function PublicPage() {
+  return (
+    <div className="max-w-4xl mx-auto py-12 px-6">
+      <h1 className="text-4xl font-extrabold tracking-tight mb-4">
+        Welcome to Route Groups Preset
+      </h1>
+      <p className="text-lg text-gray-600 mb-8">
+        This application is organized using Next.js App Router route groups:
+        (public), (auth), (private), and (admin).
+      </p>
+      <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+        <div className="border rounded-lg p-6 shadow-sm">
+          <h2 className="text-xl font-semibold mb-2">Auth Group</h2>
+          <p className="text-gray-500 mb-4">Authentication screens and login layouts.</p>
+          <Link href="/login" className="text-blue-600 hover:underline">
+            Go to Login &rarr;
+          </Link>
+        </div>
+        <div className="border rounded-lg p-6 shadow-sm">
+          <h2 className="text-xl font-semibold mb-2">Private Group</h2>
+          <p className="text-gray-500 mb-4">Protected routes guarded by auth proxy middleware.</p>
+          <Link href="/dashboard" className="text-blue-600 hover:underline">
+            Go to Dashboard &rarr;
+          </Link>
+        </div>
+        <div className="border rounded-lg p-6 shadow-sm">
+          <h2 className="text-xl font-semibold mb-2">Admin Group</h2>
+          <p className="text-gray-500 mb-4">Elevated management section requiring admin role.</p>
+          <Link href="/admin" className="text-blue-600 hover:underline">
+            Go to Admin &rarr;
+          </Link>
+        </div>
+      </div>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/ts/src/middleware.ts

@@ -0,0 +1,49 @@
+import { NextResponse } from "next/server";
+import type { NextRequest } from "next/server";
+
+/**
+ * Auth Proxy / Route Guard Middleware
+ *
+ * Enforces role-based access control and session verification:
+ * - Unauthenticated requests to private or admin routes redirect to /login
+ * - Authenticated requests lacking the "admin" role redirect away from /admin
+ */
+export function middleware(request: NextRequest) {
+  const { pathname } = request.nextUrl;
+
+  const authToken = request.cookies.get("auth-token")?.value;
+  const userRole = request.cookies.get("user-role")?.value || "user";
+
+  const isAuthRoute = pathname.startsWith("/login") || pathname.startsWith("/register");
+  const isPrivateRoute = pathname.startsWith("/dashboard") || pathname.startsWith("/settings");
+  const isAdminRoute = pathname.startsWith("/admin");
+
+  // If unauthenticated user tries to access protected areas, redirect to /login
+  if ((isPrivateRoute || isAdminRoute) && !authToken) {
+    const loginUrl = new URL("/login", request.url);
+    loginUrl.searchParams.set("from", pathname);
+    return NextResponse.redirect(loginUrl);
+  }
+
+  // If authenticated user without admin role accesses admin area, forbid or redirect to dashboard
+  if (isAdminRoute && userRole !== "admin") {
+    return NextResponse.redirect(new URL("/dashboard", request.url));
+  }
+
+  // If already authenticated user visits auth routes, redirect to dashboard
+  if (isAuthRoute && authToken) {
+    return NextResponse.redirect(new URL("/dashboard", request.url));
+  }
+
+  return NextResponse.next();
+}
+
+export const config = {
+  matcher: [
+    "/dashboard/:path*",
+    "/settings/:path*",
+    "/admin/:path*",
+    "/login",
+    "/register",
+  ],
+};

package/templates/conditional/testing/jest/next/app-router/src/__tests__/page.test.jsx

@@ -0,0 +1,10 @@
+import "@testing-library/jest-dom";
+import { render, screen } from "@testing-library/react";
+import Home from "@/app/page";
+
+describe("Home", () => {
+  it("renders a heading", () => {
+    render(<Home />);
+    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
+  });
+});

package/templates/conditional/testing/jest/next/app-router/src/__tests__/page.test.tsx

@@ -0,0 +1,10 @@
+import "@testing-library/jest-dom";
+import { render, screen } from "@testing-library/react";
+import Home from "@/app/page";
+
+describe("Home", () => {
+  it("renders a heading", () => {
+    render(<Home />);
+    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
+  });
+});

package/templates/conditional/testing/jest/next/jest.config.mjs

@@ -0,0 +1,20 @@
+import nextJest from "next/jest.js";
+
+const createJestConfig = nextJest({
+  // Provide the path to your Next.js app to load next.config.js and .env files in your test environment
+  dir: "./",
+});
+
+// Add any custom config to be passed to Jest
+/** @type {import('jest').Config} */
+const config = {
+  coverageProvider: "v8",
+  testEnvironment: "jsdom",
+  setupFilesAfterEnv: ["<rootDir>/jest.setup.js"],
+  moduleNameMapper: {
+    "^@/(.*)$": "<rootDir>/src/$1",
+  },
+};
+
+// createJestConfig is exported this way to ensure that next/jest can load the Next.js config which is async
+export default createJestConfig(config);

package/templates/conditional/testing/jest/next/jest.config.ts

@@ -0,0 +1,20 @@
+import type { Config } from "jest";
+import nextJest from "next/jest.js";
+
+const createJestConfig = nextJest({
+  // Provide the path to your Next.js app to load next.config.js and .env files in your test environment
+  dir: "./",
+});
+
+// Add any custom config to be passed to Jest
+const config: Config = {
+  coverageProvider: "v8",
+  testEnvironment: "jsdom",
+  setupFilesAfterEnv: ["<rootDir>/jest.setup.ts"],
+  moduleNameMapper: {
+    "^@/(.*)$": "<rootDir>/src/$1",
+  },
+};
+
+// createJestConfig is exported this way to ensure that next/jest can load the Next.js config which is async
+export default createJestConfig(config);

package/templates/conditional/testing/jest/next/pages-router/src/__tests__/index.test.jsx

@@ -0,0 +1,10 @@
+import "@testing-library/jest-dom";
+import { render, screen } from "@testing-library/react";
+import Home from "@/pages/index";
+
+describe("Home", () => {
+  it("renders a heading", () => {
+    render(<Home />);
+    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
+  });
+});

package/templates/conditional/testing/jest/next/pages-router/src/__tests__/index.test.tsx

@@ -0,0 +1,10 @@
+import "@testing-library/jest-dom";
+import { render, screen } from "@testing-library/react";
+import Home from "@/pages/index";
+
+describe("Home", () => {
+  it("renders a heading", () => {
+    render(<Home />);
+    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
+  });
+});

package/templates/conditional/testing/vitest/next/app-router/src/__tests__/page.test.jsx

@@ -0,0 +1,11 @@
+import "@testing-library/jest-dom/vitest";
+import { render, screen } from "@testing-library/react";
+import { describe, it, expect } from "vitest";
+import Home from "@/app/page";
+
+describe("Home", () => {
+  it("renders a heading", () => {
+    render(<Home />);
+    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
+  });
+});

package/templates/conditional/testing/vitest/next/app-router/src/__tests__/page.test.tsx

@@ -0,0 +1,11 @@
+import "@testing-library/jest-dom/vitest";
+import { render, screen } from "@testing-library/react";
+import { describe, it, expect } from "vitest";
+import Home from "@/app/page";
+
+describe("Home", () => {
+  it("renders a heading", () => {
+    render(<Home />);
+    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
+  });
+});

package/templates/conditional/testing/vitest/next/pages-router/src/__tests__/index.test.jsx

@@ -0,0 +1,11 @@
+import "@testing-library/jest-dom/vitest";
+import { render, screen } from "@testing-library/react";
+import { describe, it, expect } from "vitest";
+import Home from "@/pages/index";
+
+describe("Home", () => {
+  it("renders a heading", () => {
+    render(<Home />);
+    expect(screen.getByRole("heading", { level: 1 })).toBeInTheDocument();
+  });
+});