create-skit 0.1.0

package/templates/blank/src/app/api/email/test/route.ts

@@ -0,0 +1,28 @@
+import { redirect } from "next/navigation";
+
+import { getSession } from "@/lib/auth-session";
+import { sendEmail } from "@/lib/email";
+import { createWelcomeEmailTemplate } from "@/lib/email/templates";
+import { env } from "@/lib/env";
+
+export async function POST() {
+  const session = await getSession();
+
+  if (!session) {
+    redirect("/sign-in");
+  }
+
+  if (env.EMAIL_PROVIDER === "none") {
+    redirect("/email");
+  }
+
+  await sendEmail({
+    to: session.user.email,
+    template: createWelcomeEmailTemplate({
+      appName: "Skit",
+      recipientName: session.user.name
+    })
+  });
+
+  redirect("/email?sent=1");
+}

package/templates/blank/src/app/api/webhooks/polar/route.ts

@@ -0,0 +1,5 @@
+__POLAR_WEBHOOK_ROUTE_IMPORT__
+
+export async function POST(__POLAR_WEBHOOK_ROUTE_SIGNATURE__) {
+__POLAR_WEBHOOK_ROUTE_BODY__
+}

package/templates/blank/src/app/api/webhooks/stripe/route.ts

@@ -0,0 +1,5 @@
+__STRIPE_WEBHOOK_ROUTE_IMPORT__
+
+export async function POST(__STRIPE_WEBHOOK_ROUTE_SIGNATURE__) {
+__STRIPE_WEBHOOK_ROUTE_BODY__
+}

package/templates/blank/src/app/billing/page.tsx

@@ -0,0 +1,70 @@
+import { redirect } from "next/navigation";
+
+import { getSession } from "@/lib/auth-session";
+import { env } from "@/lib/env";
+
+export default async function BillingPage({
+  searchParams
+}: {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+}) {
+  const session = await getSession();
+
+  if (!session) {
+    redirect("/sign-in");
+  }
+
+  const params = await searchParams;
+  const success = params.success === "1";
+  const canceled = params.canceled === "1";
+  const providers =
+    env.BILLING_PROVIDER === "both"
+      ? ["stripe", "polar"]
+      : env.BILLING_PROVIDER === "none"
+        ? []
+        : [env.BILLING_PROVIDER];
+
+  return (
+    <main className="shell auth-shell">
+      <section className="auth-card">
+        <p className="eyebrow">Billing</p>
+        <h1>Choose your billing provider</h1>
+        <p className="lede">
+          Provider abstraction routes all billing actions. Current
+          default: <strong>{env.BILLING_PROVIDER}</strong>.
+        </p>
+
+        {success ? <p className="form-success">Checkout completed or redirected successfully.</p> : null}
+        {canceled ? <p className="form-error">Checkout was canceled.</p> : null}
+
+        {providers.length === 0 ? (
+          <p className="form-error">
+            Billing is disabled. Re-run the starter with a billing provider to enable checkout flows.
+          </p>
+        ) : (
+          <div className="billing-grid">
+            {providers.map((provider) => (
+              <form
+                key={provider}
+                action="/api/billing/checkout"
+                method="post"
+                className="billing-card"
+              >
+                <input type="hidden" name="provider" value={provider} />
+                <h2>{provider === "stripe" ? "Stripe" : "Polar"}</h2>
+                <p>
+                  {provider === "stripe"
+                    ? "Create a subscription checkout session using the configured Stripe price."
+                    : "Create a Polar checkout session using the configured product identifier."}
+                </p>
+                <button type="submit" className="auth-button">
+                  {provider === "stripe" ? "Start Stripe checkout" : "Start Polar checkout"}
+                </button>
+              </form>
+            ))}
+          </div>
+        )}
+      </section>
+    </main>
+  );
+}

package/templates/blank/src/app/email/page.tsx

@@ -0,0 +1,46 @@
+import Link from "next/link";
+import { redirect } from "next/navigation";
+
+import { getSession } from "@/lib/auth-session";
+import { env } from "@/lib/env";
+
+export default async function EmailPage({
+  searchParams
+}: {
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+}) {
+  const session = await getSession();
+
+  if (!session) {
+    redirect("/sign-in");
+  }
+
+  const params = await searchParams;
+  const sent = params.sent === "1";
+  const emailDisabled = env.EMAIL_PROVIDER === "none";
+
+  return (
+    <main className="shell auth-shell">
+      <section className="auth-card">
+        <p className="eyebrow">Email</p>
+        <h1>Transactional email</h1>
+        <p className="lede">
+          {emailDisabled
+            ? "Email is disabled. Set EMAIL_PROVIDER to resend to enable transactional email."
+            : "Test your Resend integration and verify that transactional email is wired correctly."}
+        </p>
+
+        {sent ? <p className="form-success">Test email sent to {session.user.email}.</p> : null}
+
+        <div className="hero-actions" style={{ justifyContent: "flex-start" }}>
+          <form action="/api/email/test" method="post">
+            <button type="submit" className="auth-button" disabled={emailDisabled}>
+              Send test email
+            </button>
+          </form>
+          <Link href="/dashboard" className="btn-ghost">Back to dashboard</Link>
+        </div>
+      </section>
+    </main>
+  );
+}

