create-nextly-app 0.0.2-alpha.3 → 0.0.2-alpha.31

package/dist/index.d.cts

@@ -1,8 +1,9 @@
 /**
  * Project type / template selection.
  * "blog" is the first content template added for alpha.
+ * "plugin" scaffolds a publishable Nextly plugin package + embedded /dev playground (D44/D45).
  */
-type ProjectType = "blank" | "blog";
+type ProjectType = "blank" | "blog" | "plugin";
 /**
  * Schema approach selection for content templates.
  * - code-first: Full schema definitions in nextly.config.ts (like Payload CMS)

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 /**
  * Project type / template selection.
  * "blog" is the first content template added for alpha.
+ * "plugin" scaffolds a publishable Nextly plugin package + embedded /dev playground (D44/D45).
  */
-type ProjectType = "blank" | "blog";
+type ProjectType = "blank" | "blog" | "plugin";
 /**
  * Schema approach selection for content templates.
  * - code-first: Full schema definitions in nextly.config.ts (like Payload CMS)

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { createRequire } from 'module';
-export { createNextly } from './chunk-AYJ2RKVJ.mjs';
+export { createNextly } from './chunk-C5CWOU22.mjs';
 
 createRequire(import.meta.url);
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nextly-app",
-  "version": "0.0.2-alpha.3",
+  "version": "0.0.2-alpha.31",
   "description": "CLI to scaffold Nextly in your Next.js project",
   "license": "MIT",
   "type": "module",
@@ -42,9 +42,9 @@
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^4.0.8",
-    "@nextlyhq/eslint-config": "0.0.2-alpha.2",
-    "@nextlyhq/telemetry": "0.0.2-alpha.2",
-    "@nextlyhq/tsconfig": "0.0.2-alpha.2"
+    "@nextlyhq/eslint-config": "0.0.2-alpha.23",
+    "@nextlyhq/telemetry": "0.0.2-alpha.23",
+    "@nextlyhq/tsconfig": "0.0.2-alpha.23"
   },
   "engines": {
     "node": ">=20.0.0"

package/templates/base/next.config.ts

@@ -1,21 +1,15 @@
 import type { NextConfig } from "next";
 
-const nextConfig: NextConfig = {
-  serverExternalPackages: [
-    "nextly",
-    "@nextlyhq/adapter-drizzle",
-    "@nextlyhq/adapter-postgres",
-    "@nextlyhq/adapter-mysql",
-    "@nextlyhq/adapter-sqlite",
-    "drizzle-orm",
-    "drizzle-kit",
-    "pg",
-    "mysql2",
-    "better-sqlite3",
-    "bcryptjs",
-    "sharp",
-    "esbuild",
-  ],
-};
+/**
+ * Minimal base `next.config.ts` for bundled templates.
+ *
+ * This file is intentionally left minimal (no adapter whitelist). The
+ * scaffolder will generate or patch a database-specific `next.config.ts`
+ * that includes only the selected adapter and driver in
+ * `serverExternalPackages`. Keeping the base file minimal avoids
+ * advertising adapters the user didn't choose and prevents misleading
+ * generated projects.
+ */
+const nextConfig: NextConfig = {};
 
 export default nextConfig;

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

@@ -1,15 +1,6 @@
 "use client";
 
-// Plugin-side admin imports. Every scaffold ships @nextlyhq/plugin-form-builder
-// as a dependency (see packages/create-nextly-app utils/template.ts). These
-// three lines register the plugin's custom admin field components and load its
-// CSS so the Forms collection's drag-and-drop field builder and Submissions
-// filter UI render correctly. Without them, Forms still appears in the sidebar
-// but the builder falls back to plain JSON/text inputs.
 import "@nextlyhq/admin/style.css";
-import "@nextlyhq/plugin-form-builder/admin";
-import "@nextlyhq/plugin-form-builder/styles/builder.css";
-import "@nextlyhq/plugin-form-builder/styles/submissions-filter.css";
 import { RootLayout, QueryProvider, ErrorBoundary } from "@nextlyhq/admin";
 
 export default function AdminPage() {

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 };

package/templates/plugin/src/collections/example.ts

@@ -0,0 +1,13 @@
+import { defineCollection, text, textarea } from "nextly/config";
+
+/**
+ * An example plugin-owned collection. Replace or remove it with your own.
+ * Plugin collections are merged into the host schema automatically (D3/D12)
+ * and get a real table on `nextly migrate` / boot.
+ */
+export const Examples = defineCollection({
+  slug: "examples",
+  labels: { singular: "Example", plural: "Examples" },
+  fields: [text({ name: "title", required: true }), textarea({ name: "body" })],
+  admin: { useAsTitle: "title" },
+});

package/templates/plugin/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * {{pluginName}} — public entry. The default `.` export is React-free
+ * (Node-safe). Admin React components live on the `./admin` subpath.
+ */
+export { myPlugin } from "./plugin";
+export type { MyPluginOptions } from "./types";

