@digilogiclabs/create-saas-app 2.0.0 → 2.2.0

package/src/templates/shared/seo/web/app/api/og/route.tsx

@@ -0,0 +1,97 @@
+import { ImageResponse } from 'next/og';
+import { NextRequest } from 'next/server';
+
+export const runtime = 'edge';
+
+/**
+ * Dynamic Open Graph image generator.
+ *
+ * Usage: /api/og?title=My+Page&subtitle=Description+here
+ *
+ * Customize the colors and branding below to match your app.
+ */
+
+// ─── Customize these ────────────────────────────────────────
+const APP_NAME = 'My App';
+const BG_FROM = '#1e3a5f';
+const BG_TO = '#0f172a';
+const ACCENT = '#3b82f6';
+// ─────────────────────────────────────────────────────────────
+
+export async function GET(request: NextRequest) {
+  const { searchParams } = request.nextUrl;
+  const title = searchParams.get('title') || APP_NAME;
+  const subtitle = searchParams.get('subtitle') || '';
+
+  return new ImageResponse(
+    (
+      <div
+        style={{
+          width: '100%',
+          height: '100%',
+          display: 'flex',
+          flexDirection: 'column',
+          justifyContent: 'center',
+          padding: '60px 80px',
+          background: `linear-gradient(135deg, ${BG_FROM} 0%, ${BG_TO} 100%)`,
+          color: 'white',
+          fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+        }}
+      >
+        {/* App branding */}
+        <div
+          style={{
+            display: 'flex',
+            alignItems: 'center',
+            marginBottom: 40,
+            fontSize: 24,
+            opacity: 0.8,
+            letterSpacing: '0.05em',
+          }}
+        >
+          {APP_NAME}
+        </div>
+
+        {/* Title */}
+        <div
+          style={{
+            fontSize: title.length > 40 ? 48 : 64,
+            fontWeight: 700,
+            lineHeight: 1.1,
+            maxWidth: '90%',
+            marginBottom: subtitle ? 24 : 0,
+          }}
+        >
+          {title.length > 80 ? title.slice(0, 77) + '...' : title}
+        </div>
+
+        {/* Subtitle */}
+        {subtitle && (
+          <div
+            style={{
+              fontSize: 28,
+              opacity: 0.7,
+              maxWidth: '80%',
+              lineHeight: 1.3,
+            }}
+          >
+            {subtitle.length > 120 ? subtitle.slice(0, 117) + '...' : subtitle}
+          </div>
+        )}
+
+        {/* Accent bar */}
+        <div
+          style={{
+            position: 'absolute',
+            bottom: 0,
+            left: 0,
+            right: 0,
+            height: 6,
+            background: ACCENT,
+          }}
+        />
+      </div>
+    ),
+    { width: 1200, height: 630 },
+  );
+}

package/src/templates/shared/seo/web/app/robots.ts

@@ -0,0 +1,53 @@
+import { MetadataRoute } from 'next';
+
+const BASE_URL = process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000';
+
+/**
+ * Robots.txt configuration.
+ *
+ * Controls which paths search engines and AI crawlers can access.
+ * Adjust the rules to match your app's public and private routes.
+ *
+ * @see https://nextjs.org/docs/app/api-reference/file-conventions/metadata/robots
+ */
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: [
+      // ─── Main search engines (Google, Bing, etc.) ──────────────
+      {
+        userAgent: ['Googlebot', 'Bingbot', 'Slurp', 'DuckDuckBot', 'Baiduspider', 'YandexBot'],
+        allow: '/',
+        disallow: ['/api/', '/dashboard/', '/admin/', '/auth/'],
+      },
+
+      // ─── AI crawlers (allow indexing, block private routes) ────
+      {
+        userAgent: [
+          'GPTBot',
+          'Google-Extended',
+          'ChatGPT-User',
+          'ClaudeBot',
+          'PerplexityBot',
+          'Amazonbot',
+          'YouBot',
+        ],
+        allow: '/',
+        disallow: ['/api/', '/dashboard/', '/admin/', '/auth/'],
+      },
+
+      // ─── Training-only crawlers (block entirely) ───────────────
+      {
+        userAgent: ['CCBot', 'anthropic-ai'],
+        disallow: '/',
+      },
+
+      // ─── Default (allow public content) ────────────────────────
+      {
+        userAgent: '*',
+        allow: '/',
+        disallow: ['/api/', '/dashboard/', '/admin/', '/auth/'],
+      },
+    ],
+    sitemap: `${BASE_URL}/sitemap.xml`,
+  };
+}

