@digilogiclabs/create-saas-app 1.0.1

package/dist/templates/web/base/template/src/lib/env.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod'
+
+const envSchema = z.object({
+  // Next.js environment
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  
+  // Supabase Configuration (if needed for custom auth)
+  NEXT_PUBLIC_SUPABASE_URL: z.string().url().optional(),
+  NEXT_PUBLIC_SUPABASE_ANON_KEY: z.string().optional(),
+  SUPABASE_SERVICE_ROLE_KEY: z.string().optional(),
+  
+  // Stripe Configuration (from @digilogiclabs/saas-factory-payments)
+  NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: z.string().optional(),
+  STRIPE_SECRET_KEY: z.string().optional(),
+  STRIPE_WEBHOOK_SECRET: z.string().optional(),
+  
+  // App Configuration
+  NEXT_PUBLIC_APP_URL: z.string().url().default('http://localhost:3000'),
+  
+  // Database (if using custom database)
+  DATABASE_URL: z.string().optional(),
+})
+
+export type Env = z.infer<typeof envSchema>
+
+const parsedEnv = envSchema.safeParse(process.env)
+
+if (!parsedEnv.success) {
+  console.error('❌ Invalid environment variables:', parsedEnv.error.format())
+  throw new Error('Invalid environment variables')
+}
+
+export const env = parsedEnv.data
+
+// Export for easier access in server components
+export const {
+  NODE_ENV,
+  NEXT_PUBLIC_SUPABASE_URL,
+  NEXT_PUBLIC_SUPABASE_ANON_KEY,
+  SUPABASE_SERVICE_ROLE_KEY,
+  NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY,
+  STRIPE_SECRET_KEY,
+  STRIPE_WEBHOOK_SECRET,
+  NEXT_PUBLIC_APP_URL,
+  DATABASE_URL,
+} = env

package/dist/templates/web/base/template/src/lib/platform.ts

@@ -0,0 +1,146 @@
+/**
+ * Platform Core Integration
+ *
+ * This file sets up the @digilogiclabs/platform-core integration for
+ * unified infrastructure services across your application.
+ *
+ * Platform-core provides:
+ * - Database abstraction (Supabase, PostgreSQL)
+ * - Cache abstraction (Redis, Upstash, Memory)
+ * - Storage abstraction (S3, MinIO, R2)
+ * - Email abstraction (Resend, SMTP)
+ * - Queue abstraction (BullMQ)
+ * - Logging and Metrics
+ * - Resilience patterns (retry, circuit breaker, timeout)
+ */
+
+import { createPlatform, createPlatformAsync, type IPlatform } from '@digilogiclabs/platform-core';
+import { setPlatform as setAuthPlatform } from '@digilogiclabs/saas-factory-auth';
+import { setPlatform as setPaymentsPlatform } from '@digilogiclabs/saas-factory-payments';
+
+// Singleton platform instance
+let platformInstance: IPlatform | null = null;
+
+/**
+ * Get the platform instance (creates a new one if needed)
+ *
+ * For testing or development without external services,
+ * this uses in-memory adapters.
+ *
+ * @example
+ * ```ts
+ * const platform = getPlatform();
+ * await platform.cache.set('key', 'value', 3600);
+ * ```
+ */
+export function getPlatform(): IPlatform {
+  if (!platformInstance) {
+    platformInstance = createPlatform();
+    initializePackageIntegrations(platformInstance);
+  }
+  return platformInstance;
+}
+
+/**
+ * Initialize platform with production adapters (async)
+ *
+ * Call this once at application startup to configure
+ * production services based on environment variables.
+ *
+ * @example
+ * ```ts
+ * // In app/layout.tsx or a server initialization file
+ * await initializePlatform();
+ * ```
+ */
+export async function initializePlatform(): Promise<IPlatform> {
+  if (platformInstance) {
+    return platformInstance;
+  }
+
+  // Use createPlatformAsync for production adapters
+  // Falls back to memory adapters if env vars are not set
+  platformInstance = await createPlatformAsync();
+  initializePackageIntegrations(platformInstance);
+
+  return platformInstance;
+}
+
+/**
+ * Initialize package integrations with platform services
+ */
+function initializePackageIntegrations(platform: IPlatform): void {
+  // Connect saas-factory-auth to platform-core
+  // Enables: logging, metrics, and email for auth events
+  setAuthPlatform({
+    email: platform.email,
+    logger: platform.logger,
+    metrics: platform.metrics,
+  });
+
+  // Connect saas-factory-payments to platform-core
+  // Enables: logging, metrics, and caching for payment events
+  setPaymentsPlatform({
+    logger: platform.logger,
+    metrics: platform.metrics,
+    cache: platform.cache,
+  });
+}
+
+/**
+ * Reset platform instance (useful for testing)
+ */
+export function resetPlatform(): void {
+  platformInstance = null;
+}
+
+/**
+ * Example: Using platform services
+ *
+ * Database:
+ * ```ts
+ * const users = await platform.db
+ *   .from('users')
+ *   .where('active', '=', true)
+ *   .execute();
+ * ```
+ *
+ * Cache:
+ * ```ts
+ * await platform.cache.set('user:123', userData, 3600);
+ * const cached = await platform.cache.get<User>('user:123');
+ * ```
+ *
+ * Storage:
+ * ```ts
+ * await platform.storage.upload('avatars/user-123.png', buffer, {
+ *   contentType: 'image/png',
+ *   public: true,
+ * });
+ * ```
+ *
+ * Email:
+ * ```ts
+ * await platform.email.send({
+ *   to: { email: 'user@example.com', name: 'John' },
+ *   subject: 'Welcome!',
+ *   html: '<h1>Welcome to {{titleCaseName}}</h1>',
+ * });
+ * ```
+ *
+ * Queue:
+ * ```ts
+ * await platform.queue.add('sendWelcomeEmail', { userId: '123' });
+ * ```
+ *
+ * Logging:
+ * ```ts
+ * platform.logger.info('User signed up', { userId: '123' });
+ * ```
+ *
+ * Metrics:
+ * ```ts
+ * platform.metrics.increment('user.signup');
+ * platform.metrics.timing('api.response_time', 150);
+ * ```
+ */

