@digilogiclabs/create-saas-app 2.0.0 → 2.2.0

package/src/templates/shared/database/postgresql/web/lib/db/schema.ts

@@ -0,0 +1,33 @@
+/**
+ * Drizzle ORM Schema
+ *
+ * Define your database tables here. Each app uses its own schema namespace
+ * for isolation when sharing a PostgreSQL instance.
+ *
+ * Usage:
+ *   import { db } from '@/lib/db/drizzle';
+ *   import { users } from '@/lib/db/schema';
+ *   const allUsers = await db.select().from(users);
+ *
+ * Generate migrations:
+ *   npx drizzle-kit generate
+ *
+ * Apply migrations:
+ *   npx drizzle-kit push
+ */
+import { pgTable, text, timestamp, boolean } from 'drizzle-orm/pg-core';
+// import { pgSchema } from 'drizzle-orm/pg-core'; // Uncomment for schema isolation
+
+// Use a schema namespace for isolation (recommended for multi-app databases)
+// export const appSchema = pgSchema('myapp');
+// export const users = appSchema.table('users', { ... });
+
+// Or use public schema (simpler for single-app databases)
+export const users = pgTable('users', {
+  id: text('id').primaryKey(),
+  email: text('email').notNull().unique(),
+  name: text('name'),
+  emailVerified: boolean('email_verified').default(false),
+  createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+  updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
+});

package/src/templates/shared/database/supabase/web/lib/supabase/client.ts

@@ -0,0 +1,12 @@
+import { createBrowserClient } from '@supabase/ssr';
+
+/**
+ * Supabase client for use in Client Components.
+ * Uses browser-side auth (reads cookies automatically).
+ */
+export function createClient() {
+  return createBrowserClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
+  );
+}

package/src/templates/shared/database/supabase/web/lib/supabase/server.ts

@@ -0,0 +1,31 @@
+import { createServerClient } from '@supabase/ssr';
+import { cookies } from 'next/headers';
+
+/**
+ * Supabase client for use in Server Components, Route Handlers, and Server Actions.
+ * Reads and writes auth cookies via Next.js cookies() API.
+ */
+export async function createClient() {
+  const cookieStore = await cookies();
+
+  return createServerClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+    {
+      cookies: {
+        getAll() {
+          return cookieStore.getAll();
+        },
+        setAll(cookiesToSet) {
+          try {
+            cookiesToSet.forEach(({ name, value, options }) =>
+              cookieStore.set(name, value, options)
+            );
+          } catch {
+            // Called from a Server Component — cookies are read-only
+          }
+        },
+      },
+    }
+  );
+}

package/src/templates/shared/database/supabase/web/lib/supabase/service.ts

@@ -0,0 +1,15 @@
+import 'server-only';
+import { createClient } from '@supabase/supabase-js';
+
+/**
+ * Supabase admin client with service_role key.
+ * Bypasses Row Level Security — use only in trusted server-side code
+ * (webhooks, cron jobs, admin operations).
+ */
+export function createServiceClient() {
+  return createClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.SUPABASE_SERVICE_ROLE_KEY!,
+    { auth: { persistSession: false } }
+  );
+}

package/src/templates/shared/email/web/lib/email/branding.ts

@@ -0,0 +1,18 @@
+import type { EmailBranding } from '@digilogiclabs/platform-core/email-templates';
+
+/**
+ * App branding for shared email templates.
+ * Used by platform-core's email template functions (welcomeEmail, notificationEmail, etc.)
+ *
+ * Update these values to match your app's branding.
+ */
+export const APP_BRANDING: EmailBranding = {
+  appName: 'My App',
+  primaryColor: '#3b82f6',
+  gradientFrom: '#3b82f6',
+  gradientTo: '#8b5cf6',
+  fromEmail: 'noreply@example.com',
+  supportEmail: 'support@example.com',
+  baseUrl: process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000',
+  footerText: 'Built with Digi Logic Labs platform',
+};

