@revealui/cli 0.0.1-pre.1 → 0.3.0

package/templates/portfolio/src/seed.ts

@@ -0,0 +1,73 @@
+/**
+ * Seed script for the portfolio template.
+ * Creates 3 sample projects via the RevealUI REST API.
+ *
+ * Usage: pnpm db:seed (requires the dev server to be running)
+ */
+
+const API_URL = process.env.NEXT_PUBLIC_SERVER_URL || 'http://localhost:4000';
+
+interface SeedProject {
+  title: string;
+  slug: string;
+  description: string;
+  tags: Array<{ tag: string }>;
+  link: string;
+}
+
+const projects: SeedProject[] = [
+  {
+    title: 'Weather Dashboard',
+    slug: 'weather-dashboard',
+    description:
+      'A real-time weather dashboard built with React and a public weather API. Displays forecasts, radar maps, and severe weather alerts.',
+    tags: [{ tag: 'React' }, { tag: 'TypeScript' }, { tag: 'API' }],
+    link: 'https://github.com/example/weather-dashboard',
+  },
+  {
+    title: 'Task Manager CLI',
+    slug: 'task-manager-cli',
+    description:
+      'A command-line task manager written in TypeScript with SQLite storage, priority sorting, and due date reminders.',
+    tags: [{ tag: 'TypeScript' }, { tag: 'Node.js' }, { tag: 'CLI' }],
+    link: 'https://github.com/example/task-manager-cli',
+  },
+  {
+    title: 'Design System',
+    slug: 'design-system',
+    description:
+      'A component library with 30+ accessible UI primitives, built with Tailwind CSS and documented with Storybook.',
+    tags: [{ tag: 'React' }, { tag: 'Tailwind CSS' }, { tag: 'Storybook' }],
+    link: 'https://github.com/example/design-system',
+  },
+];
+
+const log = (...args: unknown[]) => process.stdout.write(`${args.join(' ')}\n`);
+const logErr = (...args: unknown[]) => process.stderr.write(`${args.join(' ')}\n`);
+
+async function seed(): Promise<void> {
+  log(`Seeding projects to ${API_URL}...`);
+
+  for (const project of projects) {
+    try {
+      const res = await fetch(`${API_URL}/api/projects`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(project),
+      });
+
+      if (res.ok) {
+        log(`  Created: ${project.title}`);
+      } else {
+        const error = await res.text();
+        logErr(`  Failed to create "${project.title}": ${error}`);
+      }
+    } catch (err) {
+      logErr(`  Error creating "${project.title}":`, err);
+    }
+  }
+
+  log('Seeding complete.');
+}
+
+seed();

package/templates/portfolio/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@revealui/dev/ts/nextjs",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src", "next.config.mjs", "revealui.config.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/starter/.env.example

@@ -0,0 +1,36 @@
+# RevealUI Environment Variables
+# Copy this file to .env.local and fill in your values before running `pnpm dev`
+
+# ─── Core ────────────────────────────────────────────────────────────────────
+# 32+ character secret used for signing sessions and tokens
+REVEALUI_SECRET=change-me-to-a-long-random-secret-at-least-32-chars
+
+# Public URL of your CMS server (must match NEXT_PUBLIC_SERVER_URL)
+REVEALUI_PUBLIC_SERVER_URL=http://localhost:4000
+NEXT_PUBLIC_SERVER_URL=http://localhost:4000
+
+# ─── Database ────────────────────────────────────────────────────────────────
+# PostgreSQL connection string (NeonDB, Supabase, or local Postgres)
+POSTGRES_URL=postgresql://postgres:postgres@localhost:5432/revealui
+
+# ─── Storage ─────────────────────────────────────────────────────────────────
+# Vercel Blob token for file uploads (optional — leave placeholder for local dev)
+BLOB_READ_WRITE_TOKEN=vercel_blob_rw_placeholder
+
+# ─── Stripe (optional) ───────────────────────────────────────────────────────
+# Use test keys during development: https://dashboard.stripe.com/test/apikeys
+STRIPE_SECRET_KEY=sk_test_placeholder
+STRIPE_WEBHOOK_SECRET=whsec_placeholder
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_placeholder
+
+# ─── Admin Bootstrap ─────────────────────────────────────────────────────────
+# Used on first run only to create the initial admin account
+REVEALUI_ADMIN_EMAIL=admin@example.com
+REVEALUI_ADMIN_PASSWORD=changeme-min-12-chars
+
+# ─── Branding (Enterprise white-label) ───────────────────────────────────────
+# Customize the admin UI for your brand. Enterprise license required for full white-label.
+# REVEALUI_BRAND_NAME=My CMS
+# REVEALUI_BRAND_LOGO_URL=https://example.com/logo.png
+# REVEALUI_BRAND_PRIMARY_COLOR=#ea580c
+# REVEALUI_SHOW_POWERED_BY=false

