better-ts-stack 0.1.0

package/templates/modules/auth/nextjs/components/auth/sign-in-form.tsx

@@ -0,0 +1,132 @@
+"use client";
+
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useState, useTransition } from "react";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { LoaderCircle } from "lucide-react";
+import { useForm } from "react-hook-form";
+
+import { authClient } from "@/lib/auth-client";
+import {
+  getAuthErrorMessage,
+  signInSchema,
+  type SignInValues,
+} from "@/lib/auth-schema";
+import { Button } from "@/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardFooter,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import {
+  Field,
+  FieldDescription,
+  FieldError,
+  FieldGroup,
+  FieldLabel,
+} from "@/components/ui/field";
+import { Input } from "@/components/ui/input";
+
+export function SignInForm() {
+  const router = useRouter();
+  const [isPending, startTransition] = useTransition();
+  const [authError, setAuthError] = useState<string | null>(null);
+  const form = useForm<SignInValues>({
+    resolver: zodResolver(signInSchema),
+    defaultValues: {
+      email: "",
+      password: "",
+    },
+  });
+
+  const onSubmit = form.handleSubmit((values) => {
+    setAuthError(null);
+
+    startTransition(async () => {
+      const result = await authClient.signIn.email({
+        email: values.email,
+        password: values.password,
+      });
+
+      if (result.error) {
+        setAuthError(getAuthErrorMessage(result.error));
+        return;
+      }
+
+      router.push("/dashboard");
+      router.refresh();
+    });
+  });
+
+  return (
+    <Card className="border-white/80 bg-white/90 shadow-2xl shadow-slate-200/70 backdrop-blur">
+      <CardHeader className="space-y-2">
+        <CardTitle>Login to your account</CardTitle>
+        <CardDescription>
+          Sign in with your email and password to continue to your dashboard.
+        </CardDescription>
+      </CardHeader>
+      <CardContent>
+        <form className="space-y-6" onSubmit={onSubmit} noValidate>
+          <FieldGroup>
+            <Field data-invalid={Boolean(form.formState.errors.email)}>
+              <FieldLabel htmlFor="email">Email</FieldLabel>
+              <Input
+                id="email"
+                type="email"
+                autoComplete="email"
+                aria-invalid={Boolean(form.formState.errors.email)}
+                placeholder="you@example.com"
+                {...form.register("email")}
+              />
+              <FieldDescription>Use the email you registered with.</FieldDescription>
+              <FieldError errors={[form.formState.errors.email]} />
+            </Field>
+
+            <Field data-invalid={Boolean(form.formState.errors.password)}>
+              <FieldLabel htmlFor="password">Password</FieldLabel>
+              <Input
+                id="password"
+                type="password"
+                autoComplete="current-password"
+                aria-invalid={Boolean(form.formState.errors.password)}
+                placeholder="Enter your password"
+                {...form.register("password")}
+              />
+              <FieldError errors={[form.formState.errors.password]} />
+            </Field>
+          </FieldGroup>
+
+          {authError ? (
+            <div className="rounded-2xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">
+              {authError}
+            </div>
+          ) : null}
+
+          <Button className="w-full" type="submit" disabled={isPending}>
+            {isPending ? (
+              <>
+                <LoaderCircle className="mr-2 size-4 animate-spin" />
+                Signing in
+              </>
+            ) : (
+              "Login"
+            )}
+          </Button>
+        </form>
+      </CardContent>
+      <CardFooter className="justify-center">
+        <p className="text-sm text-slate-600">
+          Need an account?{" "}
+          <Link className="font-medium text-sky-700 hover:text-sky-800" href="/sign-up">
+            Signup
+          </Link>
+        </p>
+      </CardFooter>
+    </Card>
+  );
+}

package/templates/modules/auth/nextjs/components/auth/sign-out-button.tsx

@@ -0,0 +1,50 @@
+"use client";
+
+import { useRouter } from "next/navigation";
+import { useState, useTransition } from "react";
+import { LoaderCircle, LogOut } from "lucide-react";
+
+import { authClient } from "@/lib/auth-client";
+import { Button } from "@/components/ui/button";
+
+export function SignOutButton() {
+  const router = useRouter();
+  const [isPending, startTransition] = useTransition();
+  const [error, setError] = useState<string | null>(null);
+
+  return (
+    <div className="space-y-2">
+      <Button
+        variant="outline"
+        onClick={() => {
+          setError(null);
+          startTransition(async () => {
+            const result = await authClient.signOut();
+
+            if (result.error) {
+              setError("Unable to sign out right now. Please try again.");
+              return;
+            }
+
+            router.push("/sign-in");
+            router.refresh();
+          });
+        }}
+        disabled={isPending}
+      >
+        {isPending ? (
+          <>
+            <LoaderCircle className="mr-2 size-4 animate-spin" />
+            Signing out
+          </>
+        ) : (
+          <>
+            <LogOut className="mr-2 size-4" />
+            Sign out
+          </>
+        )}
+      </Button>
+      {error ? <p className="text-sm text-rose-600">{error}</p> : null}
+    </div>
+  );
+}