package/src/templates/shared/seo/web/app/sitemap.ts

@@ -0,0 +1,53 @@
+import { MetadataRoute } from 'next';
+
+const BASE_URL = process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000';
+
+/**
+ * Dynamic sitemap generator.
+ *
+ * Generates a sitemap for search engine crawlers.
+ * Add your app's dynamic routes (e.g., user profiles, blog posts)
+ * alongside the static pages.
+ *
+ * @see https://nextjs.org/docs/app/api-reference/file-conventions/metadata/sitemap
+ */
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const now = new Date();
+
+  // ─── Static Pages ────────────────────────────────────────────
+  const staticPages: MetadataRoute.Sitemap = [
+    {
+      url: BASE_URL,
+      lastModified: now,
+      changeFrequency: 'daily',
+      priority: 1.0,
+    },
+    {
+      url: `${BASE_URL}/terms`,
+      lastModified: now,
+      changeFrequency: 'monthly',
+      priority: 0.3,
+    },
+    {
+      url: `${BASE_URL}/privacy`,
+      lastModified: now,
+      changeFrequency: 'monthly',
+      priority: 0.3,
+    },
+  ];
+
+  // ─── Dynamic Pages ───────────────────────────────────────────
+  // TODO: Add your dynamic routes here. Example:
+  //
+  // const { data: posts } = await db.from('posts').select('slug, updated_at');
+  // const postPages = (posts || []).map((post) => ({
+  //   url: `${BASE_URL}/blog/${post.slug}`,
+  //   lastModified: new Date(post.updated_at),
+  //   changeFrequency: 'weekly' as const,
+  //   priority: 0.7,
+  // }));
+  //
+  // return [...staticPages, ...postPages];
+
+  return staticPages;
+}

package/src/templates/shared/utils/web/lib/api-response.ts

@@ -0,0 +1,71 @@
+import { NextResponse } from 'next/server';
+import { classifyError, buildPagination } from '@digilogiclabs/platform-core/auth';
+
+/**
+ * Standardized API response helpers.
+ *
+ * Provides consistent response shapes across all API routes.
+ * Uses classifyError from platform-core for structured error handling.
+ */
+
+/** Success response with optional status code */
+export function successResponse<T>(data: T, status = 200) {
+  return NextResponse.json({ success: true, data }, { status });
+}
+
+/** Success response with a message */
+export function successWithMessage<T>(data: T, message: string, status = 200) {
+  return NextResponse.json({ success: true, message, data }, { status });
+}
+
+/** 201 Created response */
+export function createdResponse<T>(data: T, message = 'Created successfully') {
+  return NextResponse.json({ success: true, message, data }, { status: 201 });
+}
+
+/** 204 No Content response */
+export function noContentResponse() {
+  return new NextResponse(null, { status: 204 });
+}
+
+/** 202 Accepted response (for async operations) */
+export function acceptedResponse<T>(data: T, message = 'Request accepted') {
+  return NextResponse.json({ success: true, message, data }, { status: 202 });
+}
+
+/** Error response with status code */
+export function errorResponse(message: string, status = 500, code?: string) {
+  return NextResponse.json(
+    { success: false, error: { message, ...(code && { code }) } },
+    { status }
+  );
+}
+
+/** Paginated response with metadata */
+export function paginatedResponse<T>(data: T[], page: number, limit: number, total: number) {
+  return NextResponse.json({
+    success: true,
+    data,
+    pagination: buildPagination(page, limit, total),
+  });
+}
+
+/** Handle any error and return a structured response */
+export function handleApiError(error: unknown) {
+  const isDev = process.env.NODE_ENV === 'development';
+  const { status, body } = classifyError(error, isDev);
+  return NextResponse.json({ success: false, error: body }, { status });
+}
+
+/** Wrap a handler with automatic error handling */
+export function withErrorHandler(
+  handler: (request: Request) => Promise<NextResponse>
+): (request: Request) => Promise<NextResponse> {
+  return async (request: Request) => {
+    try {
+      return await handler(request);
+    } catch (error) {
+      return handleApiError(error);
+    }
+  };
+}

