create-skit 0.1.0

package/templates/base-web/eslint.config.mjs

@@ -0,0 +1,127 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { defineConfig, globalIgnores } from "eslint/config";
+import prettier from "eslint-config-prettier/flat";
+import nextTs from "eslint-config-next/typescript";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import importPlugin from "eslint-plugin-import";
+import unusedImports from "eslint-plugin-unused-imports";
+import globals from "globals";
+
+const SOURCE_FILES = ["**/*.{js,mjs,cjs,ts,mts,cts,jsx,tsx}"];
+const dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  {
+    files: SOURCE_FILES,
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: dirname
+      },
+      globals: {
+        ...globals.browser,
+        ...globals.nodeBuiltin
+      }
+    },
+    plugins: {
+      import: importPlugin,
+      "unused-imports": unusedImports
+    },
+    settings: {
+      "import/resolver": {
+        typescript: true
+      }
+    },
+    rules: {
+      "@typescript-eslint/consistent-type-imports": [
+        "error",
+        {
+          prefer: "type-imports",
+          fixStyle: "inline-type-imports"
+        }
+      ],
+      "@typescript-eslint/no-floating-promises": "error",
+      "@typescript-eslint/no-misused-promises": [
+        "error",
+        {
+          checksVoidReturn: {
+            attributes: false
+          }
+        }
+      ],
+      "@typescript-eslint/no-unused-vars": "off",
+      "import/first": "error",
+      "import/newline-after-import": "error",
+      "import/no-duplicates": "error",
+      "import/order": [
+        "error",
+        {
+          groups: [
+            "builtin",
+            "external",
+            "internal",
+            ["parent", "sibling", "index"],
+            "object",
+            "type"
+          ],
+          alphabetize: {
+            order: "asc",
+            caseInsensitive: true
+          },
+          "newlines-between": "always",
+          pathGroups: [
+            {
+              pattern: "@/**",
+              group: "internal",
+              position: "before"
+            }
+          ],
+          pathGroupsExcludedImportTypes: ["builtin"]
+        }
+      ],
+      "unused-imports/no-unused-imports": "error",
+      "unused-imports/no-unused-vars": [
+        "warn",
+        {
+          vars: "all",
+          varsIgnorePattern: "^_",
+          args: "after-used",
+          argsIgnorePattern: "^_"
+        }
+      ]
+    }
+  },
+  {
+    files: SOURCE_FILES,
+    ignores: ["drizzle.config.ts", "src/lib/env.ts"],
+    rules: {
+      "no-restricted-properties": [
+        "error",
+        {
+          object: "process",
+          property: "env",
+          message: "Use the validated env object from src/lib/env.ts."
+        }
+      ]
+    }
+  },
+  prettier,
+  globalIgnores([
+    ".next/**",
+    "out/**",
+    "build/**",
+    "coverage/**",
+    "drizzle.config.ts",
+    "eslint.config.mjs",
+    "next.config.ts",
+    "playwright.config.ts",
+    "prettier.config.mjs",
+    "proxy.ts",
+    "next-env.d.ts",
+    "vitest.config.ts"
+  ])
+]);

package/templates/base-web/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "base-web",
+  "sharedFileCount": 37,
+  "description": "Shared baseline extracted from identical files in blank and dashboard templates."
+}

package/templates/base-web/next-env.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// This file is managed by Next.js.

package/templates/base-web/next.config.ts

@@ -0,0 +1,5 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {};
+
+export default nextConfig;