package/templates/starter/_gitignore

@@ -0,0 +1,26 @@
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Next.js
+.next/
+out/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Turbo
+.turbo/
+
+# Misc
+.DS_Store
+*.pem
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

package/templates/starter/next.config.mjs

@@ -0,0 +1,10 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  experimental: {
+    reactCompiler: true,
+  },
+  // Required for RevealUI CMS admin panel
+  transpilePackages: ['@revealui/core', '@revealui/presentation'],
+}
+
+export default nextConfig

package/templates/starter/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev --port 4000",
+    "build": "next build",
+    "start": "next start --port 4000",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "db:init": "revealui cms",
+    "db:migrate": "drizzle-kit migrate",
+    "db:seed": "tsx src/seed.ts"
+  },
+  "dependencies": {
+    "@revealui/core": "^0.2.0",
+    "@revealui/config": "^0.2.0",
+    "@revealui/db": "^0.2.0",
+    "@revealui/auth": "^0.2.0",
+    "@revealui/contracts": "^1.1.0",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sharp": "^0.34.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@revealui/dev": "^0.0.1",
+    "@tailwindcss/postcss": "^4.1.0",
+    "tailwindcss": "^4.1.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.0"
+  }
+}

package/templates/starter/postcss.config.mjs

@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+}

package/templates/starter/revealui.config.ts

@@ -0,0 +1,18 @@
+import config from '@revealui/config';
+import { buildConfig, universalPostgresAdapter } from '@revealui/core';
+import sharp from 'sharp';
+
+export default buildConfig({
+  serverURL: config.reveal.publicServerURL || 'http://localhost:4000',
+  secret: config.reveal.secret,
+  db: config.database.url
+    ? universalPostgresAdapter({ connectionString: config.database.url })
+    : universalPostgresAdapter({ provider: 'electric' }),
+  admin: {
+    user: 'users',
+  },
+  collections: [],
+  globals: [],
+  plugins: [],
+  sharp,
+});

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

@@ -0,0 +1,6 @@
+@import "tailwindcss";
+
+@theme {
+  --color-accent: #2563eb;
+  --color-accent-hover: #1d4ed8;
+}

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

@@ -0,0 +1,15 @@
+import type { Metadata } from 'next';
+import './globals.css';
+
+export const metadata: Metadata = {
+  title: 'RevealUI App',
+  description: 'Built with RevealUI',
+};
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

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

@@ -0,0 +1,18 @@
+export default function HomePage() {
+  return (
+    <main className="mx-auto max-w-xl px-4 py-16">
+      <h1 className="text-3xl font-bold tracking-tight text-gray-900">RevealUI</h1>
+      <p className="mt-3 text-gray-600">
+        Your project is running. Visit{' '}
+        <a href="/admin" className="font-medium text-accent hover:text-accent-hover">
+          /admin
+        </a>{' '}
+        to manage content.
+      </p>
+      <p className="mt-6 text-sm text-gray-500">
+        Edit <code className="rounded bg-gray-100 px-1.5 py-0.5 text-xs">src/app/page.tsx</code> to
+        customize this page.
+      </p>
+    </main>
+  );
+}