package/src/templates/shared/email/web/lib/email/client.ts

@@ -0,0 +1,96 @@
+/**
+ * Email client singleton.
+ *
+ * Lazy-initializes a Resend client when first needed.
+ * Returns null gracefully if RESEND_API_KEY is not configured.
+ *
+ * Usage:
+ *   import { sendEmail } from '@/lib/email/client';
+ *   await sendEmail({ to: 'user@example.com', subject: 'Hello', html: '<p>Hi</p>' });
+ */
+
+let resendClient: Resend | null = null;
+let initialized = false;
+
+type Resend = {
+  emails: {
+    send: (params: {
+      from: string;
+      to: string | string[];
+      subject: string;
+      html: string;
+      text?: string;
+      replyTo?: string;
+    }) => Promise<{ data: { id: string } | null; error: { message: string } | null }>;
+  };
+};
+
+function getResend(): Resend | null {
+  if (initialized) return resendClient;
+  initialized = true;
+
+  const apiKey = process.env.RESEND_API_KEY;
+  if (!apiKey) {
+    console.warn('[Email] RESEND_API_KEY not configured — emails will be logged to console');
+    return null;
+  }
+
+  try {
+    // Dynamic import to avoid requiring resend in all environments
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { Resend } = require('resend');
+    resendClient = new Resend(apiKey);
+    return resendClient;
+  } catch {
+    console.warn('[Email] resend package not installed — emails will be logged to console');
+    return null;
+  }
+}
+
+const DEFAULT_FROM = process.env.EMAIL_FROM || 'noreply@example.com';
+
+interface EmailParams {
+  to: string | string[];
+  subject: string;
+  html: string;
+  text?: string;
+  from?: string;
+  replyTo?: string;
+}
+
+/**
+ * Send an email via Resend. Returns true on success, false on failure.
+ * Falls back to console logging in development or when Resend is not configured.
+ */
+export async function sendEmail(params: EmailParams): Promise<boolean> {
+  const from = params.from || DEFAULT_FROM;
+  const resend = getResend();
+
+  if (!resend) {
+    if (process.env.NODE_ENV === 'development') {
+      console.log('[Email] Would send:', { to: params.to, subject: params.subject, from });
+    }
+    return false;
+  }
+
+  try {
+    const { error } = await resend.emails.send({
+      from,
+      to: params.to,
+      subject: params.subject,
+      html: params.html,
+      text: params.text,
+      replyTo: params.replyTo,
+    });
+
+    if (error) {
+      console.error('[Email] Send failed:', error.message);
+      return false;
+    }
+
+    return true;
+  } catch (err) {
+    console.error('[Email] Send error:', err);
+    return false;
+  }
+}

package/src/templates/shared/error-pages/web/app/error.tsx