package/templates/base-web/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "packageManager": "__PACKAGE_MANAGER__",
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint . --max-warnings=0",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier . --write",
+    "format:check": "prettier . --check",
+    "check": "__CHECK_COMMAND__",
+    "prepare": "husky",
+    "lint-staged": "lint-staged",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "test:e2e:headed": "playwright test --headed",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "db:studio": "drizzle-kit studio",
+    "db:seed": "tsx src/db/seeds/index.ts",
+    "auth:generate": "npx @better-auth/cli@latest generate --config src/lib/auth.ts --output src/db/schema/auth.ts",
+    "auth:secret": "npx @better-auth/cli@latest secret"
+  },
+  "dependencies": {
+    "better-auth": "1.3.8",
+    "drizzle-orm": "0.44.x",
+    "next": "16.2.x",
+__DATABASE_DEPENDENCIES__
+    "react": "19.2.x",
+    "react-dom": "19.2.x",
+__PROVIDER_PACKAGE_DEPENDENCIES__
+    "server-only": "^0.0.1",
+    "zod": "4.1.5"
+  },
+  "devDependencies": {
+    "@better-auth/cli": "1.3.8",
+    "@playwright/test": "1.55.0",
+    "@testing-library/react": "16.3.0",
+    "@types/node": "^24.0.0",
+__DATABASE_DEV_DEPENDENCIES__
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "drizzle-kit": "0.31.x",
+    "eslint": "9.35.0",
+    "eslint-config-next": "16.2.x",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-import-resolver-typescript": "^3.10.1",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-unused-imports": "4.2.0",
+    "globals": "16.3.0",
+    "husky": "^9.1.7",
+    "jsdom": "26.1.0",
+    "lint-staged": "^16.1.6",
+    "playwright": "1.55.0",
+    "prettier": "3.6.2",
+    "tsx": "4.20.x",
+    "typescript": "5.9.x",
+    "vitest": "3.2.4"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,mjs,cjs}": [
+      "eslint --fix"
+    ],
+    "*.{json,md,css,yml,yaml,html}": [
+      "prettier --write"
+    ]
+  }
+}

package/templates/base-web/playwright.config.ts

@@ -0,0 +1,21 @@
+import { defineConfig, devices } from "@playwright/test";
+
+export default defineConfig({
+  testDir: "./tests/e2e",
+  fullyParallel: true,
+  use: {
+    baseURL: "http://127.0.0.1:3000",
+    trace: "on-first-retry"
+  },
+  webServer: {
+    command: "npm run dev",
+    url: "http://127.0.0.1:3000",
+    reuseExistingServer: !process.env.CI
+  },
+  projects: [
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] }
+    }
+  ]
+});

package/templates/base-web/prettier.config.mjs

@@ -0,0 +1,9 @@
+/** @type {import("prettier").Config} */
+const config = {
+  semi: true,
+  singleQuote: false,
+  trailingComma: "none",
+  printWidth: 88
+};
+
+export default config;

package/templates/base-web/proxy.ts

@@ -0,0 +1,23 @@
+import { NextResponse } from "next/server";
+import type { NextRequest } from "next/server";
+
+import { getSessionCookie } from "better-auth/cookies";
+
+export function proxy(request: NextRequest) {
+  const sessionCookie = getSessionCookie(request);
+  const { pathname } = request.nextUrl;
+
+  if (!sessionCookie && (__PROTECTED_ROUTE_CONDITION__)) {
+    return NextResponse.redirect(new URL("/sign-in", request.url));
+  }
+
+  if (sessionCookie && (pathname === "/sign-in" || pathname === "/sign-up")) {
+    return NextResponse.redirect(new URL("/dashboard", request.url));
+  }
+
+  return NextResponse.next();
+}
+
+export const config = {
+  matcher: [__PROTECTED_ROUTE_MATCHERS__, "/sign-in", "/sign-up"]
+};

package/templates/base-web/src/app/api/auth/[...all]/route.ts

@@ -0,0 +1,5 @@
+import { toNextJsHandler } from "better-auth/next-js";
+
+import { auth } from "@/lib/auth";
+
+export const { GET, POST } = toNextJsHandler(auth);

package/templates/base-web/src/app/api/billing/checkout/route.ts

@@ -0,0 +1,26 @@
+import { redirect } from "next/navigation";
+
+import { getSession } from "@/lib/auth-session";
+import { getBillingProvider, getBillingProviderName } from "@/lib/billing";
+import { env } from "@/lib/env";
+
+export async function POST(request: Request) {
+  const session = await getSession();
+
+  if (!session) {
+    redirect("/sign-in");
+  }
+
+  const formData = await request.formData();
+  const selected = String(formData.get("provider") ?? "");
+  const providerName = getBillingProviderName(selected);
+  const provider = getBillingProvider(providerName);
+  const checkout = await provider.createCheckoutSession({
+    userId: session.user.id,
+    customerEmail: session.user.email,
+    successUrl: `${env.NEXT_PUBLIC_APP_URL}/billing?success=1&provider=${providerName}`,
+    cancelUrl: `${env.NEXT_PUBLIC_APP_URL}/billing?canceled=1&provider=${providerName}`
+  });
+
+  redirect(checkout.url);
+}

package/templates/base-web/src/app/api/billing/portal/route.ts