package/templates/starter/src/seed.ts

@@ -0,0 +1,40 @@
+/**
+ * Database seed script
+ *
+ * Run with: pnpm db:seed
+ *
+ * Customize this file to populate your database with initial data.
+ * The examples below show common patterns — uncomment and adapt as needed.
+ */
+
+// import { getClient } from '@revealui/db/client';
+// import { users, posts } from '@revealui/db/schema';
+
+async function seed(): Promise<void> {
+  // const db = getClient();
+
+  // Example: create an admin user
+  // await db.insert(users).values({
+  //   id: crypto.randomUUID(),
+  //   email: 'admin@example.com',
+  //   name: 'Admin',
+  //   role: 'admin',
+  //   status: 'active',
+  //   emailVerified: true,
+  // });
+
+  // Example: create sample content
+  // await db.insert(posts).values({
+  //   id: crypto.randomUUID(),
+  //   title: 'Welcome to RevealUI',
+  //   slug: 'welcome',
+  //   status: 'published',
+  // });
+
+  process.stdout.write('Seed complete.\n');
+}
+
+seed().catch((error: unknown) => {
+  process.stderr.write(`Seed failed: ${error}\n`);
+  process.exit(1);
+});

package/templates/starter/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@revealui/dev/ts/nextjs",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src", "next.config.mjs", "revealui.config.ts"],
+  "exclude": ["node_modules"]
+}

package/dist/commands/add.d.ts

@@ -1,28 +0,0 @@
-/**
- * reveal add <plugin> command
- * Install and configure RevealUI plugins
- */
-/**
- * Options for adding a plugin
- */
-export interface AddPluginOptions {
-    /** Name of the plugin to add */
-    pluginName: string;
-    /** Plugin-specific options */
-    options?: Record<string, unknown>;
-}
-/**
- * Adds a plugin to the project
- * Installs the plugin package and updates reveal.config.ts
- *
- * @param options - Plugin addition options
- * @example
- * ```ts
- * await addPlugin({
- *   pluginName: 'react',
- *   options: {},
- * })
- * ```
- */
-export declare function addPlugin(options: AddPluginOptions): Promise<void>;
-//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AA8BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Ff"}

package/dist/commands/add.js

