create-nextly-app 0.0.2-alpha.42 → 0.0.2-alpha.43

package/templates/blank/src/app/(frontend)/components/ThemeToggle.tsx

@@ -0,0 +1,113 @@
+"use client";
+
+import { useEffect, useState } from "react";
+
+type Theme = "light" | "dark" | "system";
+
+export function ThemeToggle() {
+  const [theme, setTheme] = useState<Theme>("system");
+
+  useEffect(() => {
+    const savedTheme = localStorage.getItem("theme") as Theme | null;
+    if (savedTheme) {
+      setTheme(savedTheme);
+      applyTheme(savedTheme);
+    } else {
+      applyTheme("system");
+    }
+  }, []);
+
+  const applyTheme = (newTheme: Theme) => {
+    const isDark =
+      newTheme === "dark" ||
+      (newTheme === "system" &&
+        window.matchMedia("(prefers-color-scheme: dark)").matches);
+
+    document.documentElement.classList.toggle("dark", isDark);
+  };
+
+  const handleThemeChange = (newTheme: Theme) => {
+    setTheme(newTheme);
+    localStorage.setItem("theme", newTheme);
+    applyTheme(newTheme);
+  };
+
+  return (
+    <div className="fixed top-6 right-6 flex items-center border border-foreground/10 bg-background p-1 z-50">
+      <button
+        onClick={() => handleThemeChange("light")}
+        className={`p-1.5 transition-colors cursor-pointer ${
+          theme === "light"
+            ? "text-foreground bg-foreground/5"
+            : "text-slate-400 hover:text-foreground"
+        }`}
+        aria-label="Light theme"
+      >
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          fill="none"
+          viewBox="0 0 24 24"
+          strokeWidth={2}
+          stroke="currentColor"
+          className="w-4 h-4"
+        >
+          <path
+            strokeLinecap="round"
+            strokeLinejoin="round"
+            d="M12 3v2.25m6.364.386l-1.591 1.591M21 12h-2.25m-.386 6.364l-1.591-1.591M12 18.75V21m-4.773-4.227l-1.591 1.591M3 12h2.25m.386-6.364l1.591 1.591M15.75 12a3.75 3.75 0 11-7.5 0 3.75 3.75 0 017.5 0z"
+          />
+        </svg>
+      </button>
+
+      <button
+        onClick={() => handleThemeChange("system")}
+        className={`p-1.5 transition-colors cursor-pointer ${
+          theme === "system"
+            ? "text-foreground bg-foreground/5"
+            : "text-slate-400 hover:text-foreground"
+        }`}
+        aria-label="System theme"
+      >
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          fill="none"
+          viewBox="0 0 24 24"
+          strokeWidth={2}
+          stroke="currentColor"
+          className="w-4 h-4"
+        >
+          <path
+            strokeLinecap="round"
+            strokeLinejoin="round"
+            d="M9 17.25v1.007a3 3 0 01-.879 2.122L7.5 21h9l-.621-.621A3 3 0 0115 18.257V17.25m6-12V15a2.25 2.25 0 01-2.25 2.25H5.25A2.25 2.25 0 013 15V5.25m18 0A2.25 2.25 0 0018.75 3H5.25A2.25 2.25 0 003 5.25m18 0V12a2.25 2.25 0 01-2.25 2.25H5.25A2.25 2.25 0 013 12V5.25"
+          />
+        </svg>
+      </button>
+
+      <button
+        onClick={() => handleThemeChange("dark")}
+        className={`p-1.5 transition-colors cursor-pointer ${
+          theme === "dark"
+            ? "text-foreground bg-foreground/5"
+            : "text-slate-400 hover:text-foreground"
+        }`}
+        aria-label="Dark theme"
+      >
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          fill="none"
+          viewBox="0 0 24 24"
+          strokeWidth={2}
+          stroke="currentColor"
+          className="w-4 h-4"
+        >
+          <path
+            strokeLinecap="round"
+            strokeLinejoin="round"
+            d="M21.752 15.002A9.718 9.718 0 0118 15.75c-5.385 0-9.75-4.365-9.75-9.75 0-1.33.266-2.597.748-3.752A9.753 9.753 0 003 11.25C3 16.635 7.365 21 12.75 21a9.753 9.753 0 009.002-5.998z"
+          />
+        </svg>
+      </button>
+    </div>
+  );
+}

package/templates/blank/src/app/(frontend)/page.tsx