@@ -0,0 +1,25 @@
+import { redirect } from "next/navigation";
+
+import { getSession } from "@/lib/auth-session";
+import { getBillingProvider, getBillingProviderName } from "@/lib/billing";
+import { env } from "@/lib/env";
+
+export async function POST(request: Request) {
+  const session = await getSession();
+
+  if (!session) {
+    redirect("/sign-in");
+  }
+
+  const formData = await request.formData();
+  const selected = String(formData.get("provider") ?? "");
+  const providerName = getBillingProviderName(selected);
+  const provider = getBillingProvider(providerName);
+  const portal = await provider.createCustomerPortalSession({
+    userId: session.user.id,
+    customerEmail: session.user.email,
+    returnUrl: `${env.NEXT_PUBLIC_APP_URL}/billing?provider=${providerName}`
+  });
+
+  redirect(portal.url);
+}

package/templates/base-web/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/base-web/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/base-web/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/base-web/src/app/billing/page.tsx

@@ -0,0 +1,55 @@
+__BILLING_REDIRECT_IMPORT__
+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();
+
+__BILLING_SESSION_SETUP__
+__BILLING_AUTH_GUARD__
+
+  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="__AUTH_SCREEN_CLASS__">
+      <section className="__AUTH_PANEL_CLASS__">
+        <p className="eyebrow">Billing</p>
+        <h1>Choose your billing provider</h1>
+        <p className="lede">
+          The starter routes all billing actions through a provider abstraction. 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}
+
+__BILLING_DEMO_BANNER__
+
+        {providers.length === 0 ? (
+          <p className="form-error">
+            Billing is disabled for this generated app. Re-run the starter with a billing
+            provider to enable checkout flows.
+          </p>
+        ) : (
+          <div className="billing-grid">
+            {providers.map((provider) => (
+__BILLING_PROVIDER_CARD__
+            ))}
+          </div>
+        )}
+      </section>
+    </main>
+  );
+}

package/templates/base-web/src/app/dashboard/page.tsx

@@ -0,0 +1,15 @@
+import Link from "next/link";
+__DASHBOARD_REDIRECT_IMPORT__
+import { SignOutButton } from "@/components/auth/sign-out-button";
+import { getSession } from "@/lib/auth-session";
+
+__DASHBOARD_PAGE_PRELUDE__
+
+export default async function DashboardPage() {
+  const session = await getSession();
+
+__DASHBOARD_SESSION_SETUP__
+__DASHBOARD_AUTH_GUARD__
+
+  return __DASHBOARD_PAGE_CONTENT__;
+}

package/templates/base-web/src/app/email/page.tsx

@@ -0,0 +1,46 @@
+import Link from "next/link";
+__EMAIL_REDIRECT_IMPORT__
+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();
+
+__EMAIL_SESSION_SETUP__
+__EMAIL_AUTH_GUARD__
+
+  const params = await searchParams;
+  const sent = params.sent === "1";
+  const emailDisabled = env.EMAIL_PROVIDER === "none";
+
+  return (
+    <main className="__AUTH_SCREEN_CLASS__">
+      <section className="__AUTH_PANEL_CLASS__">
+        <p className="eyebrow">Email</p>
+        <h1>Transactional email baseline</h1>
+        <p className="lede">
+          {emailDisabled
+            ? "Email provider is disabled for this generated app. Switch EMAIL_PROVIDER to resend when you want to wire transactional email."
+            : "The starter routes email sending through a single server-side Resend service. Use this page to verify the wiring and then connect real auth and billing emails."}
+        </p>
+
+        {sent ? <p className="form-success">Test email sent to {displayEmailRecipient}.</p> : null}
+
+__EMAIL_DEMO_BANNER__
+
+        <div className="hero-actions">
+          <form action="/api/email/test" method="post">
+            <button type="submit" className="auth-button" disabled={emailDisabled || emailSendingDisabled}>
+              Send test email
+            </button>
+          </form>
+          <Link href="/dashboard">Back to dashboard</Link>
+        </div>
+      </section>
+    </main>
+  );
+}

package/templates/base-web/src/app/error.tsx

@@ -0,0 +1,27 @@
+"use client";
+
+import Link from "next/link";
+
+export default function Error({
+  error,
+  reset
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  return (
+    <main className="shell">
+      <section className="hero">
+        <p className="eyebrow">Error</p>
+        <h1>Something went wrong</h1>
+        <p className="lede">{error.message || "An unexpected error occurred."}</p>
+        <div className="hero-actions">
+          <button type="button" onClick={reset}>
+            Try again
+          </button>
+          <Link href="/">Go home</Link>
+        </div>
+      </section>
+    </main>
+  );
+}