@@ -1,115 +0,0 @@
-/**
- * reveal add <plugin> command
- * Install and configure RevealUI plugins
- */
-import { execSync } from "node:child_process";
-import fs from "node:fs/promises";
-import path from "node:path";
-import pc from "@brillout/picocolors";
-/**
- * Available plugins
- */
-const AVAILABLE_PLUGINS = {
-    react: {
-        package: "reveal",
-        importPath: "reveal/plugins/react",
-        config: () => "react()",
-    },
-    payload: {
-        package: "reveal",
-        importPath: "reveal/plugins/payload",
-        config: () => "payload()",
-    },
-    vercel: {
-        package: "reveal",
-        importPath: "reveal/plugins/vercel",
-        config: () => "vercel()",
-    },
-};
-/**
- * Adds a plugin to the project
- * Installs the plugin package and updates reveal.config.ts
- *
- * @param options - Plugin addition options
- * @example
- * ```ts
- * await addPlugin({
- *   pluginName: 'react',
- *   options: {},
- * })
- * ```
- */
-export async function addPlugin(options) {
-    const { pluginName, options: pluginOptions = {} } = options;
-    if (!AVAILABLE_PLUGINS[pluginName]) {
-        throw new Error(`Unknown plugin: ${pluginName}. Available plugins: ${Object.keys(AVAILABLE_PLUGINS).join(", ")}`);
-    }
-    const plugin = AVAILABLE_PLUGINS[pluginName];
-    console.log(pc.cyan(`Adding plugin: ${pluginName}...`));
-    // Install package if needed (for future external plugins)
-    if (plugin.package !== "reveal") {
-        try {
-            execSync(`pnpm add ${plugin.package}`, { stdio: "inherit" });
-        }
-        catch (error) {
-            console.warn(pc.yellow(`Failed to install ${plugin.package}, continuing anyway...`));
-        }
-    }
-    // Update reveal.config.ts
-    const configPath = path.join(process.cwd(), "reveal.config.ts");
-    try {
-        let configContent = await fs.readFile(configPath, "utf-8");
-        // Check if plugin is already added
-        if (configContent.includes(plugin.importPath)) {
-            console.log(pc.yellow(`Plugin ${pluginName} is already configured`));
-            return;
-        }
-        // Add import
-        const importLine = `import ${pluginName} from "${plugin.importPath}";`;
-        if (!configContent.includes(importLine)) {
-            // Find the last import statement
-            const importMatch = configContent.match(/^import .+ from .+;$/gm);
-            if (importMatch && importMatch.length > 0) {
-                const lastImport = importMatch[importMatch.length - 1];
-                if (lastImport) {
-                    const lastImportIndex = configContent.lastIndexOf(lastImport);
-                    const insertIndex = lastImportIndex + lastImport.length;
-                    configContent =
-                        configContent.slice(0, insertIndex) +
-                            "\n" +
-                            importLine +
-                            configContent.slice(insertIndex);
-                }
-            }
-            else {
-                // No imports, add at the top
-                configContent = importLine + "\n" + configContent;
-            }
-        }
-        // Add to plugins array
-        const pluginConfig = plugin.config
-            ? plugin.config(pluginOptions)
-            : `${pluginName}()`;
-        // Find plugins array and add plugin
-        const pluginsMatch = configContent.match(/plugins:\s*\[([^\]]*)\]/);
-        if (pluginsMatch && pluginsMatch[1] !== undefined) {
-            const pluginsContent = pluginsMatch[1];
-            const newPluginsContent = pluginsContent.trim() === ""
-                ? pluginConfig
-                : `${pluginsContent.trim()},\n    ${pluginConfig}`;
-            configContent = configContent.replace(/plugins:\s*\[([^\]]*)\]/, `plugins: [\n    ${newPluginsContent}\n  ]`);
-        }
-        else {
-            // No plugins array, add it
-            configContent = configContent.replace(/defineConfig\(\{/, `defineConfig({\n  plugins: [\n    ${pluginConfig}\n  ],`);
-        }
-        await fs.writeFile(configPath, configContent, "utf-8");
-        console.log(pc.green(`✓ Plugin ${pluginName} added successfully!`));
-    }
-    catch (error) {
-        if (error.code === "ENOENT") {
-            throw new Error("reveal.config.ts not found. Run 'reveal init' first to create a project.");
-        }
-        throw error;
-    }
-}

package/dist/commands/check.d.ts

@@ -1,7 +0,0 @@
-/**
- * Quick health check command (lightweight version of doctor)
- * Returns exit code 0 if all critical checks pass, 1 otherwise
- * Designed for CI/CD integration
- */
-export declare function runCheck(): Promise<number>;
-//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAuBhD"}

package/dist/commands/check.js

@@ -1,34 +0,0 @@
-import { runDiagnostics } from "./doctor/index.js";
-/**
- * Quick health check command (lightweight version of doctor)
- * Returns exit code 0 if all critical checks pass, 1 otherwise
- * Designed for CI/CD integration
- */
-export async function runCheck() {
-    const results = await runDiagnostics();
-    // Filter to only critical failures
-    const criticalFailures = results.filter((r) => r.status === "fail" && isCriticalCheck(r.check));
-    if (criticalFailures.length === 0) {
-        // All critical checks passed
-        return 0;
-    }
-    // At least one critical check failed
-    console.error(`\n✗ ${criticalFailures.length} critical check(s) failed:\n`);
-    for (const result of criticalFailures) {
-        console.error(`  ✗ ${result.check}: ${result.message}`);
-    }
-    console.error();
-    return 1;
-}
-/**
- * Determine if a check is critical (blocks development/deployment)
- */
-function isCriticalCheck(check) {
-    const criticalChecks = [
-        "reveal.config.ts exists",
-        "reveal package installed",
-        "package.json exists",
-        "required dependencies",
-    ];
-    return criticalChecks.some((critical) => check.includes(critical));
-}

