create-nextly-app 0.0.2-alpha.1 → 0.0.2-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nextly-app",
-  "version": "0.0.2-alpha.1",
+  "version": "0.0.2-alpha.2",
   "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.0",
-    "@nextlyhq/telemetry": "0.0.2-alpha.0",
-    "@nextlyhq/tsconfig": "0.0.2-alpha.0"
+    "@nextlyhq/eslint-config": "0.0.2-alpha.1",
+    "@nextlyhq/telemetry": "0.0.2-alpha.1",
+    "@nextlyhq/tsconfig": "0.0.2-alpha.1"
   },
   "engines": {
     "node": ">=20.0.0"

package/templates/base/.env.example

@@ -0,0 +1,16 @@
+# Nextly Configuration
+# Generated by create-nextly-app
+
+# Database Configuration
+DB_DIALECT={{databaseDialect}}
+DATABASE_URL={{databaseUrl}}
+
+# Authentication (REQUIRED)
+# Generate with: openssl rand -base64 32
+NEXTLY_SECRET=change-me-generate-a-secure-secret
+
+# Application URL
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+
+# Storage Configuration
+{{storageEnvVars}}

package/templates/base/README.md

@@ -0,0 +1,30 @@
+# Base template
+
+Shared scaffolding for all `create-nextly-app` templates. The CLI applies this template first, then overlays the user-selected template (`blank`, `blog`, or future) on top.
+
+> Not user-selectable. You will not see "base" in the CLI menu. It is always applied beneath your chosen template.
+
+## What's in here
+
+- Admin route handler stub (`app/admin/[[...params]]/page.tsx`)
+- Default API handler stubs
+- Shared styles and Tailwind preset wiring
+- Default `tsconfig.json`, `next.config.ts`, `eslint.config.mjs`, `postcss.config.mjs`
+
+## Maintainer notes
+
+When editing files in `base/`, run the CLI against `--template blank` and `--template blog` locally to confirm both still scaffold cleanly:
+
+```bash
+pnpm --filter create-nextly-app dev -- my-test \
+  --template blank \
+  --local-template ./templates \
+  --skip-install
+
+pnpm --filter create-nextly-app dev -- my-test \
+  --template blog \
+  --local-template ./templates \
+  --skip-install
+```
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md).

package/templates/base/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/templates/base/next.config.ts

@@ -0,0 +1,21 @@
+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",
+  ],
+};
+
+export default nextConfig;

package/templates/base/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/templates/base/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/templates/base/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/templates/base/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/templates/base/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/templates/base/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

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

@@ -0,0 +1,20 @@
+import { getBrandingCss } from "nextly/config";
+
+import config from "../../../../nextly.config";
+
+const brandingCss = getBrandingCss(config.admin?.branding);
+
+export default function AdminLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <>
+      {brandingCss && (
+        <style dangerouslySetInnerHTML={{ __html: brandingCss }} />
+      )}
+      {children}
+    </>
+  );
+}

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

@@ -0,0 +1,27 @@
+"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() {
+  return (
+    <ErrorBoundary
+      onError={(error, errorInfo) => {
+        console.error("Admin error:", error, errorInfo);
+      }}
+    >
+      <QueryProvider>
+        <RootLayout />
+      </QueryProvider>
+    </ErrorBoundary>
+  );
+}

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

@@ -0,0 +1,12 @@
+import { createDynamicHandlers } from "nextly/runtime";
+
+import nextlyConfig from "../../../../../nextly.config";
+
+const handlers = createDynamicHandlers({ config: nextlyConfig });
+
+export const GET = handlers.GET;
+export const POST = handlers.POST;
+export const PUT = handlers.PUT;
+export const PATCH = handlers.PATCH;
+export const DELETE = handlers.DELETE;
+export const OPTIONS = handlers.OPTIONS;

package/templates/base/src/app/api/health/route.ts

@@ -0,0 +1,7 @@
+/**
+ * Health Check Endpoint
+ *
+ * GET /api/health - Check if the API is running
+ */
+
+export { GET, HEAD } from "nextly/api/health";

package/templates/base/src/app/api/media/[[...path]]/route.ts