@@ -0,0 +1,176 @@
+import Link from "next/link";
+
+import { ThemeToggle } from "@/components/ThemeToggle";
+
+/**
+ * Blank-template landing page (public route via the (frontend) route group).
+ *
+ * Replaces the inherited Next.js placeholder at `/` with a minimal,
+ * brutalist-edge welcome page that points the developer at the admin
+ * panel and the docs. Server Component — fetches setup-status so the
+ * primary button label flips between "Set up admin" (no super-admin
+ * yet) and "Open admin" (super-admin exists).
+ *
+ * If the auth API fails for any reason (DB not migrated, network),
+ * the button defaults to "Open admin" / /admin since /admin already
+ * redirects to /admin/setup when no super-admin exists — the link
+ * works either way.
+ *
+ * Edit this file in src/app/(frontend)/page.tsx after scaffolding to customise.
+ */
+
+interface SetupStatus {
+  isSetup: boolean;
+  requiresInitialUser: boolean;
+}
+
+async function fetchSetupStatus(): Promise<SetupStatus | null> {
+  try {
+    const baseUrl = process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000";
+    const res = await fetch(`${baseUrl}/api/auth/setup-status`, {
+      cache: "no-store",
+    });
+    if (!res.ok) return null;
+    return (await res.json()) as SetupStatus;
+  } catch {
+    return null;
+  }
+}
+
+export default async function HomePage() {
+  const status = await fetchSetupStatus();
+  const needsSetup = status?.requiresInitialUser ?? false;
+  const adminLabel = needsSetup ? "Set up admin" : "Open admin";
+  const adminHref = needsSetup ? "/admin/setup" : "/admin";
+
+  return (
+    <main className="relative min-h-screen flex flex-col items-center justify-center p-6 bg-background text-foreground font-display selection:bg-foreground/10">
+      <ThemeToggle />
+      <div className="max-w-[640px] w-full text-center">
+        <div className="flex items-center justify-center mb-8">
+          <svg
+            width="180"
+            height="48"
+            viewBox="0 0 235 63"
+            fill="none"
+            xmlns="http://www.w3.org/2000/svg"
+            className="text-foreground"
+          >
+            <rect width="62" height="63" fill="currentColor" />
+            <path
+              d="M18 46.7034L24.6253 43.6455V26.6564L32.9494 30.5448V23.26L18 16.21V46.7034Z"
+              fill="var(--color-background)"
+            />
+            <path
+              d="M44 16.2102L37.3747 19.268V36.2905L29.035 32.4021L29.0506 39.6536L44 46.7036V16.2102Z"
+              fill="var(--color-background)"
+            />
+            <path
+              d="M116.233 11.0908V45.9999H109.858L94.6705 24.0283H94.4148V45.9999H87.0341V11.0908H93.5114L108.58 33.0454H108.886V11.0908H116.233ZM134.126 46.5113C131.433 46.5113 129.115 45.9658 127.172 44.8749C125.24 43.7726 123.751 42.2158 122.706 40.2044C121.661 38.1817 121.138 35.7897 121.138 33.0283C121.138 30.3351 121.661 27.9715 122.706 25.9374C123.751 23.9033 125.223 22.3181 127.121 21.1817C129.03 20.0454 131.268 19.4772 133.837 19.4772C135.564 19.4772 137.172 19.7556 138.661 20.3124C140.161 20.8579 141.467 21.6817 142.581 22.784C143.706 23.8863 144.581 25.2726 145.206 26.9431C145.831 28.6022 146.143 30.5454 146.143 32.7726V34.7669H124.036V30.2669H139.308C139.308 29.2215 139.081 28.2954 138.626 27.4885C138.172 26.6817 137.541 26.051 136.734 25.5965C135.939 25.1306 135.013 24.8976 133.956 24.8976C132.854 24.8976 131.876 25.1533 131.024 25.6647C130.183 26.1647 129.524 26.8408 129.047 27.6931C128.57 28.534 128.325 29.4715 128.314 30.5056V34.784C128.314 36.0794 128.553 37.1988 129.03 38.1419C129.518 39.0851 130.206 39.8124 131.092 40.3238C131.979 40.8351 133.03 41.0908 134.246 41.0908C135.053 41.0908 135.791 40.9772 136.462 40.7499C137.132 40.5226 137.706 40.1817 138.183 39.7272C138.661 39.2726 139.024 38.7158 139.274 38.0567L145.99 38.4999C145.649 40.1135 144.95 41.5226 143.893 42.7272C142.848 43.9204 141.496 44.8522 139.837 45.5226C138.189 46.1817 136.286 46.5113 134.126 46.5113ZM156.482 19.8181L161.288 28.9715L166.214 19.8181H173.663L166.078 32.909L173.868 45.9999H166.453L161.288 36.9488L156.209 45.9999H148.709L156.482 32.909L148.982 19.8181H156.482ZM191.902 19.8181V25.2726H176.135V19.8181H191.902ZM179.714 13.5454H186.976V37.9544C186.976 38.6249 187.078 39.1476 187.283 39.5226C187.487 39.8863 187.771 40.1419 188.135 40.2897C188.51 40.4374 188.942 40.5113 189.43 40.5113C189.771 40.5113 190.112 40.4829 190.453 40.426C190.794 40.3579 191.055 40.3067 191.237 40.2726L192.379 45.676C192.016 45.7897 191.504 45.9204 190.845 46.0681C190.186 46.2272 189.385 46.3238 188.442 46.3579C186.692 46.426 185.158 46.1931 183.839 45.659C182.533 45.1249 181.516 44.2954 180.788 43.1704C180.061 42.0454 179.703 40.6249 179.714 38.909V13.5454ZM204.456 11.0908V45.9999H197.195V11.0908H204.456ZM214.756 55.8181C213.835 55.8181 212.972 55.7442 212.165 55.5965C211.369 55.4601 210.71 55.284 210.188 55.0681L211.824 49.6476C212.676 49.909 213.443 50.051 214.125 50.0738C214.818 50.0965 215.415 49.9374 215.915 49.5965C216.426 49.2556 216.841 48.676 217.159 47.8579L217.585 46.7499L208.193 19.8181H215.83L221.25 39.0454H221.523L226.994 19.8181H234.682L224.506 48.8294C224.017 50.2385 223.352 51.4658 222.511 52.5113C221.682 53.5681 220.631 54.3806 219.358 54.9488C218.085 55.5283 216.551 55.8181 214.756 55.8181Z"
+              fill="currentColor"
+            />
+          </svg>
+          <span className="ml-4 font-mono text-[10px] font-semibold tracking-wide uppercase px-2 py-0.5 bg-foreground/5 text-slate-500">
+            Alpha
+          </span>
+        </div>
+
+        <h1 className="mx-auto font-semibold tracking-[-0.03em] leading-[1.1] text-[clamp(24px,5vw,32px)]">
+          Welcome to your new Nextly project.
+        </h1>
+
+        <p className="mt-6 mx-auto text-slate-500 dark:text-slate-400 max-w-[42ch] text-[clamp(16px,1.8vw,18px)] leading-[1.6]">
+          This is the blank template. Open the admin to create your first
+          collection or read the docs to see what Nextly can do.
+        </p>
+
+        <div className="mt-10 flex flex-wrap items-center justify-center gap-4">
+          <Link href={adminHref} className="btn-primary">
+            <span>{adminLabel}</span>
+            <svg
+              xmlns="http://www.w3.org/2000/svg"
+              width="18"
+              height="18"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              strokeWidth="2"
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              className="lucide lucide-arrow-right"
+            >
+              <path d="M5 12h14" />
+              <path d="m12 5 7 7-7 7" />
+            </svg>
+          </Link>
+          <Link href="https://nextlyhq.com/docs" className="btn-secondary">
+            <span>Read documentation</span>
+            <svg
+              xmlns="http://www.w3.org/2000/svg"
+              width="18"
+              height="18"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              strokeWidth="2"
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              className="lucide lucide-arrow-up-right"
+            >
+              <path d="M7 7h10v10" />
+              <path d="M7 17 17 7" />
+            </svg>
+          </Link>
+        </div>
+
+        <div className="mt-16 pt-8 border-t border-foreground/5 flex flex-col sm:flex-row items-center justify-between gap-6">
+          <p className="font-mono text-[11px] tracking-tight text-slate-500">
+            Edit in{" "}
+            <span className="text-foreground">src/app/(frontend)/page.tsx</span>
+          </p>
+          <div className="flex gap-6">
+            <Link
+              href="https://github.com/nextlyhq/nextly"
+              className="flex items-center gap-2 text-[12px] font-medium text-slate-500 hover:text-foreground transition-colors"
+            >
+              <svg
+                aria-hidden="true"
+                focusable="false"
+                viewBox="0 0 24 24"
+                width="16"
+                height="16"
+                fill="currentColor"
+                style={{ verticalAlign: "text-bottom" }}
+              >
+                <path d="M10.226 17.284c-2.965-.36-5.054-2.493-5.054-5.256 0-1.123.404-2.336 1.078-3.144-.292-.741-.247-2.314.09-2.965.898-.112 2.111.36 2.83 1.01.853-.269 1.752-.404 2.853-.404 1.1 0 1.999.135 2.807.382.696-.629 1.932-1.1 2.83-.988.315.606.36 2.179.067 2.942.72.854 1.101 2 1.101 3.167 0 2.763-2.089 4.852-5.098 5.234.763.494 1.28 1.572 1.28 2.807v2.336c0 .674.561 1.056 1.235.786 4.066-1.55 7.255-5.615 7.255-10.646C23.5 6.188 18.334 1 11.978 1 5.62 1 .5 6.188.5 12.545c0 4.986 3.167 9.12 7.435 10.669.606.225 1.19-.18 1.19-.786V20.63a2.9 2.9 0 0 1-1.078.224c-1.483 0-2.359-.808-2.987-2.313-.247-.607-.517-.966-1.034-1.033-.27-.023-.359-.135-.359-.27 0-.27.45-.471.898-.471.652 0 1.213.404 1.797 1.235.45.651.921.943 1.483.943.561 0 .92-.202 1.437-.719.382-.381.674-.718.944-.943"></path>
+              </svg>
+              <span>GitHub</span>
+            </Link>
+            <Link
+              href="https://nextlyhq.com"
+              className="flex items-center gap-2 text-[12px] font-medium text-slate-500 hover:text-foreground transition-colors"
+            >
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                width="16"
+                height="16"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="currentColor"
+                strokeWidth="2"
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                className="lucide lucide-globe"
+              >
+                <circle cx="12" cy="12" r="10" />
+                <path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20" />
+                <path d="M2 12h20" />
+              </svg>
+              <span>Website</span>
+            </Link>
+          </div>
+        </div>
+      </div>
+    </main>
+  );
+}

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