package/dist/commands/doctor/checks/build.d.ts

@@ -1,10 +0,0 @@
-import type { DiagnosticResult } from "../types.js";
-/**
- * Check TypeScript compilation
- */
-export declare function checkTypeScriptCompilation(cwd: string): Promise<DiagnosticResult[]>;
-/**
- * Check if build process works
- */
-export declare function checkBuildProcess(cwd: string): Promise<DiagnosticResult[]>;
-//# sourceMappingURL=build.d.ts.map

package/dist/commands/doctor/checks/build.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/commands/doctor/checks/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkC7B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgC7B"}

package/dist/commands/doctor/checks/build.js

@@ -1,74 +0,0 @@
-import { execSync } from "child_process";
-/**
- * Check TypeScript compilation
- */
-export async function checkTypeScriptCompilation(cwd) {
-    const results = [];
-    try {
-        execSync("pnpm typecheck 2>&1", {
-            cwd,
-            stdio: "pipe",
-            timeout: 30000,
-        });
-        results.push({
-            check: "TypeScript compilation",
-            status: "pass",
-            message: "TypeScript compiles without errors",
-        });
-    }
-    catch (error) {
-        const errorOutput = error instanceof Error ? error.message : String(error);
-        if (errorOutput.includes("command not found") || errorOutput.includes("Missing script")) {
-            results.push({
-                check: "TypeScript compilation",
-                status: "warn",
-                message: "TypeScript check script not found",
-                suggestion: "Add 'typecheck' script to package.json",
-            });
-        }
-        else {
-            results.push({
-                check: "TypeScript compilation",
-                status: "fail",
-                message: "TypeScript compilation errors found",
-                suggestion: "Run 'pnpm typecheck' to see detailed errors",
-            });
-        }
-    }
-    return results;
-}
-/**
- * Check if build process works
- */
-export async function checkBuildProcess(cwd) {
-    const results = [];
-    // Just check if build script exists, don't actually run it
-    try {
-        const { readFileSync } = await import("fs");
-        const packageJsonPath = `${cwd}/package.json`;
-        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-        if (packageJson.scripts?.build) {
-            results.push({
-                check: "build script",
-                status: "pass",
-                message: "Build script found in package.json",
-            });
-        }
-        else {
-            results.push({
-                check: "build script",
-                status: "warn",
-                message: "Build script not found",
-                suggestion: "Add 'build' script to package.json",
-            });
-        }
-    }
-    catch {
-        results.push({
-            check: "build script",
-            status: "warn",
-            message: "Could not check build script",
-        });
-    }
-    return results;
-}

package/dist/commands/doctor/checks/config.d.ts

@@ -1,14 +0,0 @@
-import type { DiagnosticResult } from "../types.js";
-/**
- * Check reveal.config.ts exists and is valid
- */
-export declare function checkRevealConfig(cwd: string): Promise<DiagnosticResult[]>;
-/**
- * Check TypeScript configuration
- */
-export declare function checkTypeScriptConfig(cwd: string): Promise<DiagnosticResult[]>;
-/**
- * Check environment variables
- */
-export declare function checkEnvironmentVariables(cwd: string): Promise<DiagnosticResult[]>;
-//# sourceMappingURL=config.d.ts.map

package/dist/commands/doctor/checks/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/commands/doctor/checks/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiC7B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgC7B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwC7B"}