npm - create-skit - Versions diffs - 0.1.0 - Mend

create-skit 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (195) hide show

package/README.md +36 -0
package/bin/create-skit.mjs +1064 -0
package/lib/module-application.mjs +281 -0
package/lib/module-resolver.mjs +179 -0
package/modules/README.md +22 -0
package/modules/ai-dx/files/AGENTS.md +116 -0
package/modules/ai-dx/files/ARCHITECTURE.md +103 -0
package/modules/ai-dx/module.json +14 -0
package/modules/ai-dx-claude/files/CLAUDE.md +8 -0
package/modules/ai-dx-claude/module.json +13 -0
package/modules/ai-dx-cursor/files/.cursor/rules/auth.mdc +53 -0
package/modules/ai-dx-cursor/files/.cursor/rules/database.mdc +48 -0
package/modules/ai-dx-cursor/files/.cursor/rules/env.mdc +43 -0
package/modules/ai-dx-cursor/files/.cursor/rules/nextjs.mdc +58 -0
package/modules/ai-dx-cursor/files/.cursor/rules/project.mdc +33 -0
package/modules/ai-dx-cursor/files/.cursor/rules/testing.mdc +55 -0
package/modules/ai-dx-cursor/module.json +18 -0
package/modules/ai-dx-gemini/files/.gemini/GEMINI.md +5 -0
package/modules/ai-dx-gemini/module.json +13 -0
package/modules/auth-core/module.json +8 -0
package/modules/auth-github/module.json +20 -0
package/modules/billing-polar/module.json +20 -0
package/modules/billing-stripe/module.json +23 -0
package/modules/dashboard-shell/files/src/app/globals.css +756 -0
package/modules/dashboard-shell/files/src/app/settings/page.tsx +67 -0
package/modules/dashboard-shell/module.json +11 -0
package/modules/db-pg/module.json +21 -0
package/modules/db-postgresjs/module.json +21 -0
package/modules/deploy-docker/files/.dockerignore +19 -0
package/modules/deploy-docker/files/Dockerfile +25 -0
package/modules/deploy-docker/module.json +11 -0
package/modules/email-resend/module.json +21 -0
package/modules/quality-baseline/module.json +8 -0
package/modules/testing-baseline/module.json +8 -0
package/package.json +40 -0
package/presets/README.md +12 -0
package/presets/blank.json +67 -0
package/presets/dashboard.json +67 -0
package/templates/base-web/.env.example +17 -0
package/templates/base-web/.github/workflows/ci.yml +34 -0
package/templates/base-web/.husky/pre-commit +3 -0
package/templates/base-web/.husky/pre-push +3 -0
package/templates/base-web/.prettierignore +3 -0
package/templates/base-web/README.md +42 -0
package/templates/base-web/drizzle.config.ts +16 -0
package/templates/base-web/eslint.config.mjs +127 -0
package/templates/base-web/manifest.json +5 -0
package/templates/base-web/next-env.d.ts +4 -0
package/templates/base-web/next.config.ts +5 -0
package/templates/base-web/package.json +75 -0
package/templates/base-web/playwright.config.ts +21 -0
package/templates/base-web/prettier.config.mjs +9 -0
package/templates/base-web/proxy.ts +23 -0
package/templates/base-web/src/app/api/auth/[...all]/route.ts +5 -0
package/templates/base-web/src/app/api/billing/checkout/route.ts +26 -0
package/templates/base-web/src/app/api/billing/portal/route.ts +25 -0
package/templates/base-web/src/app/api/email/test/route.ts +28 -0
package/templates/base-web/src/app/api/webhooks/polar/route.ts +5 -0
package/templates/base-web/src/app/api/webhooks/stripe/route.ts +5 -0
package/templates/base-web/src/app/billing/page.tsx +55 -0
package/templates/base-web/src/app/dashboard/page.tsx +15 -0
package/templates/base-web/src/app/email/page.tsx +46 -0
package/templates/base-web/src/app/error.tsx +27 -0
package/templates/base-web/src/app/globals.css +534 -0
package/templates/base-web/src/app/layout.tsx +19 -0
package/templates/base-web/src/app/llms-full.txt/route.ts +158 -0
package/templates/base-web/src/app/llms.txt/route.ts +59 -0
package/templates/base-web/src/app/loading.tsx +24 -0
package/templates/base-web/src/app/not-found.tsx +16 -0
package/templates/base-web/src/app/page.tsx +5 -0
package/templates/base-web/src/app/sign-in/page.tsx +14 -0
package/templates/base-web/src/app/sign-up/page.tsx +14 -0
package/templates/base-web/src/components/auth/email-auth-form.test.tsx +40 -0
package/templates/base-web/src/components/auth/email-auth-form.tsx +128 -0
package/templates/base-web/src/components/auth/sign-out-button.tsx +29 -0
package/templates/base-web/src/db/index.ts +16 -0
package/templates/base-web/src/db/schema/auth.ts +4 -0
package/templates/base-web/src/db/schema/index.ts +2 -0
package/templates/base-web/src/db/schema/projects.ts +17 -0
package/templates/base-web/src/db/seeds/index.ts +32 -0
package/templates/base-web/src/lib/auth-client.ts +5 -0
package/templates/base-web/src/lib/auth-session.ts +21 -0
package/templates/base-web/src/lib/auth.ts +23 -0
package/templates/base-web/src/lib/billing/index.ts +37 -0
package/templates/base-web/src/lib/billing/providers/polar.ts +80 -0
package/templates/base-web/src/lib/billing/providers/stripe.ts +77 -0
package/templates/base-web/src/lib/billing/types.ts +25 -0
package/templates/base-web/src/lib/email/index.ts +19 -0
package/templates/base-web/src/lib/email/templates.test.ts +12 -0
package/templates/base-web/src/lib/email/templates.ts +40 -0
package/templates/base-web/src/lib/env.ts +83 -0
package/templates/base-web/tests/e2e/home.spec.ts +8 -0
package/templates/base-web/tsconfig.json +34 -0
package/templates/base-web/vitest.config.ts +19 -0
package/templates/blank/.env.example +16 -0
package/templates/blank/.github/workflows/ci.yml +34 -0
package/templates/blank/.husky/pre-commit +3 -0
package/templates/blank/.husky/pre-push +3 -0
package/templates/blank/.prettierignore +3 -0
package/templates/blank/drizzle.config.ts +16 -0
package/templates/blank/eslint.config.mjs +127 -0
package/templates/blank/next-env.d.ts +4 -0
package/templates/blank/next.config.ts +5 -0
package/templates/blank/package.json +75 -0
package/templates/blank/playwright.config.ts +21 -0
package/templates/blank/prettier.config.mjs +9 -0
package/templates/blank/proxy.ts +28 -0
package/templates/blank/src/app/api/auth/[...all]/route.ts +5 -0
package/templates/blank/src/app/api/billing/checkout/route.ts +26 -0
package/templates/blank/src/app/api/billing/portal/route.ts +25 -0
package/templates/blank/src/app/api/email/test/route.ts +28 -0
package/templates/blank/src/app/api/webhooks/polar/route.ts +5 -0
package/templates/blank/src/app/api/webhooks/stripe/route.ts +5 -0
package/templates/blank/src/app/billing/page.tsx +70 -0
package/templates/blank/src/app/email/page.tsx +46 -0
package/templates/blank/src/app/globals.css +394 -0
package/templates/blank/src/app/layout.tsx +19 -0
package/templates/blank/src/app/page.tsx +23 -0
package/templates/blank/src/app/sign-in/page.tsx +18 -0
package/templates/blank/src/app/sign-up/page.tsx +18 -0
package/templates/blank/src/components/auth/email-auth-form.test.tsx +39 -0
package/templates/blank/src/components/auth/email-auth-form.tsx +109 -0
package/templates/blank/src/components/auth/sign-out-button.tsx +29 -0
package/templates/blank/src/db/index.ts +16 -0
package/templates/blank/src/db/schema/auth.ts +4 -0
package/templates/blank/src/db/schema/index.ts +2 -0
package/templates/blank/src/db/schema/projects.ts +17 -0
package/templates/blank/src/db/seeds/index.ts +28 -0
package/templates/blank/src/lib/auth-client.ts +5 -0
package/templates/blank/src/lib/auth-session.ts +11 -0
package/templates/blank/src/lib/auth.ts +23 -0
package/templates/blank/src/lib/billing/index.ts +37 -0
package/templates/blank/src/lib/billing/providers/polar.ts +80 -0
package/templates/blank/src/lib/billing/providers/stripe.ts +77 -0
package/templates/blank/src/lib/billing/types.ts +25 -0
package/templates/blank/src/lib/email/index.ts +19 -0
package/templates/blank/src/lib/email/templates.test.ts +15 -0
package/templates/blank/src/lib/email/templates.ts +40 -0
package/templates/blank/src/lib/env.ts +80 -0
package/templates/blank/tsconfig.json +34 -0
package/templates/blank/vitest.config.ts +19 -0
package/templates/dashboard/.env.example +16 -0
package/templates/dashboard/.github/workflows/ci.yml +34 -0
package/templates/dashboard/.husky/pre-commit +3 -0
package/templates/dashboard/.husky/pre-push +3 -0
package/templates/dashboard/.prettierignore +3 -0
package/templates/dashboard/drizzle.config.ts +16 -0
package/templates/dashboard/eslint.config.mjs +127 -0
package/templates/dashboard/next-env.d.ts +4 -0
package/templates/dashboard/next.config.ts +5 -0
package/templates/dashboard/package.json +75 -0
package/templates/dashboard/playwright.config.ts +21 -0
package/templates/dashboard/prettier.config.mjs +9 -0
package/templates/dashboard/proxy.ts +36 -0
package/templates/dashboard/src/app/api/auth/[...all]/route.ts +5 -0
package/templates/dashboard/src/app/api/billing/checkout/route.ts +26 -0
package/templates/dashboard/src/app/api/billing/portal/route.ts +25 -0
package/templates/dashboard/src/app/api/email/test/route.ts +28 -0
package/templates/dashboard/src/app/api/webhooks/polar/route.ts +5 -0
package/templates/dashboard/src/app/api/webhooks/stripe/route.ts +5 -0
package/templates/dashboard/src/app/billing/layout.tsx +22 -0
package/templates/dashboard/src/app/billing/page.tsx +73 -0
package/templates/dashboard/src/app/dashboard/layout.tsx +22 -0
package/templates/dashboard/src/app/dashboard/page.tsx +104 -0
package/templates/dashboard/src/app/email/layout.tsx +22 -0
package/templates/dashboard/src/app/email/page.tsx +54 -0
package/templates/dashboard/src/app/globals.css +1357 -0
package/templates/dashboard/src/app/layout.tsx +25 -0
package/templates/dashboard/src/app/page.tsx +154 -0
package/templates/dashboard/src/app/settings/layout.tsx +22 -0
package/templates/dashboard/src/app/settings/page.tsx +85 -0
package/templates/dashboard/src/app/sign-in/page.tsx +47 -0
package/templates/dashboard/src/app/sign-up/page.tsx +47 -0
package/templates/dashboard/src/components/auth/email-auth-form.test.tsx +39 -0
package/templates/dashboard/src/components/auth/email-auth-form.tsx +160 -0
package/templates/dashboard/src/components/auth/sign-out-button.tsx +29 -0
package/templates/dashboard/src/components/dashboard/shell.tsx +158 -0
package/templates/dashboard/src/db/index.ts +16 -0
package/templates/dashboard/src/db/schema/auth.ts +4 -0
package/templates/dashboard/src/db/schema/index.ts +2 -0
package/templates/dashboard/src/db/schema/projects.ts +17 -0
package/templates/dashboard/src/db/seeds/index.ts +28 -0
package/templates/dashboard/src/lib/auth-client.ts +5 -0
package/templates/dashboard/src/lib/auth-session.ts +11 -0
package/templates/dashboard/src/lib/auth.ts +41 -0
package/templates/dashboard/src/lib/billing/index.ts +37 -0
package/templates/dashboard/src/lib/billing/providers/polar.ts +80 -0
package/templates/dashboard/src/lib/billing/providers/stripe.ts +77 -0
package/templates/dashboard/src/lib/billing/types.ts +25 -0
package/templates/dashboard/src/lib/email/index.ts +19 -0
package/templates/dashboard/src/lib/email/templates.test.ts +15 -0
package/templates/dashboard/src/lib/email/templates.ts +40 -0
package/templates/dashboard/src/lib/env.ts +88 -0
package/templates/dashboard/tsconfig.json +34 -0
package/templates/dashboard/vitest.config.ts +19 -0