@@ -0,0 +1,79 @@
+@import "tailwindcss";
+
+/**
+ * Blank-template global styles.
+ *
+ * Overrides templates/base/src/app/globals.css so the branded landing
+ * page renders with its supporting decorations: a subtle 56px grid
+ * backdrop, the corner brackets, the pulsing "Localhost / Development"
+ * dot, and a hover-invert helper for the secondary button.
+ *
+ * Tailwind base tokens still apply — these rules are additive.
+ */
+
+:root {
+  --color-background: #f9fafb;
+  --color-foreground: #0f172a;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --color-background: #0b0f19;
+    --color-foreground: #f9fafb;
+  }
+}
+
+.dark {
+  --color-background: #0b0f19;
+  --color-foreground: #f9fafb;
+}
+
+@theme {
+  --color-background: var(--color-background);
+  --color-foreground: var(--color-foreground);
+}
+
+body {
+  background-color: var(--color-background);
+  color: var(--color-foreground);
+  overflow-x: hidden;
+}
+
+.pulse-dot {
+  display: inline-block;
+  width: 6px;
+  height: 6px;
+  margin-right: 6px;
+  background: #10b981;
+  border-radius: 50%;
+  box-shadow: 0 0 8px #10b981;
+  animation: nextly-pulse 1.6s ease-in-out infinite;
+}
+
+@keyframes nextly-pulse {
+  0%,
+  100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.4;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .pulse-dot {
+    animation: none;
+  }
+}
+
+.font-display {
+  font-family: var(--font-display), ui-sans-serif, system-ui, sans-serif;
+}
+
+.btn-primary {
+  @apply inline-flex items-center gap-2.5 rounded-none bg-foreground px-6 py-3.5 text-sm font-semibold text-background transition-all hover:opacity-90 active:scale-95;
+}
+
+.btn-secondary {
+  @apply inline-flex items-center gap-2.5 rounded-none border border-foreground/10 bg-transparent px-6 py-3.5 text-sm font-medium text-foreground transition-all hover:bg-foreground/5 active:scale-95;
+}

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

