better-ts-stack 0.1.1 → 1.1.0

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

@@ -0,0 +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>
+  );
+}

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

@@ -0,0 +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>
+  );
+}

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

@@ -0,0 +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>
+  );
+}

package/templates/modules/docker/.dockerignore

@@ -1,13 +1,14 @@
-node_modules
-npm-debug.log
-.env
-.env.local
-.git
-.gitignore
-README.md
-.vscode
-.idea
-dist
-coverage
-.DS_Store
-*.log
+node_modules
+npm-debug.log
+.env*
+.git
+.gitignore
+README.md
+.vscode
+.idea
+dist
+coverage
+.DS_Store
+*.log
+
+.next

package/templates/modules/docker/Dockerfile.hbs

@@ -1,6 +1,6 @@
 {{#if (eq framework 'nextjs')}}
 # Base stage
-FROM node:20-alpine AS base
+FROM node:24-alpine AS base
 WORKDIR /app
 RUN apk add --no-cache libc6-compat
 
@@ -13,10 +13,16 @@ RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
 FROM base AS builder
 COPY --from=deps /app/node_modules ./node_modules
 COPY . .
+{{#if (eq database 'prisma')}}
+RUN DATABASE_URL="postgresql://postgres:postgres@localhost:5432/postgres" npm run build
+{{else if (eq database 'mongoose')}}
+RUN MONGODB_URI="mongodb://localhost:27017/build" npm run build
+{{else}}
 RUN npm run build
+{{/if}}
 
 # Production stage
-FROM node:20-alpine AS runner
+FROM node:24-alpine AS runner
 WORKDIR /app
 ENV NODE_ENV=production
 
@@ -33,9 +39,54 @@ ENV PORT={{port}} HOSTNAME=0.0.0.0
 
 CMD ["node", "server.js"]
 
+{{else if (eq framework 'tanstack')}}
+# Build stage
+FROM node:24-alpine AS builder
+WORKDIR /app
+
+COPY package*.json ./
+RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
+
+COPY . .
+
+# Only build if package.json has a build script
+{{#if (eq database 'prisma')}}
+RUN DATABASE_URL="postgresql://postgres:postgres@localhost:5432/postgres" npm run build
+{{else if (eq database 'mongoose')}}
+RUN MONGODB_URI="mongodb://localhost:27017/build" npm run build
+{{else}}
+RUN npm run build
+{{/if}}
+
+# Production stage
+FROM node:24-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+
+# Create non-root user for security
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 tanstackuser
+
+COPY package*.json ./
+RUN if [ -f package-lock.json ]; then npm ci --omit=dev; else npm install --omit=dev; fi
+
+# Copy built output (dist/server/server.js + dist/client)
+COPY --from=builder --chown=tanstackuser:nodejs /app/dist ./dist
+
+# Include the Prisma client generated during the build stage
+{{#if (eq database 'prisma')}}
+COPY --from=builder --chown=tanstackuser:nodejs /app/generated ./generated
+{{/if}}
+
+USER tanstackuser
+EXPOSE {{port}}
+ENV PORT={{port}}
+
+CMD ["node_modules/.bin/srvx", "--prod", "-s", "../client", "dist/server/server.js"]
+
 {{else}}
 # Build stage
-FROM node:20-alpine AS builder
+FROM node:24-alpine AS builder
 WORKDIR /app
 
 COPY package*.json ./
@@ -44,10 +95,16 @@ RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
 COPY . .
 
 # Only build if package.json has a build script
-RUN npm run build || echo "No build script found, skipping build step"
+{{#if (eq database 'prisma')}}
+RUN DATABASE_URL="postgresql://postgres:postgres@localhost:5432/postgres" npm run build
+{{else if (eq database 'mongoose')}}
+RUN MONGODB_URI="mongodb://localhost:27017/build" npm run build
+{{else}}
+RUN npm run build
+{{/if}}
 
 # Production stage
-FROM node:20-alpine
+FROM node:24-alpine
 WORKDIR /app
 ENV NODE_ENV=production
 
@@ -59,13 +116,11 @@ COPY package*.json ./
 RUN if [ -f package-lock.json ]; then npm ci --omit=dev; else npm install --omit=dev; fi
 
 # Copy built files (if TypeScript) or source files (if JavaScript)
-COPY --from=builder --chown=expressuser:nodejs /app/dist ./dist 2>/dev/null || \
-     COPY --chown=expressuser:nodejs /app/src ./src 2>/dev/null || \
-     COPY --chown=expressuser:nodejs /app/*.js ./
+COPY --from=builder --chown=expressuser:nodejs /app/dist ./dist
 
 USER expressuser
 EXPOSE {{port}}
 ENV PORT={{port}}
 
-CMD ["node", "{{entrypoint}}"]
+CMD ["node", "dist/index.js"]
 {{/if}}

package/templates/modules/docker/config.json

@@ -1,16 +1,19 @@
-{
-  "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",
-    "docker:down": "docker-compose down",
-    "docker:logs": "docker-compose logs -f"
-  },
-  "envVars": {},
-  "templateFiles": ["docker-compose.yml.hbs", "Dockerfile.hbs"]
-}
+{
+  "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",
+    "docker:down": "docker compose down",
+    "docker:logs": "docker compose logs -f"
+  },
+  "envVars": {},
+  "templateFiles": [
+    "docker-compose.yml.hbs",
+    "Dockerfile.hbs"
+  ]
+}

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

@@ -1,10 +1,10 @@
-version: '3.8'
-
-services:
-  {{projectName}}:
-    build: .
-    ports:
-      - "{{port}}:{{port}}"
-    environment:
-      - NODE_ENV=production
+services:
+  {{projectName}}:
+    build: .
+    ports:
+      - "{{port}}:{{port}}"
+    env_file:
+      - .env
+    environment:
+      - NODE_ENV=production
     restart: unless-stopped

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

@@ -0,0 +1,27 @@
+{
+  "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://user:password@localhost:5432/mydb?schema=public"
+  },
+  "templateFiles": [],
+  "overrides": {
+    "esbuild": "^0.28.2"
+  }
+}

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

@@ -0,0 +1,13 @@
+import { config } from "dotenv";
+import { defineConfig } from "drizzle-kit";
+
+config({ path: ".env" });
+
+export default defineConfig({
+  schema: "./src/lib/schema.ts",
+  out: "./migrations",
+  dialect: "postgresql",
+  dbCredentials: {
+    url: process.env.DATABASE_URL!,
+  },
+});

package/templates/modules/drizzle/express/src/lib/db.ts

@@ -0,0 +1,13 @@
+import { config } from "dotenv";
+import { drizzle } from "drizzle-orm/node-postgres";
+import { Pool } from "pg";
+
+import * as schema from "./schema";
+
+config({ path: ".env" }); // or .env.local
+
+const pool = new Pool({
+  connectionString: process.env.DATABASE_URL,
+});
+
+export const db = drizzle(pool, { schema });

package/templates/modules/drizzle/express/src/lib/schema.ts

@@ -0,0 +1,10 @@
+import { pgTable, text, timestamp, uuid } from "drizzle-orm/pg-core";
+
+export const users = pgTable("users", {
+  id: uuid("id").primaryKey().defaultRandom(),
+  email: text("email").notNull().unique(),
+  name: text("name"),
+  password: text("password").notNull(),
+  createdAt: timestamp("created_at", { withTimezone: true }).defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow(),
+});

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

@@ -1,21 +1,29 @@
-{
-  "id": "drizzle",
-  "name": "Drizzle ORM",
-  "description": "Drizzle ORM for Next.js with PostgreSQL",
-  "type": "database",
+{
+  "id": "drizzle",
+  "name": "Drizzle ORM",
+  "description": "Drizzle ORM for Next.js with PostgreSQL",
+  "type": "database",
   "dependencies": {
-    "drizzle-orm": "^0.41.0",
-    "pg": "^8.13.0",
-    "dotenv": "^17.3.1"
+    "drizzle-orm": "^0.45.2",
+    "pg": "^8.23.0",
+    "dotenv": "^17.4.2"
   },
-  "devDependencies": { "drizzle-kit": "^0.31.4", "@types/pg": "^8.11.0" },
-  "scripts": {
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio"
-  },
-  "envVars": {
-    "DATABASE_URL": "postgresql://user:password@localhost:5432/mydb?schema=public"
-  },
-  "templateFiles": ["lib/schema.ts.hbs"]
-}
+  "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://user:password@localhost:5432/mydb?schema=public"
+  },
+  "templateFiles": [
+    "lib/schema.ts.hbs"
+  ],
+  "overrides": {
+    "esbuild": "^0.28.2"
+  }
+}

package/templates/modules/drizzle/nextjs/lib/db.ts

@@ -2,10 +2,12 @@ import { config } from "dotenv";
 import { drizzle } from "drizzle-orm/node-postgres";
 import { Pool } from "pg";
 
+import * as schema from "./schema";
+
 config({ path: ".env" }); // or .env.local
 
 const pool = new Pool({
   connectionString: process.env.DATABASE_URL,
 });
 
-export const db = drizzle(pool);
+export const db = drizzle(pool, { schema });