@@ -0,0 +1,34 @@
+/**
+ * Media API Routes (Catch-All Handler)
+ *
+ * This single route handles all media operations:
+ *
+ * Media Files:
+ * - GET    /api/media                        - List media with pagination
+ * - POST   /api/media                        - Upload new media file
+ * - GET    /api/media/:id                    - Get media by ID
+ * - PATCH  /api/media/:id                    - Update media metadata
+ * - DELETE /api/media/:id                    - Delete media file
+ * - PATCH  /api/media/:id/move               - Move media to folder
+ *
+ * Folders:
+ * - GET    /api/media/folders                - List folders
+ * - POST   /api/media/folders                - Create folder
+ * - GET    /api/media/folders/:id            - Get folder by ID
+ * - PATCH  /api/media/folders/:id            - Update folder
+ * - DELETE /api/media/folders/:id            - Delete folder
+ * - GET    /api/media/folders/:id/contents   - Get folder contents
+ * - GET    /api/media/folders/root/contents  - Get root folder contents
+ */
+
+import { createMediaHandlers } from "nextly/api/media-handlers";
+
+import nextlyConfig from "../../../../../nextly.config";
+
+// Pass config to ensure storage plugins work across all worker processes
+const handlers = createMediaHandlers({ config: nextlyConfig });
+
+export const GET = handlers.GET;
+export const POST = handlers.POST;
+export const PATCH = handlers.PATCH;
+export const DELETE = handlers.DELETE;

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

@@ -0,0 +1,55 @@
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}
+
+/* ===============================================================
+   Accessibility baseline
+   ---------------------------------------------------------------
+   Applied globally so the template passes a WCAG AA keyboard audit
+   out of the box. Adjust to match your brand.
+   =============================================================== */
+
+/* Visible focus ring for keyboard users. `:focus-visible` only fires
+   on keyboard / programmatic focus, so clicking a button doesn't
+   show the ring but tabbing to it does. */
+*:focus-visible {
+  outline: 2px solid currentColor;
+  outline-offset: 2px;
+  border-radius: 2px;
+}
+
+/* Honor OS-level reduced-motion preference — disables hover scale,
+   transitions, and animations for users who've opted out. */
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}

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

@@ -0,0 +1,43 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+/**
+ * `metadataBase` tells Next.js how to resolve relative URLs in OpenGraph
+ * images, Twitter images, and canonical URLs. Set `NEXT_PUBLIC_SITE_URL`
+ * in your environment to your production domain (e.g.
+ * `https://yourblog.com`). The localhost fallback keeps dev working.
+ */
+export const metadata: Metadata = {
+  metadataBase: new URL(
+    process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000"
+  ),
+  title: { default: "Nextly", template: "%s — Nextly" },
+  description: "A site built with Nextly.",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        {children}
+      </body>
+    </html>
+  );
+}

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

@@ -0,0 +1,65 @@
+import Image from "next/image";
+
+export default function Home() {
+  return (
+    <div className="flex min-h-screen items-center justify-center bg-zinc-50 font-sans dark:bg-black">
+      <main className="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
+        <Image
+          className="dark:invert"
+          src="/next.svg"
+          alt="Next.js logo"
+          width={100}
+          height={20}
+          priority
+        />
+        <div className="flex flex-col items-center gap-6 text-center sm:items-start sm:text-left">
+          <h1 className="max-w-xs text-3xl font-semibold leading-10 tracking-tight text-black dark:text-zinc-50">
+            To get started, edit the page.tsx file.
+          </h1>
+          <p className="max-w-md text-lg leading-8 text-zinc-600 dark:text-zinc-400">
+            Looking for a starting point or more instructions? Head over to{" "}
+            <a
+              href="https://vercel.com/templates?framework=next.js&utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+              className="font-medium text-zinc-950 dark:text-zinc-50"
+            >
+              Templates
+            </a>{" "}
+            or the{" "}
+            <a
+              href="https://nextjs.org/learn?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+              className="font-medium text-zinc-950 dark:text-zinc-50"
+            >
+              Learning
+            </a>{" "}
+            center.
+          </p>
+        </div>
+        <div className="flex flex-col gap-4 text-base font-medium sm:flex-row">
+          <a
+            className="flex h-12 w-full items-center justify-center gap-2 rounded-full bg-foreground px-5 text-background transition-colors hover:bg-[#383838] dark:hover:bg-[#ccc] md:w-[158px]"
+            href="https://vercel.com/new?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            <Image
+              className="dark:invert"
+              src="/vercel.svg"
+              alt="Vercel logomark"
+              width={16}
+              height={16}
+            />
+            Deploy Now
+          </a>
+          <a
+            className="flex h-12 w-full items-center justify-center rounded-full border border-solid border-black/[.08] px-5 transition-colors hover:border-transparent hover:bg-black/[.04] dark:border-white/[.145] dark:hover:bg-[#1a1a1a] md:w-[158px]"
+            href="https://nextjs.org/docs?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            Documentation
+          </a>
+        </div>
+      </main>
+    </div>
+  );
+}

package/templates/base/src/types/generated/nextly-types.ts