package/templates/plugin/src/plugin.test.ts

@@ -0,0 +1,29 @@
+import { createTestNextly } from "@nextlyhq/plugin-sdk/testing";
+import { afterEach, beforeEach, expect, it } from "vitest";
+
+import { myPlugin } from "./index";
+
+let t: Awaited<ReturnType<typeof createTestNextly>>;
+
+beforeEach(async () => {
+  const plugin = myPlugin();
+  t = await createTestNextly({
+    plugins: [plugin],
+    // Pass the plugin's collections so the harness creates their SQLite tables.
+    collections: plugin.contributes?.collections,
+  });
+});
+
+afterEach(async () => {
+  await t.destroy();
+});
+
+it("boots and exposes the plugin's example collection (real table)", async () => {
+  // Creating an entry proves the contributed collection got a real table and
+  // the plugin's lifecycle ran. Replace with assertions for your own behavior.
+  const created = await t.nextly.create("examples", { title: "First example" });
+  expect(created.item.id).toBeDefined();
+
+  const fetched = await t.nextly.findById("examples", created.item.id);
+  expect(fetched?.title).toBe("First example");
+});

package/templates/plugin/src/plugin.ts

@@ -0,0 +1,48 @@
+import { definePlugin } from "@nextlyhq/plugin-sdk";
+
+import { Examples } from "./collections/example";
+import type { MyPluginOptions } from "./types";
+
+/**
+ * Your plugin factory. Call it in a host app's `defineConfig({ plugins: [...] })`.
+ *
+ * @example
+ * ```ts
+ * import { myPlugin } from "{{pluginName}}";
+ * export default defineConfig({ plugins: [myPlugin({ greeting: "Hi" })] });
+ * ```
+ */
+export const myPlugin = (opts: MyPluginOptions = {}) =>
+  definePlugin({
+    name: "{{pluginName}}",
+    version: "0.1.0",
+    nextly: "{{nextlyRange}}",
+    enabled: opts.enabled,
+    contributes: {
+      collections: [Examples],
+      permissions: [
+        { action: "manage", resource: "examples", label: "Manage Examples" },
+      ],
+      admin: {
+        menu: [
+          {
+            label: "Examples",
+            to: "/admin/collections/examples",
+            icon: "Sparkles",
+          },
+        ],
+        settings: { component: "{{pluginName}}/admin#SettingsPage" },
+      },
+    },
+    init(ctx) {
+      const greeting = opts.greeting ?? "Hello";
+      // Resolve your own slug via ctx.self so this keeps working if the host
+      // renames the collection (D54). React to the post-commit create event.
+      ctx.events.on(`collection.${ctx.self.collections.examples}.created`, () =>
+        ctx.logger.info(`${greeting} from {{pluginName}} — example created`)
+      );
+    },
+    destroy() {
+      // Clean up here (subscriptions are auto-dropped on registry reset).
+    },
+  });

package/templates/plugin/src/types.ts

@@ -0,0 +1,17 @@
+/**
+ * Options accepted by your plugin factory. These are JSDoc-documented so editors
+ * surface them at the call site (D44).
+ */
+export interface MyPluginOptions {
+  /**
+   * Greeting prefix used by the example collection's `afterCreate` hook.
+   * @default "Hello"
+   */
+  greeting?: string;
+
+  /**
+   * Disable the plugin's behavior (init/hooks/events/routes/admin) while still
+   * applying its schema contributions. Default `true`.
+   */
+  enabled?: boolean;
+}

package/templates/plugin/template.json

@@ -0,0 +1,14 @@
+{
+  "name": "plugin",
+  "label": "Plugin",
+  "description": "Build a reusable Nextly plugin (publishable npm package)",
+  "hint": "Plugin package + embedded /dev playground; no schema approach",
+  "approaches": [],
+  "defaultApproach": null,
+  "collections": [],
+  "singles": [],
+  "hasDemoData": false,
+  "hasFrontendPages": false,
+  "recommendedDatabase": "sqlite",
+  "release": "alpha"
+}

package/templates/plugin/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": false
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "dev"]
+}

package/templates/plugin/tsup.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from "tsup";
+
+// Builds the publishable plugin. `dev/` is NOT an entry — it never ships.
+// nextly / admin / react are peers, kept external.
+export default defineConfig({
+  entry: ["src/index.ts", "src/admin/index.ts"],
+  format: ["esm"],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  treeshake: true,
+  external: [
+    "nextly",
+    "@nextlyhq/admin",
+    "@nextlyhq/plugin-sdk",
+    "react",
+    "react-dom",
+  ],
+  outExtension() {
+    return { js: ".mjs" };
+  },
+});

package/templates/plugin/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    include: ["src/**/*.test.ts"],
+  },
+});