@@ -0,0 +1,70 @@
+'use client';
+
+/**
+ * Error boundary page.
+ *
+ * Catches runtime errors in the app and shows a recovery UI.
+ * Shows error details in development mode only.
+ */
+export default function Error({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  return (
+    <main className="flex min-h-screen items-center justify-center bg-white px-4 dark:bg-gray-950">
+      <div className="text-center">
+        <div className="mx-auto mb-4 flex h-16 w-16 items-center justify-center rounded-full bg-red-100 dark:bg-red-900/30">
+          <svg
+            className="h-8 w-8 text-red-600 dark:text-red-400"
+            fill="none"
+            viewBox="0 0 24 24"
+            strokeWidth="1.5"
+            stroke="currentColor"
+          >
+            <path
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              d="M12 9v3.75m-9.303 3.376c-.866 1.5.217 3.374 1.948 3.374h14.71c1.73 0 2.813-1.874 1.948-3.374L13.949 3.378c-.866-1.5-3.032-1.5-3.898 0L2.697 16.126ZM12 15.75h.007v.008H12v-.008Z"
+            />
+          </svg>
+        </div>
+        <h1 className="text-2xl font-semibold text-gray-900 dark:text-white">
+          Something went wrong
+        </h1>
+        <p className="mt-2 max-w-md text-gray-600 dark:text-gray-400">
+          An unexpected error occurred. Please try again.
+        </p>
+        {error.digest && (
+          <p className="mt-1 text-xs text-gray-400 dark:text-gray-500">
+            Error ID: {error.digest}
+          </p>
+        )}
+
+        {process.env.NODE_ENV === 'development' && (
+          <pre className="mx-auto mt-4 max-w-lg overflow-auto rounded-lg bg-gray-100 p-4 text-left text-xs text-red-600 dark:bg-gray-900 dark:text-red-400">
+            {error.message}
+            {error.stack && `\n\n${error.stack}`}
+          </pre>
+        )}
+
+        <div className="mt-8 flex items-center justify-center gap-4">
+          <button
+            onClick={reset}
+            className="rounded-lg bg-blue-600 px-5 py-2.5 text-sm font-medium text-white transition-colors hover:bg-blue-700"
+          >
+            Try Again
+          </button>
+          <a
+            href="/"
+            className="rounded-lg border border-gray-300 px-5 py-2.5 text-sm font-medium text-gray-700 transition-colors hover:bg-gray-50 dark:border-gray-700 dark:text-gray-300 dark:hover:bg-gray-800"
+          >
+            Go Home
+          </a>
+        </div>
+      </div>
+    </main>
+  );
+}

package/src/templates/shared/error-pages/web/app/global-error.tsx

@@ -0,0 +1,102 @@
+'use client';
+
+/**
+ * Root error boundary.
+ *
+ * This is the last-resort error handler that catches errors in the root layout.
+ * It must render its own <html> and <body> tags since it replaces the entire page.
+ * Uses inline styles only — no framework CSS is available at this level.
+ */
+export default function GlobalError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  return (
+    <html lang="en">
+      <body
+        style={{
+          margin: 0,
+          minHeight: '100vh',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          fontFamily:
+            '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+          backgroundColor: '#fafafa',
+          color: '#111',
+        }}
+      >
+        <div style={{ textAlign: 'center', padding: '2rem' }}>
+          <div
+            style={{
+              width: 64,
+              height: 64,
+              margin: '0 auto 1rem',
+              borderRadius: '50%',
+              backgroundColor: '#fee2e2',
+              display: 'flex',
+              alignItems: 'center',
+              justifyContent: 'center',
+              fontSize: 32,
+            }}
+          >
+            !
+          </div>
+          <h1 style={{ fontSize: '1.5rem', fontWeight: 600, margin: 0 }}>
+            Something went wrong
+          </h1>
+          <p style={{ color: '#666', marginTop: '0.5rem' }}>
+            A critical error occurred. Please try reloading the page.
+          </p>
+          {error.digest && (
+            <p style={{ color: '#999', fontSize: '0.75rem', marginTop: '0.25rem' }}>
+              Error ID: {error.digest}
+            </p>
+          )}
+          <div
+            style={{
+              marginTop: '2rem',
+              display: 'flex',
+              gap: '1rem',
+              justifyContent: 'center',
+            }}
+          >
+            <button
+              onClick={reset}
+              style={{
+                padding: '0.625rem 1.25rem',
+                backgroundColor: '#2563eb',
+                color: 'white',
+                border: 'none',
+                borderRadius: '0.5rem',
+                cursor: 'pointer',
+                fontSize: '0.875rem',
+                fontWeight: 500,
+              }}
+            >
+              Try Again
+            </button>
+            <a
+              href="/"
+              style={{
+                padding: '0.625rem 1.25rem',
+                backgroundColor: 'white',
+                color: '#374151',
+                border: '1px solid #d1d5db',
+                borderRadius: '0.5rem',
+                textDecoration: 'none',
+                fontSize: '0.875rem',
+                fontWeight: 500,
+              }}
+            >
+              Go Home
+            </a>
+          </div>
+        </div>
+      </body>
+    </html>
+  );
+}

package/src/templates/shared/error-pages/web/app/not-found.tsx