package/src/templates/shared/utils/web/lib/utils.ts

@@ -0,0 +1,85 @@
+import { type ClassValue, clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+/** Merge Tailwind classes with conflict resolution */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+
+/** Format currency with locale support */
+export function formatCurrency(amount: number, currency = 'USD', locale = 'en-US'): string {
+  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(amount);
+}
+
+/** Format date with locale support */
+export function formatDate(date: Date | string, options?: Intl.DateTimeFormatOptions): string {
+  const d = typeof date === 'string' ? new Date(date) : date;
+  return d.toLocaleDateString(
+    'en-US',
+    options || { year: 'numeric', month: 'long', day: 'numeric' }
+  );
+}
+
+/** Get relative time string (e.g., "2 hours ago", "in 3 days") */
+export function getRelativeTime(date: Date | string): string {
+  const d = typeof date === 'string' ? new Date(date) : date;
+  const now = new Date();
+  const diffMs = now.getTime() - d.getTime();
+  const diffSec = Math.floor(diffMs / 1000);
+  const diffMin = Math.floor(diffSec / 60);
+  const diffHour = Math.floor(diffMin / 60);
+  const diffDay = Math.floor(diffHour / 24);
+
+  if (diffSec < 60) return 'just now';
+  if (diffMin < 60) return `${diffMin}m ago`;
+  if (diffHour < 24) return `${diffHour}h ago`;
+  if (diffDay < 7) return `${diffDay}d ago`;
+  if (diffDay < 30) return `${Math.floor(diffDay / 7)}w ago`;
+  return formatDate(d, {
+    month: 'short',
+    day: 'numeric',
+    year: diffDay > 365 ? 'numeric' : undefined,
+  });
+}
+
+/** Truncate text with ellipsis */
+export function truncate(text: string, maxLength: number): string {
+  if (text.length <= maxLength) return text;
+  return text.slice(0, maxLength).trimEnd() + '...';
+}
+
+/** Get initials from a name (e.g., "John Doe" → "JD") */
+export function getInitials(name: string, maxChars = 2): string {
+  return name
+    .split(' ')
+    .filter(Boolean)
+    .map((part) => part[0]?.toUpperCase() || '')
+    .slice(0, maxChars)
+    .join('');
+}
+
+/** Debounce a function */
+export function debounce<T extends (...args: unknown[]) => unknown>(
+  fn: T,
+  delayMs: number
+): (...args: Parameters<T>) => void {
+  let timer: ReturnType<typeof setTimeout>;
+  return (...args: Parameters<T>) => {
+    clearTimeout(timer);
+    timer = setTimeout(() => fn(...args), delayMs);
+  };
+}
+
+/** Sleep for a given number of milliseconds */
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/** Safely parse JSON, returning null on failure */
+export function safeJsonParse<T = unknown>(json: string): T | null {
+  try {
+    return JSON.parse(json) as T;
+  } catch {
+    return null;
+  }
+}

package/src/templates/web/ai-platform/template/.env.example

@@ -0,0 +1,16 @@
+# Supabase Configuration
+NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+
+# AI Provider API Keys
+OPENAI_API_KEY=sk-xxx
+ANTHROPIC_API_KEY=sk-ant-xxx
+
+# Stripe Configuration
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_xxx
+STRIPE_SECRET_KEY=sk_test_xxx
+STRIPE_WEBHOOK_SECRET=whsec_xxx
+
+# Application
+NEXT_PUBLIC_APP_URL=http://localhost:3000

package/src/templates/web/ai-platform/template/README.md

@@ -0,0 +1,84 @@
+# {{titleCaseName}}
+
+{{description}} - An AI-powered platform for building intelligent applications.
+
+## Features
+
+- **AI Chat** - Conversational AI with multiple model support
+- **Model Selection** - Choose from GPT-4o, Claude, and more
+- **API Access** - Programmatic access to AI models
+- **Usage Dashboard** - Track API calls and token usage
+- **Subscription Billing** - Stripe-powered payments
+
+## Quick Start
+
+1. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+2. **Set up environment variables:**
+   ```bash
+   cp .env.example .env.local
+   ```
+   Update with your API keys:
+   - Supabase credentials
+   - OpenAI and/or Anthropic API keys
+   - Stripe keys (optional)
+
+3. **Run the development server:**
+   ```bash
+   npm run dev
+   ```
+
+4. **Open [http://localhost:3000](http://localhost:3000)**
+
+## Tech Stack
+
+- **Framework:** Next.js 15
+- **Language:** TypeScript
+- **Styling:** Tailwind CSS
+- **Auth:** Supabase
+- **AI:** Vercel AI SDK
+- **Payments:** Stripe
+- **UI Components:** @digilogiclabs/saas-factory-ui
+
+## Project Structure
+
+```
+src/
+├── app/                 # Next.js App Router pages
+│   ├── api/chat/        # Chat API route
+│   ├── chat/            # AI chat interface
+│   ├── dashboard/       # User dashboard
+│   └── playground/      # AI playground
+├── components/          # React components
+│   ├── ai/              # AI-specific components
+│   └── providers/       # Context providers
+└── lib/                 # Utilities and helpers
+    └── ai/              # AI utilities
+```
+
+## Adding AI Providers
+
+To enable AI functionality, add your API keys to `.env.local`:
+
+```bash
+# OpenAI
+OPENAI_API_KEY=sk-xxx
+
+# Anthropic
+ANTHROPIC_API_KEY=sk-ant-xxx
+```
+
+Then update `src/app/api/chat/route.ts` to use the AI SDK.
+
+## Deployment
+
+Deploy to Vercel with one click:
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new)
+
+## License
+
+MIT - Built with DLL Platform

package/src/templates/web/ai-platform/template/middleware.ts

@@ -0,0 +1,55 @@
+import { createServerClient } from '@supabase/ssr'
+import { NextResponse, type NextRequest } from 'next/server'
+
+export async function middleware(request: NextRequest) {
+  let supabaseResponse = NextResponse.next({
+    request,
+  })
+
+  const supabase = createServerClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+    {
+      cookies: {
+        getAll() {
+          return request.cookies.getAll()
+        },
+        setAll(cookiesToSet) {
+          cookiesToSet.forEach(({ name, value }) =>
+            request.cookies.set(name, value)
+          )
+          supabaseResponse = NextResponse.next({
+            request,
+          })
+          cookiesToSet.forEach(({ name, value, options }) =>
+            supabaseResponse.cookies.set(name, value, options)
+          )
+        },
+      },
+    }
+  )
+
+  const {
+    data: { user },
+  } = await supabase.auth.getUser()
+
+  // Redirect to login if accessing protected route without auth
+  if (
+    !user &&
+    (request.nextUrl.pathname.startsWith('/dashboard') ||
+     request.nextUrl.pathname.startsWith('/chat') ||
+     request.nextUrl.pathname.startsWith('/playground'))
+  ) {
+    const url = request.nextUrl.clone()
+    url.pathname = '/login'
+    return NextResponse.redirect(url)
+  }
+
+  return supabaseResponse
+}
+
+export const config = {
+  matcher: [
+    '/((?!_next/static|_next/image|favicon.ico|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)',
+  ],
+}