package/dist/templates/web/base/template/src/lib/utils.ts

@@ -0,0 +1,140 @@
+/**
+ * Enhanced utility functions for {{titleCaseName}}
+ * 
+ * This extends the basic utils with additional functionality while
+ * maintaining compatibility with existing templates.
+ */
+
+import { type ClassValue, clsx } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+// Core utility function (keeps existing functionality)
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}
+
+// Additional utilities for enhanced templates
+
+/**
+ * Format currency with proper locale support
+ */
+export function formatCurrency(
+  amount: number,
+  currency: string = 'USD',
+  locale: string = 'en-US'
+): string {
+  return new Intl.NumberFormat(locale, {
+    style: 'currency',
+    currency,
+  }).format(amount)
+}
+
+/**
+ * Format date with relative time support
+ */
+export function formatDate(
+  date: Date | string,
+  options?: Intl.DateTimeFormatOptions
+): string {
+  const dateObj = typeof date === 'string' ? new Date(date) : date
+  
+  const defaultOptions: Intl.DateTimeFormatOptions = {
+    year: 'numeric',
+    month: 'short',
+    day: 'numeric',
+  }
+  
+  return new Intl.DateTimeFormat('en-US', options || defaultOptions).format(dateObj)
+}
+
+/**
+ * Get relative time string (e.g., "2 hours ago")
+ */
+export function getRelativeTime(date: Date | string): string {
+  const dateObj = typeof date === 'string' ? new Date(date) : date
+  const now = new Date()
+  const diffInMs = now.getTime() - dateObj.getTime()
+  const diffInSeconds = Math.floor(diffInMs / 1000)
+  const diffInMinutes = Math.floor(diffInSeconds / 60)
+  const diffInHours = Math.floor(diffInMinutes / 60)
+  const diffInDays = Math.floor(diffInHours / 24)
+
+  if (diffInSeconds < 60) return 'just now'
+  if (diffInMinutes < 60) return `${diffInMinutes} minute${diffInMinutes > 1 ? 's' : ''} ago`
+  if (diffInHours < 24) return `${diffInHours} hour${diffInHours > 1 ? 's' : ''} ago`
+  if (diffInDays < 7) return `${diffInDays} day${diffInDays > 1 ? 's' : ''} ago`
+  
+  return formatDate(dateObj)
+}
+
+/**
+ * Truncate text to specified length with ellipsis
+ */
+export function truncate(text: string, length: number = 50): string {
+  if (text.length <= length) return text
+  return text.slice(0, length).trim() + '...'
+}
+
+/**
+ * Generate initials from a name
+ */
+export function getInitials(name: string): string {
+  return name
+    .split(' ')
+    .map(word => word.charAt(0).toUpperCase())
+    .slice(0, 2)
+    .join('')
+}
+
+/**
+ * Validate email format
+ */
+export function isValidEmail(email: string): boolean {
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+  return emailRegex.test(email)
+}
+
+/**
+ * Generate a random ID
+ */
+export function generateId(prefix: string = ''): string {
+  const timestamp = Date.now().toString(36)
+  const randomString = Math.random().toString(36).substring(2)
+  return prefix ? `${prefix}-${timestamp}-${randomString}` : `${timestamp}-${randomString}`
+}
+
+/**
+ * Debounce function
+ */
+export function debounce<T extends (...args: any[]) => any>(
+  func: T,
+  delay: number
+): (...args: Parameters<T>) => void {
+  let timeoutId: NodeJS.Timeout | null = null
+  
+  return (...args: Parameters<T>) => {
+    if (timeoutId !== null) {
+      clearTimeout(timeoutId)
+    }
+    timeoutId = setTimeout(() => func(...args), delay)
+  }
+}
+
+/**
+ * Sleep/delay function for async operations
+ */
+export function sleep(ms: number): Promise<void> {
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+/**
+ * Safe JSON parse with fallback
+ */
+export function safeJsonParse<T>(json: string, fallback: T): T {
+  try {
+    return JSON.parse(json)
+  } catch {
+    return fallback
+  }
+}
+

package/dist/templates/web/base/template/src/test/setup.ts

@@ -0,0 +1,79 @@
+import '@testing-library/jest-dom'
+import { vi, beforeEach, afterAll } from 'vitest'
+
+// Mock Next.js router
+vi.mock('next/navigation', () => ({
+  useRouter: () => ({
+    push: vi.fn(),
+    back: vi.fn(),
+    forward: vi.fn(),
+    refresh: vi.fn(),
+    replace: vi.fn(),
+    prefetch: vi.fn(),
+  }),
+  useSearchParams: () => new URLSearchParams(),
+  usePathname: () => '/',
+}))
+
+// Mock SaaS Factory Auth (optional - only if testing auth components)
+vi.mock('@digilogiclabs/saas-factory-auth', () => ({
+  useAuth: () => ({
+    user: null,
+    loading: false,
+    error: null,
+    signIn: vi.fn(),
+    signUp: vi.fn(),
+    signOut: vi.fn(),
+    signInWithOAuth: vi.fn(),
+  }),
+  AuthProvider: ({ children }: { children: React.ReactNode }) => children,
+}))
+
+// Mock SaaS Factory Payments (optional - only if testing payment components)
+vi.mock('@digilogiclabs/saas-factory-payments', () => ({
+  usePayments: () => ({
+    createCheckoutSession: vi.fn(),
+    createPortalSession: vi.fn(),
+    subscription: null,
+    loading: false,
+  }),
+  PaymentsProvider: ({ children }: { children: React.ReactNode }) => children,
+}))
+
+// Global test utilities
+global.ResizeObserver = vi.fn().mockImplementation(() => ({
+  observe: vi.fn(),
+  unobserve: vi.fn(),
+  disconnect: vi.fn(),
+}))
+
+// Suppress console warnings in tests unless needed
+const originalConsoleError = console.error
+const originalConsoleWarn = console.warn
+
+beforeEach(() => {
+  console.error = (...args: any[]) => {
+    if (
+      typeof args[0] === 'string' &&
+      args[0].includes('Warning: ReactDOM.render is no longer supported')
+    ) {
+      return
+    }
+    originalConsoleError.call(console, ...args)
+  }
+
+  console.warn = (...args: any[]) => {
+    if (
+      typeof args[0] === 'string' &&
+      args[0].includes('useLayoutEffect does nothing on the server')
+    ) {
+      return
+    }
+    originalConsoleWarn.call(console, ...args)
+  }
+})
+
+afterAll(() => {
+  console.error = originalConsoleError
+  console.warn = originalConsoleWarn
+})

package/dist/templates/web/base/template/tailwind.config.js

@@ -0,0 +1,77 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  darkMode: ["class"],
+  content: [
+    './pages/**/*.{ts,tsx}',
+    './components/**/*.{ts,tsx}',
+    './app/**/*.{ts,tsx}',
+    './src/**/*.{ts,tsx}',
+    '../../node_modules/@digilogiclabs/saas-factory-ui/dist/**/*.{js,ts,jsx,tsx}',
+  ],
+  theme: {
+    container: {
+      center: true,
+      padding: "2rem",
+      screens: {
+        "2xl": "1400px",
+      },
+    },
+    extend: {
+      colors: {
+        border: "hsl(var(--border))",
+        input: "hsl(var(--input))",
+        ring: "hsl(var(--ring))",
+        background: "hsl(var(--background))",
+        foreground: "hsl(var(--foreground))",
+        primary: {
+          DEFAULT: "hsl(var(--primary))",
+          foreground: "hsl(var(--primary-foreground))",
+        },
+        secondary: {
+          DEFAULT: "hsl(var(--secondary))",
+          foreground: "hsl(var(--secondary-foreground))",
+        },
+        destructive: {
+          DEFAULT: "hsl(var(--destructive))",
+          foreground: "hsl(var(--destructive-foreground))",
+        },
+        muted: {
+          DEFAULT: "hsl(var(--muted))",
+          foreground: "hsl(var(--muted-foreground))",
+        },
+        accent: {
+          DEFAULT: "hsl(var(--accent))",
+          foreground: "hsl(var(--accent-foreground))",
+        },
+        popover: {
+          DEFAULT: "hsl(var(--popover))",
+          foreground: "hsl(var(--popover-foreground))",
+        },
+        card: {
+          DEFAULT: "hsl(var(--card))",
+          foreground: "hsl(var(--card-foreground))",
+        },
+      },
+      borderRadius: {
+        lg: "var(--radius)",
+        md: "calc(var(--radius) - 2px)",
+        sm: "calc(var(--radius) - 4px)",
+      },
+      keyframes: {
+        "accordion-down": {
+          from: { height: 0 },
+          to: { height: "var(--radix-accordion-content-height)" },
+        },
+        "accordion-up": {
+          from: { height: "var(--radix-accordion-content-height)" },
+          to: { height: 0 },
+        },
+      },
+      animation: {
+        "accordion-down": "accordion-down 0.2s ease-out",
+        "accordion-up": "accordion-up 0.2s ease-out",
+      },
+    },
+  },
+  plugins: [require("tailwindcss-animate")],
+}

