better-ts-stack 2.1.0 → 2.1.2

package/templates/modules/auth/tanstack/src/routes/dashboard.tsx

@@ -1,111 +1,111 @@
-import { createFileRoute, redirect } from "@tanstack/react-router";
-import { Link } from "@tanstack/react-router";
-import { ArrowRight, ShieldCheck } from "lucide-react";
-
-import { SignOutButton } from "~/components/auth/sign-out-button";
-import { buttonVariants } from "~/components/ui/button";
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from "~/components/ui/card";
-import { getSession } from "~/lib/auth-functions";
-import { cn } from "~/lib/utils";
-
-export const Route = createFileRoute("/dashboard")({
-  beforeLoad: async () => {
-    const session = await getSession();
-
-    if (!session) {
-      throw redirect({ to: "/sign-in" });
-    }
-
-    return { user: session.user };
-  },
-  component: Dashboard,
-});
-
-function Dashboard() {
-  const user = Route.useRouteContext({ select: (ctx) => ctx.user });
-
-  return (
-    <main className="min-h-screen bg-[linear-gradient(180deg,_#f8fafc_0%,_#eef2ff_100%)] px-6 py-16 sm:px-10">
-      <div className="mx-auto max-w-5xl space-y-8">
-        <header className="flex flex-col gap-6 rounded-[2rem] border border-white/70 bg-white/85 p-8 shadow-xl shadow-slate-200/60 backdrop-blur md:flex-row md:items-end md:justify-between">
-          <div className="space-y-3">
-            <span className="inline-flex items-center gap-2 rounded-full bg-emerald-50 px-3 py-1 text-xs font-medium uppercase tracking-[0.24em] text-emerald-700">
-              <ShieldCheck className="size-4" />
-              Authenticated session
-            </span>
-            <div className="space-y-1">
-              <h1 className="text-3xl font-semibold tracking-tight text-slate-950">
-                Welcome {user.name}
-              </h1>
-              <p className="text-sm text-slate-600">{user.email}</p>
-            </div>
-          </div>
-          <SignOutButton />
-        </header>
-
-        <section className="grid gap-5 md:grid-cols-2">
-          <Card>
-            <CardHeader>
-              <CardTitle>Protected route example</CardTitle>
-              <CardDescription>
-                This page verifies the session on the server before rendering any
-                content.
-              </CardDescription>
-            </CardHeader>
-            <CardContent className="space-y-4 text-sm text-slate-600">
-              <p>
-                The route guard calls{" "}
-                <code className="font-mono text-slate-900">getSession()</code> in
-                <code className="font-mono text-slate-900"> beforeLoad</code>,
-                which reads the cookie headers server-side via{" "}
-                <code className="font-mono text-slate-900">
-                  auth.api.getSession
-                </code>{" "}
-                on every render and navigation.
-              </p>
-              <p>
-                That keeps route protection aligned with Better Auth&apos;s
-                TanStack Start guidance while staying easy to extend.
-              </p>
-            </CardContent>
-          </Card>
-
-          <Card>
-            <CardHeader>
-              <CardTitle>Suggested next steps</CardTitle>
-              <CardDescription>
-                Keep the generated auth flow, then customize the app around your
-                product.
-              </CardDescription>
-            </CardHeader>
-            <CardContent className="space-y-3 text-sm text-slate-600">
-              <p>
-                Replace the demo dashboard with your first authenticated page.
-              </p>
-              <p>Extend the schema with profile or onboarding fields.</p>
-              <p>
-                Add provider-based auth or email verification later if needed.
-              </p>
-              <Link
-                to="/"
-                className={cn(
-                  buttonVariants({ variant: "outline" }),
-                  "w-fit gap-2"
-                )}
-              >
-                Back to home
-                <ArrowRight className="size-4" />
-              </Link>
-            </CardContent>
-          </Card>
-        </section>
-      </div>
-    </main>
-  );
+import { createFileRoute, redirect } from "@tanstack/react-router";
+import { Link } from "@tanstack/react-router";
+import { ArrowRight, ShieldCheck } from "lucide-react";
+
+import { SignOutButton } from "~/components/auth/sign-out-button";
+import { buttonVariants } from "~/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "~/components/ui/card";
+import { getSession } from "~/lib/auth-functions";
+import { cn } from "~/lib/utils";
+
+export const Route = createFileRoute("/dashboard")({
+  beforeLoad: async () => {
+    const session = await getSession();
+
+    if (!session) {
+      throw redirect({ to: "/sign-in" });
+    }
+
+    return { user: session.user };
+  },
+  component: Dashboard,
+});
+
+function Dashboard() {
+  const user = Route.useRouteContext({ select: (ctx) => ctx.user });
+
+  return (
+    <main className="min-h-screen bg-[linear-gradient(180deg,_#f8fafc_0%,_#eef2ff_100%)] px-6 py-16 sm:px-10">
+      <div className="mx-auto max-w-5xl space-y-8">
+        <header className="flex flex-col gap-6 rounded-[2rem] border border-white/70 bg-white/85 p-8 shadow-xl shadow-slate-200/60 backdrop-blur md:flex-row md:items-end md:justify-between">
+          <div className="space-y-3">
+            <span className="inline-flex items-center gap-2 rounded-full bg-emerald-50 px-3 py-1 text-xs font-medium uppercase tracking-[0.24em] text-emerald-700">
+              <ShieldCheck className="size-4" />
+              Authenticated session
+            </span>
+            <div className="space-y-1">
+              <h1 className="text-3xl font-semibold tracking-tight text-slate-950">
+                Welcome {user.name}
+              </h1>
+              <p className="text-sm text-slate-600">{user.email}</p>
+            </div>
+          </div>
+          <SignOutButton />
+        </header>
+
+        <section className="grid gap-5 md:grid-cols-2">
+          <Card>
+            <CardHeader>
+              <CardTitle>Protected route example</CardTitle>
+              <CardDescription>
+                This page verifies the session on the server before rendering any
+                content.
+              </CardDescription>
+            </CardHeader>
+            <CardContent className="space-y-4 text-sm text-slate-600">
+              <p>
+                The route guard calls{" "}
+                <code className="font-mono text-slate-900">getSession()</code> in
+                <code className="font-mono text-slate-900"> beforeLoad</code>,
+                which reads the cookie headers server-side via{" "}
+                <code className="font-mono text-slate-900">
+                  auth.api.getSession
+                </code>{" "}
+                on every render and navigation.
+              </p>
+              <p>
+                That keeps route protection aligned with Better Auth&apos;s
+                TanStack Start guidance while staying easy to extend.
+              </p>
+            </CardContent>
+          </Card>
+
+          <Card>
+            <CardHeader>
+              <CardTitle>Suggested next steps</CardTitle>
+              <CardDescription>
+                Keep the generated auth flow, then customize the app around your
+                product.
+              </CardDescription>
+            </CardHeader>
+            <CardContent className="space-y-3 text-sm text-slate-600">
+              <p>
+                Replace the demo dashboard with your first authenticated page.
+              </p>
+              <p>Extend the schema with profile or onboarding fields.</p>
+              <p>
+                Add provider-based auth or email verification later if needed.
+              </p>
+              <Link
+                to="/"
+                className={cn(
+                  buttonVariants({ variant: "outline" }),
+                  "w-fit gap-2"
+                )}
+              >
+                Back to home
+                <ArrowRight className="size-4" />
+              </Link>
+            </CardContent>
+          </Card>
+        </section>
+      </div>
+    </main>
+  );
 }

package/templates/modules/auth/tanstack/src/routes/sign-in.tsx

@@ -1,37 +1,37 @@
-import { createFileRoute, redirect } from "@tanstack/react-router";
-
-import { SignInForm } from "~/components/auth/sign-in-form";
-import { getSession } from "~/lib/auth-functions";
-
-export const Route = createFileRoute("/sign-in")({
-  beforeLoad: async () => {
-    const session = await getSession();
-
-    if (session) {
-      throw redirect({ to: "/dashboard" });
-    }
-  },
-  component: SignInPage,
-});
-
-function SignInPage() {
-  return (
-    <main className="min-h-screen bg-[radial-gradient(circle_at_top,_rgba(14,165,233,0.16),_transparent_30%),linear-gradient(180deg,_#f8fafc_0%,_#eef2ff_100%)] px-6 py-16 sm:px-10">
-      <div className="mx-auto flex min-h-[calc(100vh-8rem)] max-w-5xl items-center gap-12 lg:grid lg:grid-cols-[0.9fr_1.1fr]">
-        <section className="hidden space-y-5 lg:block">
-          <span className="inline-flex rounded-full border border-sky-200 bg-white/80 px-3 py-1 text-xs font-medium uppercase tracking-[0.24em] text-sky-700">
-            Better Auth
-          </span>
-          <h1 className="text-4xl font-semibold tracking-tight text-slate-950">
-            Welcome back.
-          </h1>
-          <p className="max-w-md text-base leading-7 text-slate-600">
-            This generated starter includes protected routes, session-aware page
-            guards, and reusable auth form primitives you can extend from here.
-          </p>
-        </section>
-        <SignInForm />
-      </div>
-    </main>
-  );
+import { createFileRoute, redirect } from "@tanstack/react-router";
+
+import { SignInForm } from "~/components/auth/sign-in-form";
+import { getSession } from "~/lib/auth-functions";
+
+export const Route = createFileRoute("/sign-in")({
+  beforeLoad: async () => {
+    const session = await getSession();
+
+    if (session) {
+      throw redirect({ to: "/dashboard" });
+    }
+  },
+  component: SignInPage,
+});
+
+function SignInPage() {
+  return (
+    <main className="min-h-screen bg-[radial-gradient(circle_at_top,_rgba(14,165,233,0.16),_transparent_30%),linear-gradient(180deg,_#f8fafc_0%,_#eef2ff_100%)] px-6 py-16 sm:px-10">
+      <div className="mx-auto flex min-h-[calc(100vh-8rem)] max-w-5xl items-center gap-12 lg:grid lg:grid-cols-[0.9fr_1.1fr]">
+        <section className="hidden space-y-5 lg:block">
+          <span className="inline-flex rounded-full border border-sky-200 bg-white/80 px-3 py-1 text-xs font-medium uppercase tracking-[0.24em] text-sky-700">
+            Better Auth
+          </span>
+          <h1 className="text-4xl font-semibold tracking-tight text-slate-950">
+            Welcome back.
+          </h1>
+          <p className="max-w-md text-base leading-7 text-slate-600">
+            This generated starter includes protected routes, session-aware page
+            guards, and reusable auth form primitives you can extend from here.
+          </p>
+        </section>
+        <SignInForm />
+      </div>
+    </main>
+  );
 }

package/templates/modules/auth/tanstack/src/routes/sign-up.tsx

@@ -1,37 +1,37 @@
-import { createFileRoute, redirect } from "@tanstack/react-router";
-
-import { SignUpForm } from "~/components/auth/sign-up-form";
-import { getSession } from "~/lib/auth-functions";
-
-export const Route = createFileRoute("/sign-up")({
-  beforeLoad: async () => {
-    const session = await getSession();
-
-    if (session) {
-      throw redirect({ to: "/dashboard" });
-    }
-  },
-  component: SignUpPage,
-});
-
-function SignUpPage() {
-  return (
-    <main className="min-h-screen bg-[radial-gradient(circle_at_top,_rgba(56,189,248,0.18),_transparent_28%),linear-gradient(180deg,_#f8fafc_0%,_#ecfeff_100%)] px-6 py-16 sm:px-10">
-      <div className="mx-auto flex min-h-[calc(100vh-8rem)] max-w-5xl items-center gap-12 lg:grid lg:grid-cols-[0.9fr_1.1fr]">
-        <section className="hidden space-y-5 lg:block">
-          <span className="inline-flex rounded-full border border-sky-200 bg-white/80 px-3 py-1 text-xs font-medium uppercase tracking-[0.24em] text-sky-700">
-            Better Auth
-          </span>
-          <h1 className="text-4xl font-semibold tracking-tight text-slate-950">
-            Create your account.
-          </h1>
-          <p className="max-w-md text-base leading-7 text-slate-600">
-            Start with email and password today, then layer in profile data,
-            onboarding, and provider-based auth when your product needs it.
-          </p>
-        </section>
-        <SignUpForm />
-      </div>
-    </main>
-  );
+import { createFileRoute, redirect } from "@tanstack/react-router";
+
+import { SignUpForm } from "~/components/auth/sign-up-form";
+import { getSession } from "~/lib/auth-functions";
+
+export const Route = createFileRoute("/sign-up")({
+  beforeLoad: async () => {
+    const session = await getSession();
+
+    if (session) {
+      throw redirect({ to: "/dashboard" });
+    }
+  },
+  component: SignUpPage,
+});
+
+function SignUpPage() {
+  return (
+    <main className="min-h-screen bg-[radial-gradient(circle_at_top,_rgba(56,189,248,0.18),_transparent_28%),linear-gradient(180deg,_#f8fafc_0%,_#ecfeff_100%)] px-6 py-16 sm:px-10">
+      <div className="mx-auto flex min-h-[calc(100vh-8rem)] max-w-5xl items-center gap-12 lg:grid lg:grid-cols-[0.9fr_1.1fr]">
+        <section className="hidden space-y-5 lg:block">
+          <span className="inline-flex rounded-full border border-sky-200 bg-white/80 px-3 py-1 text-xs font-medium uppercase tracking-[0.24em] text-sky-700">
+            Better Auth
+          </span>
+          <h1 className="text-4xl font-semibold tracking-tight text-slate-950">
+            Create your account.
+          </h1>
+          <p className="max-w-md text-base leading-7 text-slate-600">
+            Start with email and password today, then layer in profile data,
+            onboarding, and provider-based auth when your product needs it.
+          </p>
+        </section>
+        <SignUpForm />
+      </div>
+    </main>
+  );
 }

package/templates/modules/ci/.github/workflows/ci.yml.hbs

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: Build, type-check, lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+{{#if (eq packageManager 'pnpm')}}
+      - uses: pnpm/action-setup@v6
+        with:
+          version: 11
+{{/if}}
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24
+{{#if (eq packageManager 'bun')}}
+      - uses: oven-sh/setup-bun@v2
+{{/if}}
+      - name: Install
+        run: {{docker.install}}
+      - name: Build
+{{#if ciBuildEnv.length}}
+        # Placeholders: the build never connects to a database. Add real values
+        # as repository secrets if your build needs them
+        env:
+{{#each ciBuildEnv}}
+          {{name}}: "{{value}}"
+{{/each}}
+{{/if}}
+        run: {{docker.run}} build
+      - name: Type-check
+        run: {{docker.run}} type:check
+      - name: Lint
+        run: {{docker.run}} lint

package/templates/modules/ci/config.json

@@ -0,0 +1,10 @@
+{
+  "id": "ci",
+  "name": "GitHub Actions CI",
+  "description": "A GitHub Actions workflow that builds, type-checks, and lints every push and pull request",
+  "type": "feature",
+  "dependencies": {},
+  "devDependencies": {},
+  "scripts": {},
+  "envVars": {}
+}

package/templates/modules/docker/.dockerignore

@@ -2,8 +2,11 @@ node_modules
 npm-debug.log
 .env*
 .git
+.github
 .gitignore
 README.md
+AGENTS.md
+CLAUDE.md
 .vscode
 .idea
 dist

package/templates/modules/docker/config.json

@@ -1,15 +1,15 @@
-{
-  "id": "docker",
-  "name": "Docker",
-  "description": "Docker containerization with multi-stage build and docker-compose",
-  "type": "feature",
-  "dependencies": {},
-  "devDependencies": {},
-  "scripts": {
-    "docker:build": "docker build -t {{projectName}} .",
-    "docker:up": "docker compose up -d --build",
-    "docker:down": "docker compose down",
-    "docker:logs": "docker compose logs -f"
-  },
-  "envVars": {}
-}
+{
+  "id": "docker",
+  "name": "Docker",
+  "description": "Docker containerization with multi-stage build and docker-compose",
+  "type": "feature",
+  "dependencies": {},
+  "devDependencies": {},
+  "scripts": {
+    "docker:build": "docker build -t {{projectName}} .",
+    "docker:up": "docker compose up -d --build",
+    "docker:down": "docker compose down",
+    "docker:logs": "docker compose logs -f"
+  },
+  "envVars": {}
+}

package/templates/modules/docker/docker-compose.yml.hbs

@@ -1,5 +1,5 @@
 services:
-  {{projectName}}:
+  app:
     build: .
     ports:
       - "{{port}}:{{port}}"

package/templates/modules/drizzle/express/config.json

@@ -1,26 +1,26 @@
-{
-  "id": "drizzle",
-  "name": "Drizzle ORM",
-  "description": "Drizzle ORM for Express with PostgreSQL",
-  "type": "database",
-  "dependencies": {
-    "drizzle-orm": "^0.45.2",
-    "pg": "^8.23.0",
-    "dotenv": "^17.4.2"
-  },
-  "devDependencies": {
-    "drizzle-kit": "^0.31.10",
-    "@types/pg": "^8.23.1"
-  },
-  "scripts": {
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio"
-  },
-  "envVars": {
-    "DATABASE_URL": "postgresql://postgres:postgres@localhost:5432/postgres"
-  },
-  "overrides": {
-    "esbuild": "^0.28.2"
-  }
-}
+{
+  "id": "drizzle",
+  "name": "Drizzle ORM",
+  "description": "Drizzle ORM for Express with PostgreSQL",
+  "type": "database",
+  "dependencies": {
+    "drizzle-orm": "^0.45.4",
+    "pg": "^8.23.1",
+    "dotenv": "^17.4.2"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.31.11",
+    "@types/pg": "^8.23.1"
+  },
+  "scripts": {
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio"
+  },
+  "envVars": {
+    "DATABASE_URL": "postgresql://postgres:postgres@localhost:5432/postgres"
+  },
+  "overrides": {
+    "esbuild": "^0.28.2"
+  }
+}

package/templates/modules/drizzle/nestjs/config.json

@@ -1,26 +1,26 @@
-{
-  "id": "drizzle",
-  "name": "Drizzle ORM",
-  "description": "Drizzle ORM for NestJS with PostgreSQL",
-  "type": "database",
-  "dependencies": {
-    "drizzle-orm": "^0.45.2",
-    "pg": "^8.23.0",
-    "dotenv": "^17.4.2"
-  },
-  "devDependencies": {
-    "drizzle-kit": "^0.31.10",
-    "@types/pg": "^8.23.1"
-  },
-  "scripts": {
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio"
-  },
-  "envVars": {
-    "DATABASE_URL": "postgresql://postgres:postgres@localhost:5432/postgres"
-  },
-  "overrides": {
-    "esbuild": "^0.28.2"
-  }
-}
+{
+  "id": "drizzle",
+  "name": "Drizzle ORM",
+  "description": "Drizzle ORM for NestJS with PostgreSQL",
+  "type": "database",
+  "dependencies": {
+    "drizzle-orm": "^0.45.4",
+    "pg": "^8.23.1",
+    "dotenv": "^17.4.2"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.31.11",
+    "@types/pg": "^8.23.1"
+  },
+  "scripts": {
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio"
+  },
+  "envVars": {
+    "DATABASE_URL": "postgresql://postgres:postgres@localhost:5432/postgres"
+  },
+  "overrides": {
+    "esbuild": "^0.28.2"
+  }
+}

package/templates/modules/drizzle/nextjs/config.json

@@ -1,26 +1,26 @@
-{
-  "id": "drizzle",
-  "name": "Drizzle ORM",
-  "description": "Drizzle ORM for Next.js with PostgreSQL",
-  "type": "database",
-  "dependencies": {
-    "drizzle-orm": "^0.45.2",
-    "pg": "^8.23.0",
-    "dotenv": "^17.4.2"
-  },
-  "devDependencies": {
-    "drizzle-kit": "^0.31.10",
-    "@types/pg": "^8.23.1"
-  },
-  "scripts": {
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio"
-  },
-  "envVars": {
-    "DATABASE_URL": "postgresql://postgres:postgres@localhost:5432/postgres"
-  },
-  "overrides": {
-    "esbuild": "^0.28.2"
-  }
-}
+{
+  "id": "drizzle",
+  "name": "Drizzle ORM",
+  "description": "Drizzle ORM for Next.js with PostgreSQL",
+  "type": "database",
+  "dependencies": {
+    "drizzle-orm": "^0.45.4",
+    "pg": "^8.23.1",
+    "dotenv": "^17.4.2"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.31.11",
+    "@types/pg": "^8.23.1"
+  },
+  "scripts": {
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio"
+  },
+  "envVars": {
+    "DATABASE_URL": "postgresql://postgres:postgres@localhost:5432/postgres"
+  },
+  "overrides": {
+    "esbuild": "^0.28.2"
+  }
+}