package/templates/dashboard/src/app/layout.tsx ADDED Viewed

@@ -0,0 +1,25 @@
+import type { Metadata } from "next";
+import "./globals.css";
+export const metadata: Metadata = {
+  title: "__PROJECT_NAME__",
+  description: "Generated by Skit",
+  metadataBase: new URL(process.env.NEXT_PUBLIC_APP_URL ?? "http://localhost:3000"),
+  openGraph: {
+    title: "__PROJECT_NAME__",
+    description: "Generated by Skit",
+    type: "website"
+  }
+};
+export default function RootLayout({
+  children
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/dashboard/src/app/page.tsx ADDED Viewed

@@ -0,0 +1,154 @@
+import Link from "next/link";
+export default function HomePage() {
+  return (
+    <main className="landing">
+      <nav className="landing-nav">
+        <div className="logo">
+          launch<span>frame</span>
+        </div>
+        <div className="landing-nav-links">
+          <Link href="/sign-in">Sign in</Link>
+          <Link href="/sign-up" className="nav-cta">Get started</Link>
+        </div>
+      </nav>
+      <section className="landing-hero">
+        <p className="eyebrow">Ship faster in 2026</p>
+        <h1>
+          Build your SaaS <em>without the boilerplate.</em>
+        </h1>
+        <p className="lede">
+          Auth, billing, email, database — all wired up and ready.
+          Stop rebuilding infrastructure and start shipping your product.
+        </p>
+        <div className="hero-actions">
+          <Link href="/sign-up" className="btn-primary">Start building free</Link>
+          <Link href="/dashboard" className="btn-secondary">Open dashboard</Link>
+        </div>
+      </section>
+      <section className="social-proof">
+        <p>Trusted by teams at</p>
+        <div className="social-proof-logos">
+          <span>Vercel</span>
+          <span>Supabase</span>
+          <span>Linear</span>
+          <span>Resend</span>
+        </div>
+      </section>
+      <section className="bento-section">
+        <p className="eyebrow">Everything included</p>
+        <h2>Production-ready from day one</h2>
+        <div className="bento-grid">
+          <div className="bento-card span-2">
+            <div className="bento-card-icon">🔐</div>
+            <h3>Authentication</h3>
+            <p>
+              Email and password auth with Better Auth. Session management, protected routes,
+              and middleware — all pre-configured and type-safe.
+            </p>
+            <div className="tag-row">
+              <span className="bento-tag">Better Auth</span>
+              <span className="bento-tag">Server sessions</span>
+              <span className="bento-tag">Edge middleware</span>
+            </div>
+          </div>
+          <div className="bento-card">
+            <div className="bento-card-icon">💳</div>
+            <h3>Billing</h3>
+            <p>
+              Stripe and Polar checkout flows with a provider abstraction you can extend.
+            </p>
+            <div className="tag-row">
+              <span className="bento-tag">Stripe</span>
+              <span className="bento-tag">Polar</span>
+            </div>
+          </div>
+          <div className="bento-card">
+            <div className="bento-card-icon">🗄️</div>
+            <h3>Database</h3>
+            <p>
+              Drizzle ORM with migrations, seeds, and a typed schema ready for your models.
+            </p>
+            <div className="tag-row">
+              <span className="bento-tag">Drizzle</span>
+              <span className="bento-tag">PostgreSQL</span>
+            </div>
+          </div>
+          <div className="bento-card span-2">
+            <div className="bento-card-icon">📧</div>
+            <h3>Transactional email</h3>
+            <p>
+              Resend integration with HTML templates for welcome emails, password resets,
+              and billing notifications. Test from the dashboard to verify wiring.
+            </p>
+            <div className="tag-row">
+              <span className="bento-tag">Resend</span>
+              <span className="bento-tag">HTML templates</span>
+              <span className="bento-tag">Test harness</span>
+            </div>
+          </div>
+          <div className="bento-card">
+            <div className="bento-card-icon">🧪</div>
+            <h3>Testing</h3>
+            <p>
+              Vitest for unit tests, Playwright for E2E. Pre-commit hooks enforce quality.
+            </p>
+            <div className="tag-row">
+              <span className="bento-tag">Vitest</span>
+              <span className="bento-tag">Playwright</span>
+              <span className="bento-tag">Husky</span>
+            </div>
+          </div>
+          <div className="bento-card">
+            <div className="bento-card-icon">⚡</div>
+            <h3>Next.js 16</h3>
+            <p>
+              App Router, React 19, server components, and the latest compiler out of the box.
+            </p>
+            <div className="tag-row">
+              <span className="bento-tag">App Router</span>
+              <span className="bento-tag">React 19</span>
+            </div>
+          </div>
+          <div className="bento-card">
+            <div className="bento-card-icon">🤖</div>
+            <h3>Agent-friendly</h3>
+            <p>
+              AGENTS.md, explicit placeholders, and a flat file tree that AI coding assistants love.
+            </p>
+            <div className="tag-row">
+              <span className="bento-tag">Cursor</span>
+              <span className="bento-tag">Copilot</span>
+            </div>
+          </div>
+        </div>
+      </section>
+      <section className="cta-section">
+        <h2>Ready to ship?</h2>
+        <p>
+          Generate your project in seconds. Everything is yours to customize —
+          no vendor lock-in, no hidden abstractions.
+        </p>
+        <div className="hero-actions">
+          <Link href="/sign-up" className="btn-primary">Create your account</Link>
+          <Link href="/sign-in" className="btn-secondary">Sign in</Link>
+        </div>
+      </section>
+      <footer className="landing-footer">
+        <p>Built with Skit — open source SaaS starter for Next.js</p>
+      </footer>
+    </main>
+  );
+}

package/templates/dashboard/src/app/settings/layout.tsx ADDED Viewed

@@ -0,0 +1,22 @@
+import { redirect } from "next/navigation";
+import { getSession } from "@/lib/auth-session";
+import { DashboardShell } from "@/components/dashboard/shell";
+export default async function SettingsLayout({
+  children
+}: {
+  children: React.ReactNode;
+}) {
+  const session = await getSession();
+  if (!session) {
+    redirect("/sign-in");
+  }
+  return (
+    <DashboardShell user={session.user}>
+      {children}
+    </DashboardShell>
+  );
+}

package/templates/dashboard/src/app/settings/page.tsx ADDED Viewed

@@ -0,0 +1,85 @@
+import { getSession } from "@/lib/auth-session";
+export default async function SettingsPage() {
+  const session = await getSession();
+  return (
+    <>
+      <header className="dashboard-header">
+        <div>
+          <h1>Settings</h1>
+          <p className="lede" style={{ marginTop: 4, fontSize: "0.9375rem" }}>
+            Manage your account and preferences.
+          </p>
+        </div>
+      </header>
+      <div className="settings-grid">
+        <section className="settings-section">
+          <h3>Profile</h3>
+          <p>Update your personal information.</p>
+          <div className="settings-fields">
+            <div className="settings-row">
+              <label className="field">
+                <span>Name</span>
+                <input
+                  type="text"
+                  defaultValue={session?.user.name || ""}
+                  placeholder="Your name"
+                />
+              </label>
+            </div>
+            <div className="settings-row">
+              <label className="field">
+                <span>Email</span>
+                <input
+                  type="email"
+                  defaultValue={session?.user.email || ""}
+                  placeholder="you@example.com"
+                  disabled
+                />
+              </label>
+            </div>
+            <div className="settings-actions">
+              <button className="btn-primary" disabled>Save changes</button>
+            </div>
+          </div>
+        </section>
+        <section className="settings-section">
+          <h3>Notifications</h3>
+          <p>Choose what you want to be notified about.</p>
+          <div className="toggle-row">
+            <div className="toggle-label">
+              <strong>Product updates</strong>
+              <p>Get notified about new features and improvements.</p>
+            </div>
+            <div className="toggle-switch on" />
+          </div>
+          <div className="toggle-row">
+            <div className="toggle-label">
+              <strong>Billing alerts</strong>
+              <p>Receive alerts about billing events and invoices.</p>
+            </div>
+            <div className="toggle-switch on" />
+          </div>
+          <div className="toggle-row">
+            <div className="toggle-label">
+              <strong>Marketing emails</strong>
+              <p>Occasional updates about tips and best practices.</p>
+            </div>
+            <div className="toggle-switch" />
+          </div>
+        </section>
+        <section className="settings-section danger-zone">
+          <h3>Danger zone</h3>
+          <p>Irreversible actions for your account.</p>
+          <button className="btn-ghost" style={{ color: "var(--color-danger)" }}>
+            Delete account
+          </button>
+        </section>
+      </div>
+    </>
+  );
+}

package/templates/dashboard/src/app/sign-in/page.tsx ADDED Viewed

@@ -0,0 +1,47 @@
+import { redirect } from "next/navigation";
+import { EmailAuthForm } from "@/components/auth/email-auth-form";
+import { getSession } from "@/lib/auth-session";
+export default async function SignInPage() {
+  const session = await getSession();
+  if (session) {
+    redirect("/dashboard");
+  }
+  return (
+    <main className="auth-screen">
+      <div className="auth-brand">
+        <div className="logo">
+          launch<span>frame</span>
+        </div>
+        <blockquote>
+          Stop rebuilding auth, billing, and email for every new project.
+          <cite>— Ship what matters, not infrastructure</cite>
+        </blockquote>
+        <div className="auth-features">
+          <div className="auth-feature-item">
+            <div className="auth-feature-check">✓</div>
+            <span>Authentication with session management</span>
+          </div>
+          <div className="auth-feature-item">
+            <div className="auth-feature-check">✓</div>
+            <span>Stripe & Polar billing ready</span>
+          </div>
+          <div className="auth-feature-item">
+            <div className="auth-feature-check">✓</div>
+            <span>Transactional email wired</span>
+          </div>
+          <div className="auth-feature-item">
+            <div className="auth-feature-check">✓</div>
+            <span>Database with migrations & seeds</span>
+          </div>
+        </div>
+      </div>
+      <div className="auth-form-side">
+        <EmailAuthForm mode="sign-in" />
+      </div>
+    </main>
+  );
+}

package/templates/dashboard/src/app/sign-up/page.tsx ADDED Viewed

@@ -0,0 +1,47 @@
+import { redirect } from "next/navigation";
+import { EmailAuthForm } from "@/components/auth/email-auth-form";
+import { getSession } from "@/lib/auth-session";
+export default async function SignUpPage() {
+  const session = await getSession();
+  if (session) {
+    redirect("/dashboard");
+  }
+  return (
+    <main className="auth-screen">
+      <div className="auth-brand">
+        <div className="logo">
+          launch<span>frame</span>
+        </div>
+        <blockquote>
+          From zero to production SaaS in minutes, not months.
+          <cite>— Your foundation, your rules</cite>
+        </blockquote>
+        <div className="auth-features">
+          <div className="auth-feature-item">
+            <div className="auth-feature-check">✓</div>
+            <span>Next.js 16 with App Router</span>
+          </div>
+          <div className="auth-feature-item">
+            <div className="auth-feature-check">✓</div>
+            <span>TypeScript strict mode</span>
+          </div>
+          <div className="auth-feature-item">
+            <div className="auth-feature-check">✓</div>
+            <span>Testing with Vitest & Playwright</span>
+          </div>
+          <div className="auth-feature-item">
+            <div className="auth-feature-check">✓</div>
+            <span>CI/CD with GitHub Actions</span>
+          </div>
+        </div>
+      </div>
+      <div className="auth-form-side">
+        <EmailAuthForm mode="sign-up" />
+      </div>
+    </main>
+  );
+}

package/templates/dashboard/src/components/auth/email-auth-form.test.tsx ADDED Viewed

@@ -0,0 +1,39 @@
+import { render, screen } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import { EmailAuthForm } from "@/components/auth/email-auth-form";
+import type { ReactNode } from "react";
+vi.mock("next/link", () => ({
+  default: ({ children, href }: { children: ReactNode; href: string }) => (
+    <a href={href}>{children}</a>
+  )
+}));
+vi.mock("next/navigation", () => ({
+  useRouter: () => ({
+    push: vi.fn(),
+    refresh: vi.fn()
+  })
+}));
+vi.mock("@/lib/auth-client", () => ({
+  authClient: {
+    signIn: {
+      email: vi.fn()
+    },
+    signUp: {
+      email: vi.fn()
+    }
+  }
+}));
+describe("EmailAuthForm", () => {
+  it("renders sign-up mode copy", () => {
+    render(<EmailAuthForm mode="sign-up" />);
+    expect(screen.getByRole("heading", { name: /create your operator account/i })).toBeTruthy();
+    expect(screen.getByLabelText(/password/i)).toBeTruthy();
+  });
+});

package/templates/dashboard/src/components/auth/email-auth-form.tsx ADDED Viewed

@@ -0,0 +1,160 @@
+"use client";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useState } from "react";
+import { authClient } from "@/lib/auth-client";
+type EmailAuthFormProps = {
+  mode: "sign-in" | "sign-up";
+};
+export function EmailAuthForm({ mode }: EmailAuthFormProps) {
+  const isSignUp = mode === "sign-up";
+  const router = useRouter();
+  const [error, setError] = useState<string | null>(null);
+  const [isPending, setIsPending] = useState(false);
+  async function handleSocialSignIn(provider: "github" | "google") {
+    setIsPending(true);
+    setError(null);
+    try {
+      const result = await authClient.signIn.social({
+        provider,
+        callbackURL: "/dashboard"
+      });
+      if (result.error) {
+        setError(result.error.message ?? `${provider} sign-in failed.`);
+      }
+    } catch {
+      setError(`${provider} sign-in failed.`);
+    } finally {
+      setIsPending(false);
+    }
+  }
+  async function handleSubmit(formData: FormData) {
+    const email = String(formData.get("email") ?? "");
+    const password = String(formData.get("password") ?? "");
+    const name = String(formData.get("name") ?? "");
+    setIsPending(true);
+    setError(null);
+    try {
+      const result = isSignUp
+        ? await authClient.signUp.email({
+            email,
+            password,
+            name
+          })
+        : await authClient.signIn.email({
+            email,
+            password
+          });
+      if (result.error) {
+        setError(result.error.message ?? "Authentication failed.");
+        return;
+      }
+      router.push("/dashboard");
+      router.refresh();
+    } catch {
+      setError("Authentication failed.");
+    } finally {
+      setIsPending(false);
+    }
+  }
+  return (
+    <form
+      action={(formData) => {
+        void handleSubmit(formData);
+      }}
+      className="auth-panel"
+    >
+      <div>
+        <p className="eyebrow">{isSignUp ? "Create account" : "Access dashboard"}</p>
+        <h1>{isSignUp ? "Create your operator account" : "Sign in"}</h1>
+        <p className="lede">
+          {isSignUp
+            ? "Create an account to access the protected dashboard shell."
+            : "Use your email and password to continue into the app."}
+        </p>
+      </div>
+      <div className="auth-social-buttons">
+        <button
+          type="button"
+          className="auth-social-btn"
+          onClick={() => { void handleSocialSignIn("google"); }}
+          disabled={isPending}
+        >
+          <svg viewBox="0 0 24 24" width="18" height="18" aria-hidden="true">
+            <path d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z" fill="#4285F4" />
+            <path d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z" fill="#34A853" />
+            <path d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l2.85-2.22.81-.62z" fill="#FBBC05" />
+            <path d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z" fill="#EA4335" />
+          </svg>
+          Continue with Google
+        </button>
+        <button
+          type="button"
+          className="auth-social-btn"
+          onClick={() => { void handleSocialSignIn("github"); }}
+          disabled={isPending}
+        >
+          <svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor" aria-hidden="true">
+            <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" />
+          </svg>
+          Continue with GitHub
+        </button>
+      </div>
+      <div className="auth-divider">
+        <span>or continue with email</span>
+      </div>
+      <div className="auth-grid">
+        {isSignUp ? (
+          <label className="field">
+            <span>Name</span>
+            <input name="name" type="text" placeholder="Ada Lovelace" required />
+          </label>
+        ) : null}
+        <label className="field">
+          <span>Email</span>
+          <input name="email" type="email" placeholder="you@example.com" required />
+        </label>
+        <label className="field">
+          <span>Password</span>
+          <input
+            name="password"
+            type="password"
+            placeholder="At least 8 characters"
+            minLength={8}
+            required
+          />
+        </label>
+      </div>
+      {error ? <p className="form-error">{error}</p> : null}
+      <button type="submit" className="auth-button" disabled={isPending}>
+        {isPending ? "Working..." : isSignUp ? "Create account" : "Sign in"}
+      </button>
+      <p className="auth-switch">
+        {isSignUp ? "Already have an account?" : "Need an account?"}{" "}
+        <Link href={isSignUp ? "/sign-in" : "/sign-up"}>
+          {isSignUp ? "Sign in" : "Create one"}
+        </Link>
+      </p>
+    </form>
+  );
+}

package/templates/dashboard/src/components/auth/sign-out-button.tsx ADDED Viewed

@@ -0,0 +1,29 @@
+"use client";
+import { useRouter } from "next/navigation";
+import { useState } from "react";
+import { authClient } from "@/lib/auth-client";
+export function SignOutButton() {
+  const router = useRouter();
+  const [isPending, setIsPending] = useState(false);
+  async function handleSignOut() {
+    setIsPending(true);
+    try {
+      await authClient.signOut();
+      router.push("/sign-in");
+      router.refresh();
+    } finally {
+      setIsPending(false);
+    }
+  }
+  return (
+    <button type="button" className="btn-ghost" onClick={() => void handleSignOut()}>
+      {isPending ? "Signing out..." : "Sign out"}
+    </button>
+  );
+}