@revealui/cli 0.2.0 → 0.3.1

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/{minimal → starter}/revealui.config.ts

@@ -1,6 +1,6 @@
-import config from '@revealui/config'
-import { buildConfig, universalPostgresAdapter } from '@revealui/core'
-import sharp from 'sharp'
+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',
@@ -15,4 +15,4 @@ export default buildConfig({
   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/templates/minimal/src/app/globals.css

@@ -1,15 +0,0 @@
-*, *::before, *::after {
-  box-sizing: border-box;
-}
-
-body {
-  margin: 0;
-  font-family: system-ui, -apple-system, sans-serif;
-  line-height: 1.6;
-  color: #111;
-  background: #fff;
-}
-
-a {
-  color: #2563eb;
-}

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

@@ -1,20 +0,0 @@
-export default function HomePage() {
-  return (
-    <main
-      style={{
-        fontFamily: 'sans-serif',
-        maxWidth: '640px',
-        margin: '4rem auto',
-        padding: '0 1rem',
-      }}
-    >
-      <h1>Welcome to RevealUI</h1>
-      <p>
-        Your CMS is running. Visit <a href="/admin">/admin</a> to access the admin panel.
-      </p>
-      <p style={{ color: '#666', fontSize: '0.875rem' }}>
-        Edit <code>src/app/page.tsx</code> to customise this page.
-      </p>
-    </main>
-  )
-}