@digilogiclabs/create-saas-app 2.1.0 → 2.2.1

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 }
+  );
+}

package/src/templates/shared/legal/web/app/(legal)/privacy/page.tsx

@@ -0,0 +1,205 @@
+import { Metadata } from 'next';
+import { LEGAL_CONFIG } from '@/lib/legal-config';
+
+export const metadata: Metadata = {
+  title: `Privacy Policy | ${LEGAL_CONFIG.appName}`,
+  description: `Privacy Policy for ${LEGAL_CONFIG.appName}. Learn how we collect, use, and protect your data.`,
+  alternates: {
+    canonical: `${LEGAL_CONFIG.appUrl}/privacy`,
+  },
+};
+
+export default function PrivacyPage() {
+  const {
+    appName,
+    companyName,
+    appUrl,
+    supportEmail,
+    privacyEmail,
+    effectiveDate,
+    thirdPartyServices,
+    usesAnalyticsCookies,
+    dataRetentionPeriod,
+  } = LEGAL_CONFIG;
+
+  return (
+    <main className="min-h-screen bg-white dark:bg-gray-950">
+      <div className="mx-auto max-w-3xl px-4 py-16 sm:px-6 lg:px-8">
+        <h1 className="mb-2 text-3xl font-bold tracking-tight text-gray-900 dark:text-white">
+          Privacy Policy
+        </h1>
+        <p className="mb-8 text-sm text-gray-500 dark:text-gray-400">
+          Effective: {effectiveDate}
+        </p>
+
+        <div className="prose prose-gray dark:prose-invert max-w-none">
+          <section>
+            <h2>1. Information We Collect</h2>
+            <p>We collect information you provide directly:</p>
+            <ul>
+              <li>
+                <strong>Account data:</strong> name, email, profile information
+              </li>
+              <li>
+                <strong>Usage data:</strong> pages visited, features used,
+                interactions
+              </li>
+              <li>
+                <strong>Device data:</strong> browser type, IP address, operating
+                system
+              </li>
+            </ul>
+          </section>
+
+          <section>
+            <h2>2. How We Use Your Information</h2>
+            <ul>
+              <li>Provide and improve the service</li>
+              <li>Send transactional emails (account, security, updates)</li>
+              <li>Analyze usage patterns to improve user experience</li>
+              <li>Prevent fraud and enforce our terms</li>
+              <li>Comply with legal obligations</li>
+            </ul>
+          </section>
+
+          <section>
+            <h2>3. Information Sharing</h2>
+            <p>
+              We do not sell your personal data. We may share information with:
+            </p>
+            <ul>
+              <li>
+                <strong>Service providers:</strong> who help us operate{' '}
+                {appName}
+              </li>
+              <li>
+                <strong>Legal authorities:</strong> when required by law or to
+                protect rights
+              </li>
+            </ul>
+            {thirdPartyServices.length > 0 && (
+              <>
+                <p>Third-party services we use:</p>
+                <ul>
+                  {thirdPartyServices.map((service) => (
+                    <li key={service}>{service}</li>
+                  ))}
+                </ul>
+              </>
+            )}
+          </section>
+
+          <section>
+            <h2>4. Cookies</h2>
+            <p>We use cookies for:</p>
+            <ul>
+              <li>
+                <strong>Essential cookies:</strong> authentication, security,
+                preferences
+              </li>
+              {usesAnalyticsCookies && (
+                <li>
+                  <strong>Analytics cookies:</strong> understanding how users
+                  interact with {appName}
+                </li>
+              )}
+            </ul>
+            <p>
+              You can control cookies through your browser settings. Disabling
+              essential cookies may limit functionality.
+            </p>
+          </section>
+
+          <section>
+            <h2>5. Your Rights</h2>
+            <p>You have the right to:</p>
+            <ul>
+              <li>
+                <strong>Access:</strong> request a copy of your personal data
+              </li>
+              <li>
+                <strong>Rectification:</strong> correct inaccurate data
+              </li>
+              <li>
+                <strong>Erasure:</strong> request deletion of your data
+              </li>
+              <li>
+                <strong>Portability:</strong> receive your data in a portable
+                format
+              </li>
+              <li>
+                <strong>Objection:</strong> object to certain processing of your
+                data
+              </li>
+            </ul>
+            <p>
+              To exercise these rights, contact{' '}
+              <a href={`mailto:${privacyEmail}`}>{privacyEmail}</a>.
+            </p>
+          </section>
+
+          <section>
+            <h2>6. Data Security</h2>
+            <p>
+              We implement industry-standard security measures including
+              encryption in transit (TLS), encrypted storage, and access
+              controls. No method of transmission is 100% secure, but we strive
+              to protect your data.
+            </p>
+          </section>
+
+          <section>
+            <h2>7. Data Retention</h2>
+            <p>
+              We retain your data for as long as your account is active. After
+              deletion, data is retained for {dataRetentionPeriod} for legal and
+              operational purposes, then permanently deleted.
+            </p>
+          </section>
+
+          <section>
+            <h2>8. Children&apos;s Privacy</h2>
+            <p>
+              {appName} is not directed at children under 13. We do not
+              knowingly collect data from children. If you believe a child has
+              provided us data, contact us for removal.
+            </p>
+          </section>
+
+          <section>
+            <h2>9. International Transfers</h2>
+            <p>
+              Your data may be processed in countries outside your own. We
+              ensure appropriate safeguards are in place for such transfers in
+              compliance with applicable data protection laws.
+            </p>
+          </section>
+
+          <section>
+            <h2>10. Changes to This Policy</h2>
+            <p>
+              We may update this policy periodically. We will notify you of
+              material changes via email or prominent notice on {appName}.
+              Continued use after changes constitutes acceptance.
+            </p>
+          </section>
+
+          <section>
+            <h2>11. Contact</h2>
+            <p>
+              For privacy questions or data requests, contact us at{' '}
+              <a href={`mailto:${privacyEmail}`}>{privacyEmail}</a>.
+            </p>
+            <p>
+              {companyName}
+              <br />
+              {appUrl}
+              <br />
+              {supportEmail}
+            </p>
+          </section>
+        </div>
+      </div>
+    </main>
+  );
+}