package/dist/templates/web/base/template/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": ["dom", "dom.iterable", "es6"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@/components/*": ["./src/components/*"],
+      "@/lib/*": ["./src/lib/*"],
+      "@/hooks/*": ["./src/hooks/*"],
+      "@/types/*": ["./src/types/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}
+

package/dist/templates/web/base/template/vitest.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vitest/config'
+import react from '@vitejs/plugin-react'
+import path from 'path'
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    environment: 'jsdom',
+    setupFiles: ['./src/test/setup.ts'],
+    globals: true,
+  },
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+})

package/dist/templates/web/base/template.backup/.env.example

@@ -0,0 +1,15 @@
+# Auth Configuration
+NEXT_PUBLIC_AUTH_PROVIDER=supabase|firebase
+
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
+
+# Firebase
+NEXT_PUBLIC_FIREBASE_API_KEY=
+NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
+NEXT_PUBLIC_FIREBASE_PROJECT_ID=
+
+# Payments
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
+STRIPE_SECRET_KEY=

package/dist/templates/web/base/template.backup.20250817/.env.example

@@ -0,0 +1,15 @@
+# Auth Configuration
+NEXT_PUBLIC_AUTH_PROVIDER=supabase|firebase
+
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
+
+# Firebase
+NEXT_PUBLIC_FIREBASE_API_KEY=
+NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
+NEXT_PUBLIC_FIREBASE_PROJECT_ID=
+
+# Payments
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
+STRIPE_SECRET_KEY=