package/templates/modules/auth/nextjs/components/auth/sign-up-form.tsx

@@ -0,0 +1,152 @@
+"use client";
+
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useState, useTransition } from "react";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { LoaderCircle } from "lucide-react";
+import { useForm } from "react-hook-form";
+
+import { authClient } from "@/lib/auth-client";
+import {
+  getAuthErrorMessage,
+  signUpSchema,
+  type SignUpValues,
+} from "@/lib/auth-schema";
+import { Button } from "@/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardFooter,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import {
+  Field,
+  FieldDescription,
+  FieldError,
+  FieldGroup,
+  FieldLabel,
+} from "@/components/ui/field";
+import { Input } from "@/components/ui/input";
+
+export function SignUpForm() {
+  const router = useRouter();
+  const [isPending, startTransition] = useTransition();
+  const [authError, setAuthError] = useState<string | null>(null);
+  const form = useForm<SignUpValues>({
+    resolver: zodResolver(signUpSchema),
+    defaultValues: {
+      name: "",
+      email: "",
+      password: "",
+    },
+  });
+
+  const onSubmit = form.handleSubmit((values) => {
+    setAuthError(null);
+
+    startTransition(async () => {
+      const result = await authClient.signUp.email({
+        name: values.name,
+        email: values.email,
+        password: values.password,
+      });
+
+      if (result.error) {
+        setAuthError(getAuthErrorMessage(result.error));
+        return;
+      }
+
+      router.push("/dashboard");
+      router.refresh();
+    });
+  });
+
+  return (
+    <Card className="border-white/80 bg-white/90 shadow-2xl shadow-slate-200/70 backdrop-blur">
+      <CardHeader className="space-y-2">
+        <CardTitle>Create your account</CardTitle>
+        <CardDescription>
+          Start with a simple email and password sign-up flow powered by Better
+          Auth.
+        </CardDescription>
+      </CardHeader>
+      <CardContent>
+        <form className="space-y-6" onSubmit={onSubmit} noValidate>
+          <FieldGroup>
+            <Field data-invalid={Boolean(form.formState.errors.name)}>
+              <FieldLabel htmlFor="name">Full name</FieldLabel>
+              <Input
+                id="name"
+                autoComplete="name"
+                aria-invalid={Boolean(form.formState.errors.name)}
+                placeholder="Ada Lovelace"
+                {...form.register("name")}
+              />
+              <FieldError errors={[form.formState.errors.name]} />
+            </Field>
+
+            <Field data-invalid={Boolean(form.formState.errors.email)}>
+              <FieldLabel htmlFor="email">Email</FieldLabel>
+              <Input
+                id="email"
+                type="email"
+                autoComplete="email"
+                aria-invalid={Boolean(form.formState.errors.email)}
+                placeholder="you@example.com"
+                {...form.register("email")}
+              />
+              <FieldDescription>
+                This email will be used for future sign-ins.
+              </FieldDescription>
+              <FieldError errors={[form.formState.errors.email]} />
+            </Field>
+
+            <Field data-invalid={Boolean(form.formState.errors.password)}>
+              <FieldLabel htmlFor="password">Password</FieldLabel>
+              <Input
+                id="password"
+                type="password"
+                autoComplete="new-password"
+                aria-invalid={Boolean(form.formState.errors.password)}
+                placeholder="Create a strong password"
+                {...form.register("password")}
+              />
+              <FieldDescription>
+                Use at least 8 characters for the generated starter flow.
+              </FieldDescription>
+              <FieldError errors={[form.formState.errors.password]} />
+            </Field>
+          </FieldGroup>
+
+          {authError ? (
+            <div className="rounded-2xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">
+              {authError}
+            </div>
+          ) : null}
+
+          <Button className="w-full" type="submit" disabled={isPending}>
+            {isPending ? (
+              <>
+                <LoaderCircle className="mr-2 size-4 animate-spin" />
+                Creating account
+              </>
+            ) : (
+              "Signup"
+            )}
+          </Button>
+        </form>
+      </CardContent>
+      <CardFooter className="justify-center">
+        <p className="text-sm text-slate-600">
+          Already have an account?{" "}
+          <Link className="font-medium text-sky-700 hover:text-sky-800" href="/sign-in">
+            Login
+          </Link>
+        </p>
+      </CardFooter>
+    </Card>
+  );
+}

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