@@ -0,0 +1,12 @@
+/**
+ * Nextly Generated Types
+ *
+ * This file will be auto-generated when you run:
+ *   npx nextly dev
+ *   npx nextly generate:types
+ *
+ * Do not edit this file manually - it will be overwritten.
+ */
+
+// Types will be generated here after running nextly dev
+export {};

package/templates/base/tsconfig.json

@@ -0,0 +1,35 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"],
+      "@nextly-config": ["./nextly.config.ts"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/templates/blank/.env.example

@@ -0,0 +1,8 @@
+# Public site URL used by:
+# - Metadata API (canonical URLs, OpenGraph image resolution)
+# - sitemap.xml, robots.txt, and any RSS feed route handlers you add
+# - JSON-LD structured data links
+#
+# Set this to your production domain when deploying (e.g. https://yourapp.com).
+# The localhost fallback keeps local development working.
+NEXT_PUBLIC_SITE_URL=http://localhost:3000

package/templates/blank/README.md

@@ -0,0 +1,63 @@
+# Blank template
+
+A minimal Nextly project with the conventional folder layout already
+scaffolded. Empty `nextly.config.ts`, no collections, one landing
+page, and READMEs in every convention folder so you know where things
+go as you grow.
+
+## When to use
+
+Choose `blank` when you want to build everything from scratch but
+appreciate having the right folder structure waiting for you. Pick
+[`blog`](../blog/README.md) instead if you want a populated example
+with collections, singles, frontend pages, RSS, search, and demo
+content already wired up.
+
+## Scaffold
+
+```bash
+pnpm create nextly-app@alpha my-app --template blank
+```
+
+## What you get
+
+```
+my-app/
+├── nextly.config.ts        # Empty config — add your collections / singles
+├── .env.example            # NEXT_PUBLIC_SITE_URL etc.
+├── next.config.ts          # (inherited from base)
+├── postcss.config.mjs      # (inherited from base)
+├── tsconfig.json           # (inherited from base)
+└── src/
+    ├── access/             # RBAC functions (anyone, authenticated, ...)
+    ├── collections/        # defineCollection() definitions
+    ├── singles/            # defineSingle() definitions
+    ├── components/         # React components (ThemeToggle ships as an example)
+    ├── lib/                # Project-wide helpers
+    └── app/
+        ├── layout.tsx      # Root layout (font + metadata)
+        ├── globals.css     # Design tokens
+        └── (frontend)/     # Public-facing routes (route group)
+            └── page.tsx    # Landing page — flips between "Set up admin" / "Open admin"
+```
+
+The `(frontend)` route group keeps your public pages cleanly separated
+from `app/admin/...` and `app/api/...` routes that Nextly mounts. As
+you add routes, drop them inside `(frontend)/` and they'll inherit
+your blog/marketing layout instead of the admin's.
+
+Every convention folder ships with a `README.md` explaining what
+belongs there. Replace them with real code as you build.
+
+## Next steps
+
+- **Add a collection** — create `src/collections/Posts.ts`, register
+  it in `nextly.config.ts`, run `pnpm dev`. The admin will surface it
+  immediately.
+- **Add a public page** — drop a new file under
+  `src/app/(frontend)/blog/page.tsx`. It'll be live at `/blog`.
+- **Configure storage / email** — see
+  [`nextlyhq.com/docs`](https://nextlyhq.com/docs) for adapter setup.
+
+See [`templates/blog/README.md`](../blog/README.md) for a fully
+populated example showing all of the above wired up.

package/templates/blank/nextly.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "nextly/config";
+
+export default defineConfig({
+  // Add your collections here
+  collections: [],
+
+  // Add your singles (globals) here
+  singles: [],
+
+  // TypeScript type generation
+  typescript: {
+    outputFile: "./src/types/generated/nextly-types.ts",
+  },
+});

package/templates/blank/src/access/README.md

@@ -0,0 +1,22 @@
+# Access
+
+Access-control functions used by `defineCollection({ access: ... })`
+and `defineSingle({ access: ... })`. Each function decides whether the
+current user can perform an action (read, create, update, delete) on a
+collection or single.
+
+Conventions:
+
+- One function per file. File name matches the function name.
+- Export the function as a named export.
+- Type signature: `AccessControlFunction` from `nextly`.
+
+Common patterns shipped in the blog template (for reference):
+
+- `anyone.ts` — always allow (use for public reads).
+- `authenticated.ts` — require any logged-in user.
+- `is-admin.ts` — require the `admin` role.
+- `is-author-or-editor.ts` — require one of several roles.
+
+Add your own here as your project grows. Wire them up in your
+collections / singles config.