package/dist/templates/web/ui-auth/template/.claude

@@ -0,0 +1,21 @@
+{
+  "name": "{{projectName}}",
+  "description": "{{description}} - Authentication Platform built with Digi Logic Labs packages",
+  "include": [
+    "src/**/*",
+    "*.md",
+    "*.json",
+    "*.js",
+    "*.ts",
+    ".env.example"
+  ],
+  "exclude": [
+    "node_modules/**/*",
+    ".next/**/*",
+    "dist/**/*",
+    "build/**/*",
+    "*.log",
+    ".claude"
+  ],
+  "instructions": "You are helping develop an Authentication Platform using Next.js 15, TypeScript, and Digi Logic Labs packages.\n\n## Project Architecture\n- **Framework**: Next.js 15.3 with App Router\n- **Database**: Supabase (PostgreSQL with real-time features)\n- **Styling**: Tailwind CSS v4 with glassmorphism design system\n- **Authentication**: Supabase Auth with @digilogiclabs/saas-factory-auth\n\n## Key Packages\n- **@digilogiclabs/saas-factory-auth**: Authentication components and hooks with Supabase integration\n- **@digilogiclabs/saas-factory-ui**: Modern UI components with glassmorphism and responsive design\n\n## Development Guidelines\n1. Follow Next.js 15 best practices with Server Components by default\n2. Use TypeScript strictly - all components should be typed\n3. Implement proper error boundaries and loading states\n4. Follow the glassmorphism design system from saas-factory-ui\n5. Use Server Actions for mutations and API routes for complex logic\n6. Always check authentication state with useAuth hook\n\n## File Organization\n- Components in /src/components with feature-based folders\n- Server actions in /src/server/actions\n- API routes in /src/app/api\n- Database queries in /src/server/queries\n- Types in /src/types\n\n## Testing\n- Use Vitest for unit tests\n- Test business logic and error states\n- Mock external services (Supabase)\n\nRemember to consult the context.md file for detailed package documentation and examples."
+}