@@ -0,0 +1,39 @@
+import Link from 'next/link';
+
+/**
+ * Custom 404 page.
+ *
+ * Shown when a route is not found. Uses Tailwind CSS for styling.
+ * Customize the links and messaging to match your app.
+ */
+export default function NotFound() {
+  return (
+    <main className="flex min-h-screen items-center justify-center bg-white px-4 dark:bg-gray-950">
+      <div className="text-center">
+        <p className="bg-gradient-to-r from-blue-500 to-purple-600 bg-clip-text text-8xl font-bold text-transparent">
+          404
+        </p>
+        <h1 className="mt-4 text-2xl font-semibold text-gray-900 dark:text-white">
+          Page not found
+        </h1>
+        <p className="mt-2 max-w-md text-gray-600 dark:text-gray-400">
+          The page you&apos;re looking for doesn&apos;t exist or has been moved.
+        </p>
+        <div className="mt-8 flex items-center justify-center gap-4">
+          <Link
+            href="/"
+            className="rounded-lg bg-blue-600 px-5 py-2.5 text-sm font-medium text-white transition-colors hover:bg-blue-700"
+          >
+            Go Home
+          </Link>
+          <Link
+            href="/dashboard"
+            className="rounded-lg border border-gray-300 px-5 py-2.5 text-sm font-medium text-gray-700 transition-colors hover:bg-gray-50 dark:border-gray-700 dark:text-gray-300 dark:hover:bg-gray-800"
+          >
+            Dashboard
+          </Link>
+        </div>
+      </div>
+    </main>
+  );
+}

package/src/templates/shared/health/web/app/api/health/route.ts

@@ -0,0 +1,68 @@
+import { NextResponse } from 'next/server';
+
+export const dynamic = 'force-dynamic';
+
+interface ServiceHealth {
+  status: 'up' | 'down' | 'unknown';
+  responseTime?: number;
+  error?: string;
+}
+
+/**
+ * GET /api/health
+ *
+ * Non-destructive health check for monitoring (Uptime Kuma, Coolify, K8s probes).
+ * Returns 200 if healthy, 503 if degraded/unhealthy.
+ */
+export async function GET() {
+  const services: Record<string, ServiceHealth> = {};
+  const details: string[] = [];
+
+  // Check database connectivity
+  try {
+    const start = Date.now();
+    // Replace with your database check — e.g. a simple SELECT 1
+    const dbUrl = process.env.DATABASE_URL;
+    services.database = dbUrl
+      ? { status: 'up', responseTime: Date.now() - start }
+      : { status: 'down', error: 'DATABASE_URL not configured' };
+  } catch {
+    services.database = { status: 'down', error: 'Database connection failed' };
+  }
+
+  // Check Redis connectivity
+  try {
+    const start = Date.now();
+    const redisUrl = process.env.REDIS_URL;
+    services.cache = redisUrl
+      ? { status: 'up', responseTime: Date.now() - start }
+      : { status: 'unknown', error: 'REDIS_URL not configured (optional)' };
+  } catch {
+    services.cache = { status: 'down', error: 'Cache connection failed' };
+  }
+
+  // Check email service
+  services.email = process.env.RESEND_API_KEY
+    ? { status: 'up' }
+    : { status: 'unknown', error: 'RESEND_API_KEY not configured' };
+
+  // Determine overall status
+  const dbDown = services.database?.status === 'down';
+  let status: 'healthy' | 'degraded' | 'unhealthy';
+
+  if (dbDown) {
+    status = 'unhealthy';
+    details.push('Database is down — critical service unavailable');
+  } else if (Object.values(services).some((s) => s.status === 'down')) {
+    status = 'degraded';
+    details.push('Some services degraded');
+  } else {
+    status = 'healthy';
+    details.push('All systems operational');
+  }
+
+  return NextResponse.json(
+    { status, timestamp: new Date().toISOString(), services, details },
+    { status: status === 'healthy' ? 200 : 503 }
+  );
+}