@@ -0,0 +1,46 @@
+import type { Metadata } from "next";
+import { Inter, JetBrains_Mono } from "next/font/google";
+
+import "./globals.css";
+
+const display = Inter({
+  variable: "--font-display",
+  subsets: ["latin"],
+  display: "swap",
+});
+
+const mono = JetBrains_Mono({
+  variable: "--font-mono",
+  subsets: ["latin"],
+  display: "swap",
+});
+
+/**
+ * Blank-template root layout.
+ *
+ * Overrides templates/base/src/app/layout.tsx so the landing page can
+ * use a distinctive font pairing (Bricolage Grotesque for display,
+ * JetBrains Mono for tech accents). `metadataBase` is set so future
+ * blank-template pages can use relative OG image URLs without breaking.
+ */
+export const metadata: Metadata = {
+  metadataBase: new URL(
+    process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000"
+  ),
+  title: { default: "Nextly", template: "%s — Nextly" },
+  description: "A Nextly project.",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body className={`${display.variable} ${mono.variable} antialiased`}>
+        {children}
+      </body>
+    </html>
+  );
+}

package/templates/blank/template.json

@@ -0,0 +1,14 @@
+{
+  "name": "blank",
+  "label": "Blank",
+  "description": "Start fresh with an empty config",
+  "hint": "Empty project, define your own schemas",
+  "approaches": [],
+  "defaultApproach": null,
+  "collections": [],
+  "singles": [],
+  "hasDemoData": false,
+  "hasFrontendPages": true,
+  "recommendedDatabase": "any",
+  "release": "alpha"
+}

