npm - @digilogiclabs/create-saas-app - Versions diffs - 2.0.0 → 2.2.0 - Mend

@digilogiclabs/create-saas-app 2.0.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (348) hide show

package/dist/templates/shared/error-pages/web/app/error.tsx ADDED Viewed

@@ -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/dist/templates/shared/error-pages/web/app/global-error.tsx ADDED Viewed

@@ -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/dist/templates/shared/error-pages/web/app/not-found.tsx ADDED Viewed

@@ -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/dist/templates/shared/health/web/app/api/health/route.ts ADDED Viewed

@@ -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/dist/templates/shared/legal/web/app/(legal)/privacy/page.tsx ADDED Viewed

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

package/dist/templates/shared/legal/web/app/(legal)/terms/page.tsx ADDED Viewed

@@ -0,0 +1,154 @@
+import { Metadata } from 'next';
+import { LEGAL_CONFIG } from '@/lib/legal-config';
+export const metadata: Metadata = {
+  title: `Terms of Service | ${LEGAL_CONFIG.appName}`,
+  description: `Terms of Service for ${LEGAL_CONFIG.appName}. Read our terms and conditions.`,
+  alternates: {
+    canonical: `${LEGAL_CONFIG.appUrl}/terms`,
+  },
+};
+export default function TermsPage() {
+  const {
+    appName,
+    companyName,
+    appUrl,
+    supportEmail,
+    effectiveDate,
+    minimumAge,
+    jurisdiction,
+    hasPayments,
+    platformFeePercent,
+  } = 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">
+          Terms of Service
+        </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. Acceptance of Terms</h2>
+            <p>
+              By accessing or using {appName} ({appUrl}), you agree to be bound
+              by these Terms of Service. If you do not agree, do not use the
+              service.
+            </p>
+          </section>
+          {minimumAge > 0 && (
+            <section>
+              <h2>2. Age Requirement</h2>
+              <p>
+                You must be at least {minimumAge} years old to use {appName}. By
+                using this service, you represent that you meet this age
+                requirement.
+              </p>
+            </section>
+          )}
+          <section>
+            <h2>{minimumAge > 0 ? '3' : '2'}. User Accounts</h2>
+            <p>
+              You are responsible for maintaining the confidentiality of your
+              account credentials and for all activities under your account.
+              Notify us immediately of any unauthorized use.
+            </p>
+          </section>
+          <section>
+            <h2>{minimumAge > 0 ? '4' : '3'}. Acceptable Use</h2>
+            <p>You agree not to:</p>
+            <ul>
+              <li>Violate any applicable laws or regulations</li>
+              <li>
+                Upload harmful, offensive, or infringing content
+              </li>
+              <li>Attempt to access other users&apos; accounts</li>
+              <li>
+                Use automated tools to scrape or interfere with the service
+              </li>
+              <li>Impersonate any person or entity</li>
+            </ul>
+          </section>
+          {hasPayments && (
+            <section>
+              <h2>{minimumAge > 0 ? '5' : '4'}. Payments &amp; Fees</h2>
+              <p>
+                Payments are processed securely through Stripe. All fees are
+                listed at the time of purchase.
+                {Number(platformFeePercent) > 0 &&
+                  ` ${appName} charges a ${platformFeePercent}% platform fee on applicable transactions.`}
+              </p>
+              <p>
+                Refund policies are described at the point of sale. You are
+                responsible for any applicable taxes on your purchases.
+              </p>
+            </section>
+          )}
+          <section>
+            <h2>Intellectual Property</h2>
+            <p>
+              {appName} and its original content, features, and functionality
+              are owned by {companyName}. You retain ownership of content you
+              submit but grant us a license to display it as part of the
+              service.
+            </p>
+          </section>
+          <section>
+            <h2>Termination</h2>
+            <p>
+              We may suspend or terminate your account for violations of these
+              terms. You may delete your account at any time. Upon termination,
+              your right to use the service ceases immediately.
+            </p>
+          </section>
+          <section>
+            <h2>Limitation of Liability</h2>
+            <p>
+              {appName} is provided &quot;as is&quot; without warranties of any
+              kind. {companyName} shall not be liable for any indirect,
+              incidental, or consequential damages arising from your use of the
+              service.
+            </p>
+          </section>
+          <section>
+            <h2>Governing Law</h2>
+            <p>
+              These terms are governed by the laws of {jurisdiction}. Any
+              disputes shall be resolved in the courts of {jurisdiction}.
+            </p>
+          </section>
+          <section>
+            <h2>Changes to Terms</h2>
+            <p>
+              We may update these terms at any time. Continued use after changes
+              constitutes acceptance. We will notify registered users of
+              material changes via email.
+            </p>
+          </section>
+          <section>
+            <h2>Contact</h2>
+            <p>
+              Questions about these terms? Contact us at{' '}
+              <a href={`mailto:${supportEmail}`}>{supportEmail}</a>.
+            </p>
+          </section>
+        </div>
+      </div>
+    </main>
+  );
+}

package/dist/templates/shared/legal/web/lib/legal-config.ts ADDED Viewed

@@ -0,0 +1,50 @@
+/**
+ * Legal page configuration.
+ *
+ * Update these values to match your app's legal details.
+ * Used by the Terms of Service and Privacy Policy pages.
+ */
+export const LEGAL_CONFIG = {
+  /** App display name */
+  appName: 'My App',
+  /** Company or entity name */
+  companyName: 'My Company',
+  /** Production URL (no trailing slash) */
+  appUrl: process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000',
+  /** Support email address */
+  supportEmail: 'support@example.com',
+  /** Privacy-specific contact email */
+  privacyEmail: 'privacy@example.com',
+  /** Date the terms/privacy were last updated */
+  effectiveDate: 'January 1, 2026',
+  /** Minimum age requirement (0 to disable) */
+  minimumAge: 18,
+  /** Jurisdiction / governing law */
+  jurisdiction: 'the United States',
+  /** Whether the app processes payments */
+  hasPayments: true,
+  /** Platform fee percentage (if applicable) */
+  platformFeePercent: '0',
+  /** Whether the app uses cookies beyond essentials */
+  usesAnalyticsCookies: true,
+  /** Third-party services used (listed in privacy policy) */
+  thirdPartyServices: [
+    'Stripe (payment processing)',
+    'Cloudflare (CDN and security)',
+    'Resend (transactional email)',
+  ],
+  /** Data retention period */
+  dataRetentionPeriod: '3 years after account deletion',
+} as const;