package/dist/templates/web/ui-auth/template/.env.example

@@ -0,0 +1,15 @@
+# Auth Configuration
+NEXT_PUBLIC_AUTH_PROVIDER=supabase|firebase
+
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
+
+# Firebase
+NEXT_PUBLIC_FIREBASE_API_KEY=
+NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
+NEXT_PUBLIC_FIREBASE_PROJECT_ID=
+
+# Payments
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
+STRIPE_SECRET_KEY=

package/dist/templates/web/ui-auth/template/.eslintrc.js

@@ -0,0 +1,8 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  extends: ['next/core-web-vitals'],
+  rules: {
+    // Add any custom rules here
+  },
+}
+

package/dist/templates/web/ui-auth/template/README.md

@@ -0,0 +1,68 @@
+# {{titleCaseName}}
+
+{{description}}
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+## Features
+
+- ⚡ **Next.js 14** - React framework with App Router
+- 🎨 **Tailwind CSS** - Utility-first CSS framework
+- 🔒 **{{#auth}}{{#firebase}}Firebase{{/firebase}}{{#supabase}}Supabase{{/supabase}}{{/auth}} Auth** - Authentication ready
+- 📱 **Responsive Design** - Mobile-first approach
+- 🌙 **Dark Mode** - Built-in theme switching
+- 📦 **TypeScript** - Type-safe development
+- 🎯 **ESLint & Prettier** - Code quality tools
+
+## Project Structure
+
+```
+src/
+├── app/                 # Next.js App Router
+│   ├── globals.css     # Global styles
+│   ├── layout.tsx      # Root layout
+│   └── page.tsx        # Home page
+├── components/         # React components
+│   ├── ui/            # UI components
+│   └── providers/     # Context providers
+├── lib/               # Utility functions
+├── hooks/             # Custom React hooks
+└── types/             # TypeScript definitions
+```
+
+## Environment Variables
+
+Copy `.env.example` to `.env.local` and fill in your configuration:
+
+```bash
+cp .env.example .env.local
+```
+
+## Deployment
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new).
+
+Check out the [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
+
+## Learn More
+
+- [Next.js Documentation](https://nextjs.org/docs)
+- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
+- [{{#auth}}{{#firebase}}Firebase Documentation{{/firebase}}{{#supabase}}Supabase Documentation{{/supabase}}{{/auth}}]({{#auth}}{{#firebase}}https://firebase.google.com/docs{{/firebase}}{{#supabase}}https://supabase.com/docs{{/supabase}}{{/auth}})
+
+## Support
+
+For support, email support@digilogiclabs.com or join our Discord community.
+