package/templates/plugin/README.md

@@ -0,0 +1,44 @@
+# {{pluginName}}
+
+A [Nextly](https://nextlyhq.com) plugin.
+
+## Develop
+
+```bash
+pnpm install
+pnpm dev      # runs the embedded /dev playground → open http://localhost:3000/admin
+```
+
+Your plugin lives in `src/`. The `dev/` folder is a minimal Nextly app on SQLite
+that registers this plugin so you can exercise it in a real admin with hot-reload.
+Editing files under `src/` reloads the playground. **`dev/` is never published.**
+
+## Test
+
+```bash
+pnpm test     # boots a real Nextly on in-memory SQLite via createTestNextly
+```
+
+## Build & publish
+
+```bash
+pnpm build    # tsup → dist/
+npm publish
+```
+
+Only `dist/` ships (see `files` in `package.json`). The `nextly-plugin` keyword
+makes this package discoverable.
+
+## Use in an app
+
+```ts
+// nextly.config.ts
+import { defineConfig } from "nextly";
+import { myPlugin } from "{{pluginName}}";
+
+export default defineConfig({
+  plugins: [myPlugin()],
+});
+```
+
+See the [Nextly plugin author guide](https://nextlyhq.com/docs/plugins/author-guide).

package/templates/plugin/dev/.env.example

@@ -0,0 +1,8 @@
+# Dev playground env. Copy to dev/.env and run `pnpm dev`.
+DB_DIALECT=sqlite
+DATABASE_URL=file:./nextly-dev.db
+
+# Any non-empty secret works for local dev (sign/verify session cookies).
+NEXTLY_SECRET=dev-secret-change-me
+
+NEXT_PUBLIC_SITE_URL=http://localhost:3000

package/templates/plugin/dev/instrumentation.ts

@@ -0,0 +1,10 @@
+// Warm up Nextly once per worker at startup (Node.js runtime only) so admin/API
+// handlers never run before init and schema boot-apply runs once, not per request.
+// Imported dynamically + guarded so nextly stays out of the Edge bundle.
+export async function register(): Promise<void> {
+  if (process.env.NEXT_RUNTIME !== "nodejs") return;
+
+  const { createRegister } = await import("nextly");
+  const { default: config } = await import("./nextly.config");
+  await createRegister(config)();
+}

package/templates/plugin/dev/next.config.ts

@@ -0,0 +1,30 @@
+import type { NextConfig } from "next";
+
+// Dev playground for the plugin. The plugin's own source (../src) is aliased and
+// transpiled so editing it hot-reloads. `nextly` + the admin come from
+// node_modules (real deps). Node-only / dynamically-imported packages stay
+// external (Turbopack can't bundle them).
+const nextConfig: NextConfig = {
+  typescript: { ignoreBuildErrors: true },
+  // Transpile the aliased plugin source so HMR fires on src/ edits.
+  transpilePackages: ["{{pluginName}}"],
+  serverExternalPackages: [
+    "better-sqlite3",
+    "drizzle-orm",
+    "drizzle-kit",
+    "esbuild",
+    "bundle-require",
+    "sharp",
+    "@nextlyhq/adapter-drizzle",
+    "@nextlyhq/adapter-sqlite",
+  ],
+  turbopack: {
+    resolveAlias: {
+      // Map the package name to its source so HMR works without a build step.
+      "{{pluginName}}": ["./../src/index.ts"],
+      "{{pluginName}}/admin": ["./../src/admin/index.ts"],
+    },
+  },
+};
+
+export default nextConfig;

package/templates/plugin/dev/nextly.config.ts

@@ -0,0 +1,17 @@
+/**
+ * Dev playground config — a minimal Nextly app that registers THIS plugin so you
+ * can exercise it in a real admin. SQLite, dev auto-login. Never published.
+ */
+import { defineConfig } from "nextly/config";
+import { myPlugin } from "{{pluginName}}";
+
+export default defineConfig({
+  admin: {
+    // Land on /admin already logged in. Hard-blocked in production by Nextly.
+    devAutoLogin: {
+      email: "dev@nextly.local",
+      password: "DevPassword123!",
+    },
+  },
+  plugins: [myPlugin()],
+});

package/templates/plugin/dev/src/app/admin/[[...params]]/page.tsx

@@ -0,0 +1,9 @@
+"use client";
+
+import "@nextlyhq/admin/style.css";
+import { RootLayout } from "@nextlyhq/admin";
+
+// Mounts the Nextly admin shell. Your plugin's menu/pages/settings appear here.
+export default function AdminPage() {
+  return <RootLayout />;
+}

package/templates/plugin/dev/src/app/admin/api/[[...params]]/route.ts

@@ -0,0 +1,19 @@
+/* eslint-disable @typescript-eslint/no-explicit-any -- framework adapter passes through Next.js App Router context */
+/**
+ * Admin API catch-all. Routes every /admin/api/* request (incl. your plugin's
+ * /api/plugins/<name>/… routes) through the handler built from nextly.config.ts.
+ */
+import { createDynamicHandlers } from "nextly/runtime";
+
+import nextlyConfig from "../../../../../nextly.config";
+
+const handlers = createDynamicHandlers({ config: nextlyConfig });
+
+export const GET = (req: Request, context: any) => handlers.GET(req, context);
+export const POST = (req: Request, context: any) => handlers.POST(req, context);
+export const PUT = (req: Request, context: any) => handlers.PUT(req, context);
+export const PATCH = (req: Request, context: any) =>
+  handlers.PATCH(req, context);
+export const DELETE = (req: Request, context: any) =>
+  handlers.DELETE(req, context);
+export const OPTIONS = (req: Request) => handlers.OPTIONS(req);

package/templates/plugin/dev/src/app/layout.tsx

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+
+export const metadata = {
+  title: "{{pluginName}} — dev playground",
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/plugin/dev/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "preserve",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "{{pluginName}}": ["../src/index.ts"],
+      "{{pluginName}}/admin": ["../src/admin/index.ts"]
+    }
+  },
+  "include": ["**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/plugin/eslint.config.mjs

@@ -0,0 +1,8 @@
+import js from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  { ignores: ["dist", "dev/.next", "node_modules"] },
+  js.configs.recommended,
+  ...tseslint.configs.recommended
+);

package/templates/plugin/src/admin/SettingsPage.tsx

@@ -0,0 +1,13 @@
+/**
+ * Example plugin settings page, rendered at `/admin/plugins/<slug>` and inside
+ * a per-component error boundary (D53). Build your real settings UI here with
+ * `@nextlyhq/ui` components.
+ */
+export function SettingsPage() {
+  return (
+    <div style={{ padding: 24 }}>
+      <h1>Plugin Settings</h1>
+      <p>Settings UI goes here. Edit src/admin/SettingsPage.tsx.</p>
+    </div>
+  );
+}

package/templates/plugin/src/admin/index.ts

@@ -0,0 +1,21 @@
+/**
+ * Admin component registration (D19/D60). Importing this module registers the
+ * React components referenced by `contributes.admin` string paths so the host
+ * admin can resolve them. The host's generated import map imports this for you;
+ * the eager + lazy registration below is the fallback.
+ */
+import { registerComponents, registerKnownPlugin } from "@nextlyhq/admin";
+
+import { SettingsPage } from "./SettingsPage";
+
+const SETTINGS_PATH = "{{pluginName}}/admin#SettingsPage";
+
+// Eager: register on module load.
+registerComponents({ [SETTINGS_PATH]: SettingsPage });
+
+// Lazy fallback: the host can trigger registration on demand by package prefix.
+registerKnownPlugin("{{pluginName}}", async () => {
+  registerComponents({ [SETTINGS_PATH]: SettingsPage });
+});
+
+export { SettingsPage };