package/src/templates/web/ai-platform/template/next.config.js

@@ -0,0 +1,14 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  images: {
+    remotePatterns: [
+      {
+        protocol: 'https',
+        hostname: '**.supabase.co',
+      },
+    ],
+  },
+}
+
+module.exports = nextConfig

package/src/templates/web/ai-platform/template/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "{{packageName}}",
+  "version": "0.1.0",
+  "description": "{{description}} - AI Platform",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "type-check": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "dependencies": {
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@digilogiclabs/platform-core": "^1.1.0",
+    "@digilogiclabs/app-sdk": "^1.0.0",
+    "@digilogiclabs/saas-factory-auth": "^1.0.7",
+    "@digilogiclabs/saas-factory-payments": "^1.2.9",
+    "@digilogiclabs/saas-factory-ai": "^1.0.0",
+    "@digilogiclabs/saas-factory-ui": "^1.0.1",
+    "ai": "^3.4.0",
+    "@ai-sdk/openai": "^0.0.70",
+    "@ai-sdk/anthropic": "^0.0.57",
+    "stripe": "^16.12.0",
+    "@stripe/react-stripe-js": "^2.8.0",
+    "@stripe/stripe-js": "^4.10.0",
+    "tailwindcss": "^4.0.0",
+    "clsx": "^2.0.0",
+    "class-variance-authority": "^0.7.0",
+    "tailwind-merge": "^2.0.0",
+    "next-themes": "^0.4.0",
+    "lucide-react": "^0.460.0",
+    "zod": "^3.22.4",
+    "zustand": "^4.5.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-next": "^15.0.0",
+    "prettier": "^3.4.0",
+    "vitest": "^2.1.0",
+    "@testing-library/react": "^16.0.0",
+    "@testing-library/jest-dom": "^6.6.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/src/templates/web/ai-platform/template/src/app/api/chat/route.ts

@@ -0,0 +1,54 @@
+import { NextRequest, NextResponse } from 'next/server'
+
+// Note: In production, you would use the AI SDK here
+// import { openai } from '@ai-sdk/openai'
+// import { generateText } from 'ai'
+
+export async function POST(request: NextRequest) {
+  try {
+    const { messages, model } = await request.json()
+
+    // Demo response - replace with actual AI SDK integration
+    // In production:
+    // const { text } = await generateText({
+    //   model: openai(model),
+    //   messages,
+    // })
+
+    // Simulated response for demo
+    const lastMessage = messages[messages.length - 1]?.content || ''
+
+    // Simple demo responses
+    let response = "I'm an AI assistant. How can I help you today?"
+
+    if (lastMessage.toLowerCase().includes('hello') || lastMessage.toLowerCase().includes('hi')) {
+      response = "Hello! I'm your AI assistant. I can help you with coding, writing, analysis, and much more. What would you like to explore today?"
+    } else if (lastMessage.toLowerCase().includes('code') || lastMessage.toLowerCase().includes('python')) {
+      response = `Here's a simple Python example:
+
+\`\`\`python
+def greet(name: str) -> str:
+    """Return a greeting message."""
+    return f"Hello, {name}! Welcome to AI Platform."
+
+# Usage
+print(greet("Developer"))
+\`\`\`
+
+Would you like me to explain this code or help with something more specific?`
+    } else if (lastMessage.toLowerCase().includes('explain')) {
+      response = "I'd be happy to explain! Could you provide more details about what concept or topic you'd like me to clarify?"
+    }
+
+    return NextResponse.json({
+      content: response,
+      model,
+    })
+  } catch (error) {
+    console.error('Chat API error:', error)
+    return NextResponse.json(
+      { error: 'Failed to process request' },
+      { status: 500 }
+    )
+  }
+}