create-nextly-app 0.0.1 → 0.0.2-alpha.0

package/dist/index.d.cts

@@ -0,0 +1,69 @@
+/**
+ * Project type / template selection.
+ * "blog" is the first content template added for alpha.
+ */
+type ProjectType = "blank" | "blog";
+/**
+ * Schema approach selection for content templates.
+ * - code-first: Full schema definitions in nextly.config.ts (like Payload CMS)
+ * - visual: Empty config, schemas created via Admin Panel UI (like Strapi/WordPress)
+ * - both: Core schemas in code, additional schemas creatable via Admin Panel
+ */
+type ProjectApproach = "code-first" | "visual";
+/**
+ * Supported database types
+ */
+type DatabaseType = "postgresql" | "mysql" | "sqlite";
+/**
+ * Options for createNextly function
+ */
+interface CreateNextlyOptions {
+    /** Working directory (defaults to process.cwd()) */
+    cwd?: string;
+    /** Skip interactive prompts and use defaults */
+    defaults?: boolean;
+    /** Pre-selected project type / template name */
+    projectType?: ProjectType;
+    /** Pre-selected database type */
+    database?: DatabaseType;
+    /** Skip dependency installation (useful for local testing before packages are published) */
+    skipInstall?: boolean;
+    /** Use yalc for local package installation (for testing before npm publish) */
+    useYalc?: boolean;
+    /**
+     * Project name derived from the CLI's positional `[directory]` argument.
+     * Must be a bare directory name (no slashes). Callers pass the basename
+     * of the user-provided argument.
+     */
+    projectNameFromArg?: string;
+    /**
+     * When true, the CLI was invoked with "." meaning "install in current directory".
+     * Different from projectNameFromArg which creates a subdirectory.
+     */
+    installInCwd?: boolean;
+    /** Schema approach for content templates (code-first, visual) */
+    approach?: ProjectApproach;
+    /** Path to local templates directory (for development, bypasses GitHub download) */
+    localTemplatePath?: string;
+    /** Git branch for template download from GitHub (defaults to "main") */
+    branch?: string;
+}
+
+/**
+ * Main entry point for scaffolding Nextly in a Next.js project.
+ *
+ * Two flows:
+ * 1. Empty directory -> scaffold Next.js + install Nextly
+ * 2. Existing Next.js project -> install Nextly into it
+ *
+ * Interactive prompt order:
+ * 1. Project name (or detect existing project)
+ * 2. Template selection (blank, blog, etc.)
+ * 3. Schema approach (code-first, visual) — only for content templates
+ * 4. Demo content (yes/no) - only for content templates
+ * 5. Database selection (sqlite, postgresql, mysql)
+ * 6. Database connection string (only for postgresql/mysql)
+ */
+declare function createNextly(options?: CreateNextlyOptions): Promise<void>;
+
+export { type CreateNextlyOptions, createNextly };

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Project type / template selection.
+ * "blog" is the first content template added for alpha.
+ */
+type ProjectType = "blank" | "blog";
+/**
+ * Schema approach selection for content templates.
+ * - code-first: Full schema definitions in nextly.config.ts (like Payload CMS)
+ * - visual: Empty config, schemas created via Admin Panel UI (like Strapi/WordPress)
+ * - both: Core schemas in code, additional schemas creatable via Admin Panel
+ */
+type ProjectApproach = "code-first" | "visual";
+/**
+ * Supported database types
+ */
+type DatabaseType = "postgresql" | "mysql" | "sqlite";
+/**
+ * Options for createNextly function
+ */
+interface CreateNextlyOptions {
+    /** Working directory (defaults to process.cwd()) */
+    cwd?: string;
+    /** Skip interactive prompts and use defaults */
+    defaults?: boolean;
+    /** Pre-selected project type / template name */
+    projectType?: ProjectType;
+    /** Pre-selected database type */
+    database?: DatabaseType;
+    /** Skip dependency installation (useful for local testing before packages are published) */
+    skipInstall?: boolean;
+    /** Use yalc for local package installation (for testing before npm publish) */
+    useYalc?: boolean;
+    /**
+     * Project name derived from the CLI's positional `[directory]` argument.
+     * Must be a bare directory name (no slashes). Callers pass the basename
+     * of the user-provided argument.
+     */
+    projectNameFromArg?: string;
+    /**
+     * When true, the CLI was invoked with "." meaning "install in current directory".
+     * Different from projectNameFromArg which creates a subdirectory.
+     */
+    installInCwd?: boolean;
+    /** Schema approach for content templates (code-first, visual) */
+    approach?: ProjectApproach;
+    /** Path to local templates directory (for development, bypasses GitHub download) */
+    localTemplatePath?: string;
+    /** Git branch for template download from GitHub (defaults to "main") */
+    branch?: string;
+}
+
+/**
+ * Main entry point for scaffolding Nextly in a Next.js project.
+ *
+ * Two flows:
+ * 1. Empty directory -> scaffold Next.js + install Nextly
+ * 2. Existing Next.js project -> install Nextly into it
+ *
+ * Interactive prompt order:
+ * 1. Project name (or detect existing project)
+ * 2. Template selection (blank, blog, etc.)
+ * 3. Schema approach (code-first, visual) — only for content templates
+ * 4. Demo content (yes/no) - only for content templates
+ * 5. Database selection (sqlite, postgresql, mysql)
+ * 6. Database connection string (only for postgresql/mysql)
+ */
+declare function createNextly(options?: CreateNextlyOptions): Promise<void>;
+
+export { type CreateNextlyOptions, createNextly };

package/dist/index.mjs

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

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/package.json

@@ -1,13 +1,86 @@
 {
   "name": "create-nextly-app",
-  "version": "0.0.1",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.0.2-alpha.0",
+  "description": "CLI to scaffold Nextly in your Next.js project",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "create-nextly-app": "./bin/create-nextly-app.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "commander": "^14.0.2",
+    "execa": "^9.6.0",
+    "fs-extra": "^11.3.0",
+    "ora": "^9.0.0",
+    "picocolors": "^1.1.1",
+    "tar": "^7.4.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/tar": "^6.1.13",
+    "@types/node": "^20.19.17",
+    "@vitest/coverage-v8": "^4.0.8",
+    "@vitest/ui": "^4.0.8",
+    "eslint": "^9.34.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^4.0.8",
+    "@nextlyhq/eslint-config": "0.0.1",
+    "@nextlyhq/telemetry": "0.0.1",
+    "@nextlyhq/tsconfig": "0.0.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
   },
-  "keywords": [],
-  "author": "mobeenabdullah",
-  "license": "ISC",
-  "type": "commonjs"
-}
+  "keywords": [
+    "nextly",
+    "cms",
+    "nextjs",
+    "cli",
+    "scaffold",
+    "create-nextly-app",
+    "create-app"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nextlyhq/nextly.git",
+    "directory": "packages/create-nextly-app"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true
+  },
+  "homepage": "https://nextlyhq.com",
+  "bugs": {
+    "url": "https://github.com/nextlyhq/nextly/issues"
+  },
+  "author": "Nextly <contact@nextlyhq.com> (https://nextlyhq.com)",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "clean": "rimraf dist"
+  }
+}

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