@@ -0,0 +1,31 @@
+{
+  "id": "auth",
+  "name": "Better Auth",
+  "description": "Better Auth for Next.js with optional Prisma or Drizzle adapter",
+  "type": "feature",
+  "dependencies": {
+    "@hookform/resolvers": "^5.2.1",
+    "better-auth": "^1.4.19",
+    "mongodb": "^6.0.0",
+    "react-hook-form": "^7.62.0",
+    "zod": "^4.1.5"
+  },
+  "devDependencies": {},
+  "scripts": {},
+  "envVars": {
+    "BETTER_AUTH_SECRET": "please-change-me-to-a-random-string",
+    "BETTER_AUTH_URL": "http://localhost:3000"
+  },
+  "templateFiles": [
+    "lib/auth.ts.hbs",
+    "lib/auth-client.ts",
+    "app/api/auth/[...all]/route.ts",
+    "app/dashboard/page.tsx",
+    "app/sign-in/page.tsx",
+    "app/sign-up/page.tsx",
+    "components/auth/sign-in-form.tsx",
+    "components/auth/sign-up-form.tsx",
+    "components/auth/sign-out-button.tsx",
+    "lib/auth-schema.ts"
+  ]
+}

package/templates/modules/auth/nextjs/lib/auth-client.ts

@@ -0,0 +1,3 @@
+import { createAuthClient } from "better-auth/react";
+
+export const authClient = createAuthClient();

package/templates/modules/auth/nextjs/lib/auth-schema.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+
+export const signInSchema = z.object({
+  email: z.string().email("Enter a valid email address."),
+  password: z.string().min(8, "Password must be at least 8 characters."),
+});
+
+export const signUpSchema = signInSchema.extend({
+  name: z
+    .string()
+    .trim()
+    .min(2, "Name must be at least 2 characters.")
+    .max(50, "Name must be 50 characters or fewer."),
+});
+
+export type SignInValues = z.infer<typeof signInSchema>;
+export type SignUpValues = z.infer<typeof signUpSchema>;
+
+export function getAuthErrorMessage(error: unknown) {
+  if (!error) {
+    return "Something went wrong. Please try again.";
+  }
+
+  if (typeof error === "string") {
+    return error;
+  }
+
+  if (typeof error === "object") {
+    if ("message" in error && typeof error.message === "string") {
+      return error.message;
+    }
+
+    if ("statusText" in error && typeof error.statusText === "string") {
+      return error.statusText;
+    }
+  }
+
+  return "Something went wrong. Please try again.";
+}

package/templates/modules/auth/nextjs/lib/auth.ts.hbs

@@ -0,0 +1,35 @@
+import { betterAuth } from "better-auth";
+import { nextCookies } from "better-auth/next-js";
+{{#if (eq database 'prisma')}}
+import { prismaAdapter } from "better-auth/adapters/prisma";
+import client from "./prisma";
+{{/if}}
+{{#if (eq database 'drizzle')}}
+import { drizzleAdapter } from "better-auth/adapters/drizzle";
+import { db } from "./db";
+{{/if}}
+{{#if (eq database 'mongoose')}}
+import { mongodbAdapter } from "better-auth/adapters/mongodb";
+import { MongoClient } from "mongodb";
+
+const client = new MongoClient(process.env.MONGODB_URI!);
+const db = client.db();
+{{/if}}
+
+export const auth = betterAuth({
+  {{#if (eq database 'prisma')}}
+  database: prismaAdapter(client, { provider: "postgresql" }),
+  {{/if}}
+  {{#if (eq database 'drizzle')}}
+  database: drizzleAdapter(db, { provider: "pg" }),
+  {{/if}}
+  {{#if (eq database 'mongoose')}}
+  database: mongodbAdapter(db, { client }),
+  {{/if}}
+  emailAndPassword: {
+    enabled: true,
+  },
+  plugins: [nextCookies()],
+  secret: process.env.BETTER_AUTH_SECRET,
+  baseURL: process.env.BETTER_AUTH_URL,
+});

package/templates/modules/docker/.dockerignore

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

package/templates/modules/docker/Dockerfile.hbs

@@ -0,0 +1,71 @@
+{{#if (eq framework 'nextjs')}}
+# Base stage
+FROM node:20-alpine AS base
+WORKDIR /app
+RUN apk add --no-cache libc6-compat
+
+# Dependencies stage
+FROM base AS deps
+COPY package*.json ./
+RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
+
+# Build stage
+FROM base AS builder
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN npm run build
+
+# Production stage
+FROM node:20-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 nextjs
+
+COPY --from=builder /app/public ./public
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+EXPOSE {{port}}
+ENV PORT={{port}} HOSTNAME=0.0.0.0
+
+CMD ["node", "server.js"]
+
+{{else}}
+# Build stage
+FROM node:20-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
+RUN npm run build || echo "No build script found, skipping build step"
+
+# Production stage
+FROM node:20-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+
+# Create non-root user for security
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 expressuser
+
+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 ./
+
+USER expressuser
+EXPOSE {{port}}
+ENV PORT={{port}}
+
+CMD ["node", "{{entrypoint}}"]
+{{/if}}

package/templates/modules/docker/config.json

@@ -0,0 +1,16 @@
+{
+  "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

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

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

@@ -0,0 +1,21 @@
+{
+  "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"
+  },
+  "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"]
+}

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

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

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

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