package/templates/blank/src/app/globals.css

@@ -0,0 +1,394 @@
+/* ── Skit Blank Template ── Design System ─────────────────── */
+
+@import url("https://api.fontshare.com/v2/css?f[]=satoshi@400,500,700,900&f[]=general-sans@400,500,600&display=swap");
+
+/* ── Tokens ─────────────────────────────────────────────────────── */
+
+:root {
+  --font-display: "Satoshi", system-ui, sans-serif;
+  --font-body: "General Sans", system-ui, sans-serif;
+  --font-mono: "SF Mono", "Fira Code", "JetBrains Mono", ui-monospace, monospace;
+
+  --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);
+  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
+
+  --radius-sm: 8px;
+  --radius-md: 12px;
+  --radius-lg: 16px;
+  --radius-xl: 24px;
+  --radius-full: 9999px;
+
+  --color-bg: #0a0a0f;
+  --color-bg-raised: #111118;
+  --color-bg-overlay: #16161f;
+  --color-bg-subtle: #1c1c27;
+  --color-bg-muted: #23232f;
+
+  --color-border: rgba(255, 255, 255, 0.06);
+  --color-border-hover: rgba(255, 255, 255, 0.12);
+  --color-border-active: rgba(255, 255, 255, 0.2);
+
+  --color-text: #f0eef5;
+  --color-text-secondary: #9490a5;
+  --color-text-muted: #5e5a70;
+  --color-text-inverse: #0a0a0f;
+
+  --color-accent: #00d4aa;
+  --color-accent-dim: rgba(0, 212, 170, 0.15);
+  --color-accent-glow: rgba(0, 212, 170, 0.3);
+  --color-accent-hover: #00eabc;
+
+  --color-warm: #f5a623;
+  --color-warm-dim: rgba(245, 166, 35, 0.12);
+
+  --color-danger: #f04e4e;
+  --color-danger-dim: rgba(240, 78, 78, 0.12);
+  --color-success: #34c759;
+  --color-success-dim: rgba(52, 199, 89, 0.12);
+
+  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.3);
+  --shadow-md: 0 4px 16px rgba(0, 0, 0, 0.3);
+  --shadow-lg: 0 8px 32px rgba(0, 0, 0, 0.4);
+  --shadow-glow: 0 0 40px var(--color-accent-glow);
+}
+
+/* ── Reset & base ───────────────────────────────────────────────── */
+
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+html {
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  text-rendering: optimizeLegibility;
+  scroll-behavior: smooth;
+}
+
+body {
+  font-family: var(--font-body);
+  font-size: 15px;
+  line-height: 1.6;
+  color: var(--color-text);
+  background: var(--color-bg);
+  min-height: 100dvh;
+}
+
+a { color: inherit; text-decoration: none; }
+button { cursor: pointer; font: inherit; border: none; background: none; }
+input, textarea, select { font: inherit; }
+img { display: block; max-width: 100%; }
+
+::selection {
+  background: var(--color-accent-dim);
+  color: var(--color-accent);
+}
+
+::-webkit-scrollbar { width: 6px; height: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--color-border-hover); border-radius: 3px; }
+
+body::before {
+  content: "";
+  position: fixed;
+  inset: 0;
+  z-index: 9999;
+  pointer-events: none;
+  opacity: 0.025;
+  background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 256 256' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E");
+  background-repeat: repeat;
+  background-size: 256px 256px;
+}
+
+/* ── Animations ─────────────────────────────────────────────────── */
+
+@keyframes fade-up {
+  from { opacity: 0; transform: translateY(20px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+@keyframes fade-down {
+  from { opacity: 0; transform: translateY(-10px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+@keyframes shimmer {
+  0% { background-position: -200% 0; }
+  100% { background-position: 200% 0; }
+}
+
+/* ── Typography ─────────────────────────────────────────────────── */
+
+h1, h2, h3, h4 { font-family: var(--font-display); font-weight: 700; line-height: 1.15; letter-spacing: -0.02em; color: var(--color-text); }
+h1 { font-size: clamp(2rem, 5vw, 3.5rem); font-weight: 900; letter-spacing: -0.035em; }
+h2 { font-size: clamp(1.5rem, 3vw, 2.25rem); }
+h3 { font-size: clamp(1.125rem, 2vw, 1.5rem); }
+
+.eyebrow {
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.15em;
+  color: var(--color-accent);
+}
+
+.lede {
+  font-size: 1.0625rem;
+  line-height: 1.7;
+  color: var(--color-text-secondary);
+  max-width: 540px;
+}
+
+/* ── Buttons ────────────────────────────────────────────────────── */
+
+.btn-primary, .auth-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  padding: 12px 28px;
+  font-family: var(--font-display);
+  font-weight: 600;
+  font-size: 0.9375rem;
+  color: var(--color-text-inverse);
+  background: var(--color-accent);
+  border-radius: var(--radius-full);
+  transition: all 0.2s var(--ease-out-expo);
+  position: relative;
+  overflow: hidden;
+}
+.btn-primary::before, .auth-button::before {
+  content: "";
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(135deg, transparent 40%, rgba(255, 255, 255, 0.2) 50%, transparent 60%);
+  background-size: 200% 200%;
+  animation: shimmer 3s ease-in-out infinite;
+}
+.btn-primary:hover, .auth-button:hover {
+  background: var(--color-accent-hover);
+  transform: translateY(-1px);
+  box-shadow: var(--shadow-glow);
+}
+.btn-primary:disabled, .auth-button:disabled { opacity: 0.5; pointer-events: none; }
+
+.btn-secondary {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  padding: 12px 28px;
+  font-family: var(--font-display);
+  font-weight: 600;
+  font-size: 0.9375rem;
+  color: var(--color-text);
+  background: var(--color-bg-raised);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-full);
+  transition: all 0.2s var(--ease-out-expo);
+}
+.btn-secondary:hover {
+  border-color: var(--color-border-hover);
+  background: var(--color-bg-overlay);
+  transform: translateY(-1px);
+}
+
+.btn-ghost, .subtle-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  padding: 8px 16px;
+  font-weight: 500;
+  font-size: 0.875rem;
+  color: var(--color-text-secondary);
+  border-radius: var(--radius-sm);
+  transition: all 0.15s ease;
+}
+.btn-ghost:hover, .subtle-button:hover { color: var(--color-text); background: var(--color-bg-subtle); }
+
+/* ── Form fields ────────────────────────────────────────────────── */
+
+.field {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.field span {
+  font-size: 0.8125rem;
+  font-weight: 500;
+  color: var(--color-text-secondary);
+}
+.field input {
+  padding: 11px 16px;
+  background: var(--color-bg);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-md);
+  color: var(--color-text);
+  font-size: 0.9375rem;
+  outline: none;
+  transition: all 0.2s ease;
+}
+.field input::placeholder { color: var(--color-text-muted); }
+.field input:focus {
+  border-color: var(--color-accent);
+  box-shadow: 0 0 0 3px var(--color-accent-dim);
+}
+
+.form-error {
+  padding: 12px 16px;
+  background: var(--color-danger-dim);
+  border: 1px solid rgba(240, 78, 78, 0.2);
+  border-radius: var(--radius-md);
+  color: var(--color-danger);
+  font-size: 0.875rem;
+  font-weight: 500;
+}
+.form-success {
+  padding: 12px 16px;
+  background: var(--color-success-dim);
+  border: 1px solid rgba(52, 199, 89, 0.2);
+  border-radius: var(--radius-md);
+  color: var(--color-success);
+  font-size: 0.875rem;
+  font-weight: 500;
+}
+
+/* ═══════════════════════════════════════════════════════════════════
+   LANDING PAGE
+   ═══════════════════════════════════════════════════════════════════ */
+
+.shell {
+  min-height: 100dvh;
+  position: relative;
+  overflow: hidden;
+}
+
+.shell::before, .shell::after {
+  content: "";
+  position: absolute;
+  border-radius: 50%;
+  filter: blur(120px);
+  opacity: 0.4;
+  pointer-events: none;
+}
+.shell::before {
+  width: 600px;
+  height: 600px;
+  background: radial-gradient(circle, var(--color-accent-glow), transparent 70%);
+  top: -200px;
+  right: -100px;
+}
+.shell::after {
+  width: 500px;
+  height: 500px;
+  background: radial-gradient(circle, rgba(91, 141, 239, 0.2), transparent 70%);
+  bottom: -100px;
+  left: -150px;
+}
+
+.hero {
+  max-width: 720px;
+  margin: 0 auto;
+  padding: 200px 32px 100px;
+  text-align: center;
+  position: relative;
+  z-index: 1;
+}
+.hero .eyebrow {
+  animation: fade-up 0.6s var(--ease-out-expo) 0.1s both;
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 16px;
+  background: var(--color-accent-dim);
+  border: 1px solid rgba(0, 212, 170, 0.15);
+  border-radius: var(--radius-full);
+  margin-bottom: 24px;
+}
+.hero h1 {
+  animation: fade-up 0.6s var(--ease-out-expo) 0.2s both;
+  margin-bottom: 20px;
+}
+.hero h1 em {
+  font-style: normal;
+  background: linear-gradient(135deg, var(--color-accent), #5b8def);
+  background-clip: text;
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+}
+.hero .lede {
+  animation: fade-up 0.6s var(--ease-out-expo) 0.3s both;
+  margin: 0 auto 40px;
+}
+.hero-actions {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 12px;
+  flex-wrap: wrap;
+  animation: fade-up 0.6s var(--ease-out-expo) 0.4s both;
+}
+
+/* ═══════════════════════════════════════════════════════════════════
+   AUTH SCREENS
+   ═══════════════════════════════════════════════════════════════════ */
+
+.auth-shell {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 40px 20px;
+}
+
+.auth-card {
+  width: 100%;
+  max-width: 420px;
+  display: flex;
+  flex-direction: column;
+  gap: 24px;
+  animation: fade-up 0.5s var(--ease-out-expo);
+  position: relative;
+  z-index: 1;
+}
+.auth-card h1 { font-size: 1.75rem; }
+
+.auth-copy { display: flex; flex-direction: column; gap: 8px; }
+.auth-copy .lede { font-size: 0.9375rem; }
+.auth-fields { display: flex; flex-direction: column; gap: 16px; }
+
+.auth-switch {
+  font-size: 0.875rem;
+  color: var(--color-text-secondary);
+  text-align: center;
+}
+.auth-switch a {
+  color: var(--color-accent);
+  font-weight: 500;
+  transition: color 0.15s ease;
+}
+.auth-switch a:hover { color: var(--color-accent-hover); }
+
+/* ═══════════════════════════════════════════════════════════════════
+   BILLING & EMAIL
+   ═══════════════════════════════════════════════════════════════════ */
+
+.billing-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+  gap: 16px;
+  margin-top: 24px;
+}
+.billing-card {
+  background: var(--color-bg-raised);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-lg);
+  padding: 24px;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  transition: all 0.25s var(--ease-out-expo);
+}
+.billing-card:hover {
+  border-color: var(--color-border-hover);
+  transform: translateY(-2px);
+}
+.billing-card h2 { font-size: 1.25rem; }
+.billing-card p { font-size: 0.875rem; color: var(--color-text-secondary); line-height: 1.6; flex: 1; }

package/templates/blank/src/app/layout.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from "next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "__PROJECT_NAME__",
+  description: "Generated by Skit"
+};
+
+export default function RootLayout({
+  children
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/blank/src/app/page.tsx

@@ -0,0 +1,23 @@
+import Link from "next/link";
+
+export default function HomePage() {
+  return (
+    <main className="shell">
+      <section className="hero">
+        <p className="eyebrow">Skit</p>
+        <h1>
+          Start with a <em>clean SaaS baseline.</em>
+        </h1>
+        <p className="lede">
+          Auth, billing, email, and database scaffolding — all wired up.
+          A minimal foundation ready for real product work.
+        </p>
+        <div className="hero-actions">
+          <Link href="/sign-up" className="btn-primary">Create account</Link>
+          <Link href="/sign-in" className="btn-secondary">Sign in</Link>
+          <Link href="/dashboard" className="btn-ghost">Open dashboard</Link>
+        </div>
+      </section>
+    </main>
+  );
+}

package/templates/blank/src/app/sign-in/page.tsx

@@ -0,0 +1,18 @@
+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="shell auth-shell">
+      <EmailAuthForm mode="sign-in" />
+    </main>
+  );
+}

package/templates/blank/src/app/sign-up/page.tsx

@@ -0,0 +1,18 @@
+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="shell auth-shell">
+      <EmailAuthForm mode="sign-up" />
+    </main>
+  );
+}

package/templates/blank/src/components/auth/email-auth-form.test.tsx

@@ -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-in mode copy", () => {
+    render(<EmailAuthForm mode="sign-in" />);
+
+    expect(screen.getByRole("heading", { name: /sign in to your workspace/i })).toBeTruthy();
+    expect(screen.getByLabelText(/email/i)).toBeTruthy();
+  });
+});