@digilogiclabs/create-saas-app 2.0.0 → 2.2.0

package/README.md

@@ -1,891 +1,975 @@
-# @digilogiclabs/create-saas-app
-
-**Create production-ready SaaS applications with AI capabilities in seconds.** This CLI tool generates modern web applications with authentication, payments, AI integration, and AI-powered development workflows.
-
-[![npm version](https://badge.fury.io/js/%40digilogiclabs%2Fcreate-saas-app.svg)](https://badge.fury.io/js/%40digilogiclabs%2Fcreate-saas-app)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## ⚡ **Quick Start - High-Value Templates**
-
-Get started instantly with our most popular, production-ready templates:
-
-### **🎯 Recommended Templates**
-
-```bash
-# 💳 Complete SaaS Foundation (Payments + Auth)
-npx @digilogiclabs/create-saas-app create web ui-auth-payments my-saas-app
-
-# 🤖 AI-Powered SaaS Platform (Text, Audio, Video AI)
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-platform --with-ai=all
-
-# 🧠 AI Knowledge Base & RAG System (v4.0.0)
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai-rag knowledge-app --with-ai=rag
-
-# 🎵 Audio Streaming SaaS (Music/Podcast Platform)
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform
-
-# 🎬 Video Streaming SaaS (Video Platform)
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio
-
-# 📱 Mobile AI SaaS (React Native + Expo)
-npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai mobile-ai-app --with-ai=all
-
-# 📱 Mobile RAG Knowledge App
-npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai-rag knowledge-mobile --with-ai=rag
-```
-
-## 🚀 Complete Template Reference
-
-### **Quick Command Reference**
-
-```bash
-# Interactive mode (recommended for beginners)
-npx @digilogiclabs/create-saas-app create
-
-# Direct command format
-npx @digilogiclabs/create-saas-app create <platform> <template> <project-name> [options]
-
-# Get help anytime
-npx @digilogiclabs/create-saas-app --help
-npx @digilogiclabs/create-saas-app create --help
-```
-
-### **📋 All Available Templates (16 Total)**
-
-#### **🌐 Web Templates (11)**
-
-**💎 Premium SaaS Templates**
-| Template | Description | Features | Command |
-|----------|-------------|----------|---------|
-| `ui-auth-payments` | **Complete SaaS Foundation** | Auth + Payments + Dashboard | `npx @digilogiclabs/create-saas-app create web ui-auth-payments my-saas` |
-| `ui-auth-payments-ai` | **AI-Powered SaaS Platform** | Full AI Suite (Text, Audio, Video) | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-platform --with-ai=all` |
-| `ui-auth-payments-ai-rag` | **🧠 AI Knowledge Base & RAG** | Smart Document Processing v4.0.0 | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai-rag knowledge-app --with-ai=rag` |
-| `ui-auth-payments-audio` | **🎵 Audio Streaming SaaS** | Music/Podcast Platform | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform` |
-| `ui-auth-payments-video` | **🎬 Video Streaming SaaS** | Video Platform & Studio | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio` |
-
-**🚀 Starter Templates**
-| Template | Description | Features | Command |
-|----------|-------------|----------|---------|
-| `base` | Clean Next.js 15 starter | Minimal setup | `npx @digilogiclabs/create-saas-app create web base my-app` |
-| `ui-only` | Component library showcase | Design system | `npx @digilogiclabs/create-saas-app create web ui-only design-system` |
-| `ui-auth` | Authentication flow | Auth + Dashboard | `npx @digilogiclabs/create-saas-app create web ui-auth auth-app` |
-| `ui-auth-ai` | Text & chat AI platform | Basic AI features | `npx @digilogiclabs/create-saas-app create web ui-auth-ai text-ai-app --with-ai=text` |
-| `ui-package-test` | Component testing env | Development testing | `npx @digilogiclabs/create-saas-app create web ui-package-test component-test` |
-
-#### **📱 Mobile Templates (5)**
-
-**💎 Premium Mobile SaaS**
-| Template | Description | Features | Command |
-|----------|-------------|----------|---------|
-| `ui-auth-payments` | **Full Mobile SaaS** | Auth + Payments + Native UI | `npx @digilogiclabs/create-saas-app create mobile ui-auth-payments mobile-saas` |
-| `ui-auth-payments-ai` | **📱 Mobile AI SaaS** | Native AI with Voice/Camera | `npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai ai-mobile-app --with-ai=all` |
-| `ui-auth-payments-ai-rag` | **📱 Mobile Knowledge App** | Offline RAG + Document Scanning | `npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai-rag knowledge-mobile --with-ai=rag` |
-
-**🚀 Mobile Starters**
-| Template | Description | Features | Command |
-|----------|-------------|----------|---------|
-| `base` | React Native + Expo starter | Minimal mobile setup | `npx @digilogiclabs/create-saas-app create mobile base mobile-app` |
-
-### **🤖 AI Capabilities Reference**
-
-**AI Template Options (`--with-ai`)**
-| Capability | Description | Includes | Best For |
-|------------|-------------|----------|----------|
-| `text` | Text generation & chat | OpenAI GPT, Claude, Gemini | Content creation, chatbots |
-| `audio` | Audio processing & generation | Speech-to-text, text-to-speech, music | Podcasts, music platforms |
-| `video` | Video processing & generation | Video editing, generation, streaming | Video platforms, content creation |
-| `rag` | **🧠 RAG Knowledge System v4.0.0** | Vector search, document processing, Q&A | Knowledge bases, AI assistants |
-| `all` | Complete AI suite | All above capabilities | Full AI platforms |
-
-**Available AI Providers (`--ai-provider`)**
-- `openai` (default) - GPT-4, DALL-E, Whisper
-- `anthropic` - Claude Sonnet/Haiku
-- `gemini` - Google Gemini Pro
-
-### **🛠 CLI Options**
-
-#### **Core Arguments**
-```bash
-<platform>       # web | mobile | both
-<template>       # Template name (see table above)
-<project-name>   # Your project name (kebab-case recommended)
-```
-
-#### **Configuration Flags**
-```bash
--a, --auth <provider>        # firebase | supabase (default: supabase)
--d, --database <provider>    # supabase | firebase (default: supabase)
--t, --theme <theme>          # default | corporate | startup (default: default)
--c, --theme-color <color>    # blue | green | purple | orange | red | slate (default: blue)
---default-theme <mode>       # light | dark | system (default: system)
---with-ai [capabilities]     # text | audio | video | text,audio | all (for AI templates)
---ai-provider <provider>     # openai | anthropic | gemini (default: openai)
---no-install                 # Skip package installation
---no-git                     # Skip git initialization
--y, --yes                    # Skip interactive prompts
-```
-
-### **💡 Real-World Examples**
-
-#### **🚀 Beginner: Interactive Mode**
-```bash
-# Let the CLI guide you through all options
-npx @digilogiclabs/create-saas-app create
-```
-
-#### **🎯 Business Use Cases**
-
-**💼 SaaS Startup**
-```bash
-# Complete SaaS foundation with payments
-npx @digilogiclabs/create-saas-app create web ui-auth-payments my-startup \
-  --theme=startup \
-  --theme-color=purple \
-  --auth=supabase \
-  --database=supabase
-```
-
-**🤖 AI Content Platform**
-```bash
-# Full AI platform with all capabilities
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai content-ai \
-  --with-ai=all \
-  --ai-provider=openai \
-  --theme=corporate \
-  --theme-color=blue
-```
-
-**🧠 Knowledge Base & AI Assistant**
-```bash
-# RAG-powered knowledge platform
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai-rag knowledge-base \
-  --with-ai=rag \
-  --ai-provider=anthropic \
-  --theme=startup \
-  --theme-color=green
-```
-
-**🎵 Music Streaming Platform**
-```bash
-# Audio streaming SaaS like Spotify
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-stream \
-  --theme=default \
-  --theme-color=orange \
-  --auth=supabase
-```
-
-**📱 Mobile-First AI App**
-```bash
-# Native mobile AI app with offline capabilities
-npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai mobile-ai \
-  --with-ai=all \
-  --theme=corporate \
-  --theme-color=blue \
-  --no-git
-
-# Cross-platform SaaS with Firebase
-npx @digilogiclabs/create-saas-app create both ui-auth-payments fullstack-saas \
-  --auth=firebase \
-  --database=firebase \
-  --theme=default \
-  --default-theme=dark
-
-# Quick prototyping (no deps install)
-npx @digilogiclabs/create-saas-app create web ui-auth-payments prototype \
-  --no-install \
-  --no-git \
-  --yes
-```
-
-### **🎯 Template Selection Guide**
-
-#### **Choose by Use Case**
-- **Learning/Prototyping**: `base` or `ui-only`
-- **Authentication App**: `ui-auth`
-- **SaaS with Billing**: `ui-auth-payments`
-- **AI Applications**: `ui-auth-payments-ai` or `ui-auth-ai`
-- **Media Platforms**: `ui-auth-payments-audio` or `ui-auth-payments-video`
-- **Mobile Apps**: Mobile versions of above
-- **Full-Stack**: `both` platform with any template
-
-#### **Choose by Complexity**
-1. **Simple**: `base`, `ui-only`
-2. **Medium**: `ui-auth`, `ui-auth-payments`
-3. **Advanced**: `ui-auth-payments-ai`, `ui-auth-payments-audio`, `ui-auth-payments-video`
-
-#### **Choose by Platform**
-- **Web Only**: Use `web` platform
-- **Mobile Only**: Use `mobile` platform  
-- **Universal**: Use `both` platform (web + mobile)
-
-## 🎉 What's New in v1.13.0
-
-### 🤖 **Complete AI Integration**
-- **Ready-to-Use Components** - AIChat, AITextGenerator, AIAudioGenerator, AIVideoGenerator now available
-- **Client-Side Configuration** - NEXT_PUBLIC_ environment variables for seamless setup
-- **Configuration Validation** - AISetupStatus component guides users through setup
-- **Enhanced TypeScript** - Complete type definitions and IntelliSense support
-
-### 🎨 **Enhanced UI Library** 
-- **6 New Components** - Switch, Slider, Textarea, Accordion, Breadcrumbs, EmptyState
-- **Fixed Glassmorphism API** - Proper `border` and `accent` properties now available
-- **Cross-Platform Ready** - Single codebase supports Next.js + React Native/Expo
-- **Node.js 18+ Support** - Broader compatibility for more environments
-
-### 🔐 **Expanded Authentication**
-- **12 OAuth Providers** - Added Microsoft, LinkedIn, Spotify, Twitch, Slack, Notion
-- **Enhanced User Types** - Comprehensive profiles with extended role system
-- **Beautiful Provider UI** - Proper branding and SVG icons for all providers
-
-### 💳 **Improved Payments**
-- **Enhanced Type System** - Better TypeScript definitions and error handling
-- **Future-Ready Foundation** - Prepared for PayPal, Apple Pay, and analytics features
-
-## 🚀 Quick Start
-
-```bash
-# Interactive mode (recommended)
-npx @digilogiclabs/create-saas-app create
-
-# Or create directly with popular templates
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-ai-saas --with-ai=all
-npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai mobile-ai-app --with-ai=all
-npx @digilogiclabs/create-saas-app create web ui-auth-payments saas-app
-```
-
-> 💡 **New to the CLI?** See the complete [Template Generator Guide](#-template-generator-guide) above for all options and examples.
-
-## ⚡ What You Get
-
-### 🤖 **AI-First Development**
-- **Claude CLI integration** - AI assistant configured for your specific template
-- **Template-aware context** - AI understands your packages and architecture
-- **Auto-generated documentation** - Context files and development guides
-- **AI-powered components** - Text, audio, and video generation ready to use
-
-### 🏗️ **Production-Ready Stack**
-- **Next.js 15.3** with App Router and Server Components
-- **TypeScript** throughout with strict typing
-- **Supabase** for database, auth, and real-time features  
-- **Stripe** for payments and subscriptions
-- **Tailwind CSS v4** with glassmorphism design system
-
-### 🎯 **Developer Experience**
-- **Setup guides** with copy-paste configurations
-- **Deployment guides** for Vercel, Netlify, Railway, and Docker
-- **Environment validation** and troubleshooting
-- **Package documentation** and code examples
-
-## 🎨 Template Gallery
-
-> 📋 **Quick Reference?** See the [Template Generator Guide](#-template-generator-guide) at the top for a complete table of all templates and commands.
-
-Choose from **12 production-ready templates** across web and mobile platforms:
-
-### 🌐 **Web Templates (9 Available)**
-
-#### **Core Templates**
-
-##### **Base Template** (`base`)
-Clean Next.js 15 starter with minimal dependencies
-- **Next.js 15.3** - App Router with Server Components
-- **TypeScript** - Strict typing throughout
-- **Tailwind CSS v4** - Modern utility-first styling
-- **Essential setup** - Perfect foundation for custom builds
-
-```bash
-npx @digilogiclabs/create-saas-app create web base my-app
-```
-
-##### **UI Only Template** (`ui-only`)
-Components library showcase without authentication
-- **Component gallery** - All @digilogiclabs/saas-factory-ui components
-- **Design system** - Glassmorphism and modern patterns
-- **No auth required** - Perfect for design system demos
-- **Storybook-style** - Interactive component documentation
-
-```bash
-npx @digilogiclabs/create-saas-app create web ui-only design-system
-```
-
-#### **Authentication Templates**
-
-##### **UI + Auth** (`ui-auth`)
-Modern authentication flow with beautiful UI
-- **User management** - Sign up, login, profile management
-- **12 OAuth providers** - Google, GitHub, Microsoft, LinkedIn, Spotify, and more
-- **Protected routes** - Authentication-gated content
-- **Email verification** - Secure account activation
-
-```bash
-npx @digilogiclabs/create-saas-app create web ui-auth auth-app
-```
-
-##### **UI + Auth + Payments** (`ui-auth-payments`)
-Complete SaaS foundation with billing
-- **Subscription management** - Stripe integration with webhooks
-- **User dashboards** - Account management and billing portal
-- **Team features** - Multi-user support and permissions
-- **Analytics** - Revenue and usage tracking
-
-```bash
-npx @digilogiclabs/create-saas-app create web ui-auth-payments saas-platform
-```
-
-#### **AI-Powered Templates**
-
-##### **AI + Auth** (`ui-auth-ai`)
-Text and chat AI integration platform
-- **Text generation** - OpenAI GPT-4 integration
-- **AI chat interface** - Interactive conversation UI
-- **Content management** - Save and organize AI outputs
-- **Usage tracking** - Monitor API consumption
-
-```bash
-npx @digilogiclabs/create-saas-app create web ui-auth-ai text-ai-app --with-ai=text
-```
-
-##### **AI + Auth + Payments** (`ui-auth-payments-ai`)
-Full AI SaaS platform with multi-modal generation
-- **Multi-modal AI** - Text, audio, and video generation
-- **AI Dashboard** - Generation history and usage analytics  
-- **Smart UI** - Tabbed interface for different AI tools
-- **Real-time features** - Live generation status and updates
-
-```bash
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-platform --with-ai=all
-```
-
-#### **Media Templates**
-
-##### **Audio SaaS** (`ui-auth-payments-audio`)
-Music streaming and audio processing platform
-- **Audio streaming** - Playlist management and playback
-- **Audio generation** - AI-powered voice synthesis
-- **Waveform visualization** - Real-time audio analysis
-- **Offline support** - Cached playback and PWA features
-
-```bash
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform
-```
-
-##### **Video SaaS** (`ui-auth-payments-video`)
-Video streaming and media platform
-- **Video streaming** - Quality selection and adaptive bitrate
-- **Video generation** - AI-powered video creation
-- **Content management** - Upload, process, and organize videos
-- **Analytics dashboard** - View counts and engagement metrics
-
-```bash
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio
-```
-
-#### **Development Templates**
-
-##### **UI Package Test** (`ui-package-test`)
-Component testing environment for package development
-- **Component testing** - Isolated testing environment
-- **Package validation** - Test UI components before release
-- **Development tools** - Hot reload and debugging setup
-- **Documentation** - Auto-generated component docs
-
-```bash
-npx @digilogiclabs/create-saas-app create web ui-package-test component-test
-```
-
-### 📱 **Mobile Templates (5 Available)**
-
-#### **Base Mobile** (`base`)
-React Native + Expo starter for mobile development
-- **Expo 50** - Modern React Native development platform
-- **TypeScript** - Full type safety for mobile
-- **Navigation** - React Navigation v6 setup
-- **Cross-platform** - iOS and Android support
-
-```bash
-npx @digilogiclabs/create-saas-app create mobile base mobile-app
-```
-
-#### **Mobile SaaS** (`ui-auth-payments`)
-Full mobile SaaS platform with native UI v0.27.0
-- **Native UI components** - 240+ components with enhanced mobile features
-- **Authentication** - Supabase Auth v1.0.4 with biometric support
-- **Payments** - Stripe React Native v0.28.0 integration
-- **Advanced features** - Onboarding, tours, offline support, haptic feedback
-- **Updated Dependencies** - Latest package versions for stability
-
-```bash
-npx @digilogiclabs/create-saas-app create mobile ui-auth-payments mobile-saas
-```
-
-#### **Mobile AI SaaS** (`ui-auth-payments-ai`)
-Complete mobile AI platform with generation capabilities
-- **AI Generation Suite** - Text, audio, and video AI generation
-- **Native AI Components** - AITextGenerator, AIAudioGenerator, AIVideoGenerator, AIChat
-- **AI Dashboard** - Usage statistics and generation history
-- **Multi-modal AI** - OpenAI, ElevenLabs, Replicate integration
-- **Mobile-optimized** - Touch-friendly AI interfaces with haptic feedback
-- **Offline AI Cache** - Cached responses for better mobile experience
-- **Enhanced TypeScript** - bundler moduleResolution for better compatibility
-
-```bash
-npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai ai-mobile-app --with-ai=all
-```
-
-#### **Mobile RAG Knowledge App** (`ui-auth-payments-ai-rag`)
-Advanced mobile knowledge base with RAG capabilities
-- **RAG Integration** - Vector search and document processing
-- **Offline RAG** - Local knowledge base for mobile-first experience
-- **Document Scanning** - Native camera integration for document capture
-- **Knowledge Management** - Organize and search through personal knowledge
-- **AI-Powered Q&A** - Intelligent question answering from documents
-- **Complete Mobile Setup** - All required config files and dependencies
-
-```bash
-npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai-rag knowledge-mobile --with-ai=rag
-```
-
-### 🚀 **Cross-Platform Templates**
-
-#### **Full Stack Platform** (`ui-auth-payments`)
-Web + Mobile SaaS platform
-- **Shared codebase** - Unified components and logic
-- **Web dashboard** - Full-featured admin interface
-- **Mobile app** - Native mobile experience
-- **Real-time sync** - Cross-platform data synchronization
-
-```bash
-npx @digilogiclabs/create-saas-app create both ui-auth-payments fullstack-platform
-```
-
-#### **AI Full Stack** (`ui-auth-payments-ai`)
-Web + Mobile AI platform
-- **AI everywhere** - Consistent AI features across platforms
-- **Mobile-optimized** - Touch-friendly AI interfaces
-- **Cloud sync** - AI generations sync across devices
-- **Offline capable** - Cached AI responses for mobile
-
-```bash
-npx @digilogiclabs/create-saas-app create both ui-auth-payments-ai ai-fullstack --with-ai=all
-```
-
-## 🤖 AI Development Workflow
-
-Every template includes **Claude AI integration** for enhanced development:
-
-### 🎯 **Instant AI Setup**
-```bash
-# Create your app
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-app --with-ai=all
-
-# Navigate to setup
-cd my-app && open http://localhost:3000/dev-setup
-
-# Copy .claude configuration (auto-generated)
-# Copy context.md documentation (auto-generated) 
-
-# Start coding with AI assistance
-claude "Help me add a new AI feature"
-claude "Create a user profile component"
-claude "Debug this authentication error"
-```
-
-### 📚 **Smart AI Context**
-Each template generates intelligent context for Claude:
-- **Package integration guides** - How to use each Digi Logic Labs package
-- **Architecture documentation** - Next.js patterns and best practices
-- **Code examples** - Common patterns for auth, payments, AI
-- **Environment setup** - Configuration and troubleshooting
-
-### ⚡ **AI-Powered Components** (v3.1.1)
-Templates with `--with-ai` include complete component library:
-```typescript
-import { 
-  AIProvider, 
-  AIChat, 
-  AITextGenerator, 
-  AIAudioGenerator, 
-  AIVideoGenerator,
-  AISetupStatus,
-  getAIConfigFromEnv 
-} from '@digilogiclabs/saas-factory-ai'
-
-function App() {
-  const config = getAIConfigFromEnv()
-
-  return (
-    <AIProvider config={config}>
-      {/* Configuration validation */}
-      <AISetupStatus />
-      
-      {/* Text generation */}
-      <AITextGenerator 
-        placeholder="Generate blog content..."
-        templates={['Blog post', 'Email', 'Social media']}
-        showWordCount={true}
-        maxLength={2000}
-      />
-
-      {/* AI chat interface */}
-      <AIChat
-        placeholder="Ask me anything..."
-        showTypingIndicator={true}
-        enableFileUpload={true}
-        maxMessages={50}
-      />
-
-      {/* Audio generation */}
-      <AIAudioGenerator
-        placeholder="Describe the audio..."
-        supportedFormats={['mp3', 'wav', 'ogg']}
-        showWaveform={true}
-        maxDuration={300}
-      />
-
-      {/* Video generation */}
-      <AIVideoGenerator
-        placeholder="Describe the video..."
-        supportedFormats={['mp4', 'webm']}
-        resolution="1080p"
-        showPreview={true}
-        maxDuration={60}
-      />
-    </AIProvider>
-  )
-}
-```
-
-## 🚀 Deployment Made Simple
-
-Every template includes **comprehensive deployment guides**:
-
-### 📋 **Multiple Hosting Options**
-
-#### **Vercel (Recommended)**
-```bash
-# One-command deployment
-vercel --prod
-
-# Automatic HTTPS, edge functions, preview deployments
-```
-
-#### **Netlify**
-```bash
-# Git-based deployment with form handling
-npm run build && netlify deploy --prod
-```
-
-#### **Railway**  
-```bash
-# Full-stack with integrated database
-railway init && railway up
-```
-
-#### **Docker + Cloud Run**
-```bash
-# Containerized deployment with auto-scaling
-gcloud run deploy --source .
-```
-
-### ✅ **Pre-Deployment Checklist**
-Built-in validation ensures your app is deployment-ready:
-- ✅ Environment variables configured
-- ✅ Database tables created and RLS enabled
-- ✅ Stripe webhooks configured (if using payments)
-- ✅ Build succeeds locally
-- ✅ Tests pass
-
-## 🎛️ Advanced Configuration
-
-### 🤖 **AI Capabilities**
-```bash
-# Enable specific AI capabilities
---with-ai=text                    # Text generation only
---with-ai=audio                   # Audio generation only  
---with-ai=video                   # Video generation only
---with-ai=text,audio              # Text and audio
---with-ai=all                     # All AI capabilities
-
-# Specify AI provider
---ai-provider=openai              # OpenAI (default)
---ai-provider=anthropic           # Anthropic Claude
---ai-provider=gemini              # Google Gemini
-```
-
-### 🎨 **Theming & Styling**
-```bash
-# Theme options
---theme=default                   # Clean and modern
---theme=corporate                 # Professional blue
---theme=startup                   # Bold purple
-
-# Theme colors
---theme-color=blue               # Blue accents (default)
---theme-color=purple             # Purple accents
---theme-color=green              # Green accents
-
-# Default theme mode
---default-theme=system           # Follow system (default)  
---default-theme=light            # Always light
---default-theme=dark             # Always dark
-```
-
-### 🔐 **Service Providers**
-```bash
-# Authentication
---auth=supabase                  # Supabase Auth (default)
---auth=firebase                  # Firebase Auth
-
-# Database  
---database=supabase              # Supabase (default)
---database=firebase              # Firebase Firestore
-```
-
-## 📦 Package Ecosystem
-
-### 🎨 **UI & Design** (v0.27.1)
-- **@digilogiclabs/saas-factory-ui** - 240+ components with mobile-first design
-- **75% Component Increase** - From 140+ to 240+ components in v0.22.0
-- **Cross-Platform Support** - Single codebase for Next.js + React Native/Expo
-- **Native Mobile Components** - AppShell, BottomTabBar, NativeTour, VirtualScrollList
-- **Advanced Features** - Haptic feedback, gesture support, offline capabilities
-- **Enhanced Glassmorphism** - Fixed API with proper `border` and `accent` properties
-- **Next.js 15.3** - App Router with Server Components  
-- **Tailwind CSS v4** - Design tokens and utility classes
-- **Node.js 18+ Support** - Broader compatibility range
-
-### 🔐 **Authentication** (v1.0.5)
-- **@digilogiclabs/saas-factory-auth** - Enhanced Supabase Auth integration
-- **12 OAuth Providers** - Google, GitHub, Microsoft, LinkedIn, Spotify, Twitch, Slack, Notion + more
-- **Enhanced TypeScript Types** - Comprehensive user profiles and metadata
-- **Beautiful UI Components** - Proper branding and SVG icons for all providers
-- **Extended User Roles** - owner, editor, viewer, contributor, manager, developer, analyst, support
-- **Row Level Security** - Database-level permissions
-- **Email verification** - Secure account management
-
-### 💳 **Payments** (v1.2.6)
-- **@digilogiclabs/saas-factory-payments** - Enhanced Stripe integration
-- **Improved Type System** - Better TypeScript definitions with cross-platform compatibility
-- **Enhanced Error Handling** - Expanded error types for comprehensive management
-- **Better Subscription Management** - Enhanced types with additional compatibility fields
-- **Future-Ready Architecture** - Foundation for PayPal, Apple Pay, and analytics
-- **Webhook handling** - Secure payment event processing
-- **Customer portal** - Self-service billing management
-
-### 🤖 **AI Platform** (v3.1.1)
-- **@digilogiclabs/saas-factory-ai** - Complete React component library
-- **Ready-to-Use Components** - AIChat, AITextGenerator, AIAudioGenerator, AIVideoGenerator, AIProvider
-- **@digilogiclabs/saas-factory-ai-types** - Complete TypeScript definitions
-- **Client-Side Configuration** - NEXT_PUBLIC_ environment variable support
-- **Configuration Validation** - AISetupStatus component and validateAIConfig() helper
-- **Environment Helpers** - getAIConfigFromEnv() for seamless setup
-- **OpenAI integration** - GPT-4 for text and audio
-- **ElevenLabs integration** - High-quality voice synthesis
-- **Replicate integration** - Video and image generation
-
-## 🛠️ Command Reference
-
-### 📋 **Create Command**
-```bash
-npx @digilogiclabs/create-saas-app create <platform> [template] [name] [options]
-
-# Arguments
-platform                         # web, mobile, or both
-template                          # ui-auth-payments-ai, ui-auth-payments, ui-auth, etc.
-name                              # your-project-name
-
-# Options  
--a, --auth <provider>            # firebase, supabase
--d, --database <provider>        # supabase, firebase  
--t, --theme <theme>              # default, corporate, startup
--c, --theme-color <color>        # blue, green, purple, orange, red, slate
---default-theme <mode>           # light, dark, system
---with-ai [capabilities]         # text,audio,video or all
---ai-provider <provider>         # openai, anthropic, gemini
---no-install                     # Skip package installation
---no-git                        # Skip git initialization
--y, --yes                       # Skip interactive prompts
-```
-
-### ➕ **Add Features** (Coming Soon)
-```bash
-# Add features to existing projects
-npx @digilogiclabs/create-saas-app add billing --provider=stripe
-npx @digilogiclabs/create-saas-app add analytics --provider=mixpanel
-npx @digilogiclabs/create-saas-app add ai --capabilities=text,audio
-```
-
-### 🔄 **Update Command** (Coming Soon)
-```bash
-# Check for package updates
-npx @digilogiclabs/create-saas-app update --check
-
-# Update all Digi Logic Labs packages
-npx @digilogiclabs/create-saas-app update
-```
-
-## 🌟 Examples
-
-### 🤖 **AI-Powered SaaS**
-```bash
-# Full AI platform with all capabilities
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai \
-  my-ai-platform \
-  --with-ai=all \
-  --ai-provider=openai \
-  --theme=startup \
-  --theme-color=purple
-```
-
-### 🎵 **Music Streaming Platform**  
-```bash
-# Audio platform with Supabase and corporate theme
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio \
-  music-streaming \
-  --auth=supabase \
-  --database=supabase \
-  --theme=corporate \
-  --theme-color=blue
-```
-
-### 🎬 **Video Creation Studio**
-```bash
-# Video platform with AI generation capabilities
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-video \
-  video-studio \
-  --with-ai=video \
-  --ai-provider=replicate \
-  --theme=startup \
-  --default-theme=dark
-```
-
-## 📚 Getting Started Guide
-
-### 1. **Create Your App**
-```bash
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-saas --with-ai=all
-cd my-saas
-```
-
-### 2. **Follow Setup Guide**
-```bash
-npm run dev
-# Open http://localhost:3000/setup
-# Configure Supabase, Stripe, and AI providers
-```
-
-### 3. **Set Up Development Workflow**
-```bash
-# Visit http://localhost:3000/dev-setup  
-# Copy .claude configuration
-# Copy context.md documentation
-# Install Claude CLI: npm install -g @anthropic-ai/claude-cli
-```
-
-### 4. **Start Building with AI**
-```bash
-claude "Help me add a user profile page"
-claude "Create a subscription management component"
-claude "Add error handling to the payment flow"
-```
-
-### 5. **Deploy to Production**
-```bash
-# Follow deployment guide at /dev-setup
-vercel --prod  # One-command deployment
-```
-
-## 🔧 Development
-
-### 📋 **Requirements**
-- **Node.js**: 18.0.0 or higher
-- **Package Manager**: npm, yarn, or pnpm
-- **Git**: For repository initialization
-
-### 🛠️ **Local Development**
-```bash
-# Clone repository
-git clone https://github.com/DigiLogicLabs/create-saas-app.git
-cd create-saas-app
-
-# Install dependencies  
-npm install
-
-# Build CLI
-npm run build
-
-# Test locally
-node bin/index.js create web ui-auth-payments-ai test-app --with-ai=all
-```
-
-## 🐛 Troubleshooting
-
-### ❓ **Common Issues**
-
-#### CLI Command Not Found
-```bash
-# Use npx (recommended)
-npx @digilogiclabs/create-saas-app
-
-# Or install globally
-npm install -g @digilogiclabs/create-saas-app
-```
-
-#### Template Generation Fails
-```bash
-# Check Node.js version (18.0.0+ required)
-node --version
-
-# Clear npm cache
-npm cache clean --force
-
-# Try with --no-install flag
-npx @digilogiclabs/create-saas-app create web ui-auth test-app --no-install
-```
-
-#### Environment Variables Issues
-```bash
-# Check setup guide in your app
-open http://localhost:3000/setup
-
-# Copy environment variables from setup page
-# Verify all required services are configured
-```
-
-#### AI Integration Issues  
-```bash
-# Verify AI API keys in .env.local
-OPENAI_API_KEY=your_openai_key
-ELEVENLABS_API_KEY=your_elevenlabs_key  
-REPLICATE_API_TOKEN=your_replicate_token
-
-# Check AI setup guide
-open http://localhost:3000/dev-setup
-```
-
-## 📄 License
-
-MIT © [Digi Logic Labs](https://digilogiclabs.com)
-
-## 🆘 Support & Community
-
-- 💬 **Discord**: [Join our community](https://discord.gg/digilogiclabs) 
-- 📖 **Documentation**: [docs.digilogiclabs.com](https://docs.digilogiclabs.com)
-- 🐛 **Issues**: [GitHub Issues](https://github.com/DigiLogicLabs/create-saas-app/issues)
-- 💡 **Feature Requests**: [GitHub Discussions](https://github.com/DigiLogicLabs/create-saas-app/discussions)
-- 📧 **Email**: support@digilogiclabs.com
-
-## 🚀 What's Next?
-
-- 📱 **Enhanced Mobile Templates** - Additional React Native templates with specialized features
-- 🔌 **Plugin System** - Extensible architecture for custom features  
-- 🤖 **More AI Providers** - Anthropic, Google, and custom model support
-- 📊 **Analytics Integration** - Built-in analytics and monitoring
-- 🌍 **Internationalization** - Multi-language support out of the box
-- 🎨 **Theme Marketplace** - Community-contributed themes and components
-
----
-
-**Built with ❤️ by [Digi Logic Labs](https://digilogiclabs.com)**
-
-*Creating the future of SaaS development, one template at a time.*
+# @digilogiclabs/create-saas-app
+
+**Create production-ready SaaS applications with AI capabilities in seconds.** This CLI tool generates modern web applications with authentication, payments, AI integration, and AI-powered development workflows.
+
+[![npm version](https://badge.fury.io/js/%40digilogiclabs%2Fcreate-saas-app.svg)](https://badge.fury.io/js/%40digilogiclabs%2Fcreate-saas-app)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ⚡ **Quick Start - High-Value Templates**
+
+Get started instantly with our most popular, production-ready templates:
+
+### **🎯 Recommended Templates**
+
+```bash
+# 💳 Complete SaaS Foundation (Payments + Auth)
+npx @digilogiclabs/create-saas-app create web ui-auth-payments my-saas-app
+
+# 🤖 AI-Powered SaaS Platform (Text, Audio, Video AI)
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-platform --with-ai=all
+
+# 🧠 AI Knowledge Base & RAG System (v4.0.0)
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai-rag knowledge-app --with-ai=rag
+
+# 🎵 Audio Streaming SaaS (Music/Podcast Platform)
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform
+
+# 🎬 Video Streaming SaaS (Video Platform)
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio
+
+# 📱 Mobile AI SaaS (React Native + Expo)
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai mobile-ai-app --with-ai=all
+
+# 📱 Mobile RAG Knowledge App
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai-rag knowledge-mobile --with-ai=rag
+```
+
+## 🚀 Complete Template Reference
+
+### **Quick Command Reference**
+
+```bash
+# Interactive mode (recommended for beginners)
+npx @digilogiclabs/create-saas-app create
+
+# Direct command format
+npx @digilogiclabs/create-saas-app create <platform> <template> <project-name> [options]
+
+# Get help anytime
+npx @digilogiclabs/create-saas-app --help
+npx @digilogiclabs/create-saas-app create --help
+```
+
+### **📋 All Available Templates (16 Total)**
+
+#### **🌐 Web Templates (11)**
+
+**💎 Premium SaaS Templates**
+| Template | Description | Features | Command |
+|----------|-------------|----------|---------|
+| `ui-auth-payments` | **Complete SaaS Foundation** | Auth + Payments + Dashboard | `npx @digilogiclabs/create-saas-app create web ui-auth-payments my-saas` |
+| `ui-auth-payments-ai` | **AI-Powered SaaS Platform** | Full AI Suite (Text, Audio, Video) | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-platform --with-ai=all` |
+| `ui-auth-payments-ai-rag` | **🧠 AI Knowledge Base & RAG** | Smart Document Processing v4.0.0 | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai-rag knowledge-app --with-ai=rag` |
+| `ui-auth-payments-audio` | **🎵 Audio Streaming SaaS** | Music/Podcast Platform | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform` |
+| `ui-auth-payments-video` | **🎬 Video Streaming SaaS** | Video Platform & Studio | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio` |
+
+**🚀 Starter Templates**
+| Template | Description | Features | Command |
+|----------|-------------|----------|---------|
+| `base` | Clean Next.js 15 starter | Minimal setup | `npx @digilogiclabs/create-saas-app create web base my-app` |
+| `ui-only` | Component library showcase | Design system | `npx @digilogiclabs/create-saas-app create web ui-only design-system` |
+| `ui-auth` | Authentication flow | Auth + Dashboard | `npx @digilogiclabs/create-saas-app create web ui-auth auth-app` |
+| `ui-auth-ai` | Text & chat AI platform | Basic AI features | `npx @digilogiclabs/create-saas-app create web ui-auth-ai text-ai-app --with-ai=text` |
+| `ui-package-test` | Component testing env | Development testing | `npx @digilogiclabs/create-saas-app create web ui-package-test component-test` |
+
+#### **📱 Mobile Templates (5)**
+
+**💎 Premium Mobile SaaS**
+| Template | Description | Features | Command |
+|----------|-------------|----------|---------|
+| `ui-auth-payments` | **Full Mobile SaaS** | Auth + Payments + Native UI | `npx @digilogiclabs/create-saas-app create mobile ui-auth-payments mobile-saas` |
+| `ui-auth-payments-ai` | **📱 Mobile AI SaaS** | Native AI with Voice/Camera | `npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai ai-mobile-app --with-ai=all` |
+| `ui-auth-payments-ai-rag` | **📱 Mobile Knowledge App** | Offline RAG + Document Scanning | `npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai-rag knowledge-mobile --with-ai=rag` |
+
+**🚀 Mobile Starters**
+| Template | Description | Features | Command |
+|----------|-------------|----------|---------|
+| `base` | React Native + Expo starter | Minimal mobile setup | `npx @digilogiclabs/create-saas-app create mobile base mobile-app` |
+
+### **🤖 AI Capabilities Reference**
+
+**AI Template Options (`--with-ai`)**
+| Capability | Description | Includes | Best For |
+|------------|-------------|----------|----------|
+| `text` | Text generation & chat | OpenAI GPT, Claude, Gemini | Content creation, chatbots |
+| `audio` | Audio processing & generation | Speech-to-text, text-to-speech, music | Podcasts, music platforms |
+| `video` | Video processing & generation | Video editing, generation, streaming | Video platforms, content creation |
+| `rag` | **🧠 RAG Knowledge System v4.0.0** | Vector search, document processing, Q&A | Knowledge bases, AI assistants |
+| `all` | Complete AI suite | All above capabilities | Full AI platforms |
+
+**Available AI Providers (`--ai-provider`)**
+
+- `openai` (default) - GPT-4, DALL-E, Whisper
+- `anthropic` - Claude Sonnet/Haiku
+- `gemini` - Google Gemini Pro
+
+### **🛠 CLI Options**
+
+#### **Core Arguments**
+
+```bash
+<platform>       # web | mobile | both
+<template>       # Template name (see table above)
+<project-name>   # Your project name (kebab-case recommended)
+```
+
+#### **Configuration Flags**
+
+```bash
+-a, --auth <provider>        # firebase | supabase (default: supabase)
+-d, --database <provider>    # supabase | firebase (default: supabase)
+-t, --theme <theme>          # default | corporate | startup (default: default)
+-c, --theme-color <color>    # blue | green | purple | orange | red | slate (default: blue)
+--default-theme <mode>       # light | dark | system (default: system)
+--with-ai [capabilities]     # text | audio | video | text,audio | all (for AI templates)
+--ai-provider <provider>     # openai | anthropic | gemini (default: openai)
+--no-install                 # Skip package installation
+--no-git                     # Skip git initialization
+-y, --yes                    # Skip interactive prompts
+```
+
+### **💡 Real-World Examples**
+
+#### **🚀 Beginner: Interactive Mode**
+
+```bash
+# Let the CLI guide you through all options
+npx @digilogiclabs/create-saas-app create
+```
+
+#### **🎯 Business Use Cases**
+
+**💼 SaaS Startup**
+
+```bash
+# Complete SaaS foundation with payments
+npx @digilogiclabs/create-saas-app create web ui-auth-payments my-startup \
+  --theme=startup \
+  --theme-color=purple \
+  --auth=supabase \
+  --database=supabase
+```
+
+**🤖 AI Content Platform**
+
+```bash
+# Full AI platform with all capabilities
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai content-ai \
+  --with-ai=all \
+  --ai-provider=openai \
+  --theme=corporate \
+  --theme-color=blue
+```
+
+**🧠 Knowledge Base & AI Assistant**
+
+```bash
+# RAG-powered knowledge platform
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai-rag knowledge-base \
+  --with-ai=rag \
+  --ai-provider=anthropic \
+  --theme=startup \
+  --theme-color=green
+```
+
+**🎵 Music Streaming Platform**
+
+```bash
+# Audio streaming SaaS like Spotify
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-stream \
+  --theme=default \
+  --theme-color=orange \
+  --auth=supabase
+```
+
+**📱 Mobile-First AI App**
+
+```bash
+# Native mobile AI app with offline capabilities
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai mobile-ai \
+  --with-ai=all \
+  --theme=corporate \
+  --theme-color=blue \
+  --no-git
+
+# Cross-platform SaaS with Firebase
+npx @digilogiclabs/create-saas-app create both ui-auth-payments fullstack-saas \
+  --auth=firebase \
+  --database=firebase \
+  --theme=default \
+  --default-theme=dark
+
+# Quick prototyping (no deps install)
+npx @digilogiclabs/create-saas-app create web ui-auth-payments prototype \
+  --no-install \
+  --no-git \
+  --yes
+```
+
+### **🎯 Template Selection Guide**
+
+#### **Choose by Use Case**
+
+- **Learning/Prototyping**: `base` or `ui-only`
+- **Authentication App**: `ui-auth`
+- **SaaS with Billing**: `ui-auth-payments`
+- **AI Applications**: `ui-auth-payments-ai` or `ui-auth-ai`
+- **Media Platforms**: `ui-auth-payments-audio` or `ui-auth-payments-video`
+- **Mobile Apps**: Mobile versions of above
+- **Full-Stack**: `both` platform with any template
+
+#### **Choose by Complexity**
+
+1. **Simple**: `base`, `ui-only`
+2. **Medium**: `ui-auth`, `ui-auth-payments`
+3. **Advanced**: `ui-auth-payments-ai`, `ui-auth-payments-audio`, `ui-auth-payments-video`
+
+#### **Choose by Platform**
+
+- **Web Only**: Use `web` platform
+- **Mobile Only**: Use `mobile` platform
+- **Universal**: Use `both` platform (web + mobile)
+
+## 🎉 What's New in v1.13.0
+
+### 🤖 **Complete AI Integration**
+
+- **Ready-to-Use Components** - AIChat, AITextGenerator, AIAudioGenerator, AIVideoGenerator now available
+- **Client-Side Configuration** - NEXT*PUBLIC* environment variables for seamless setup
+- **Configuration Validation** - AISetupStatus component guides users through setup
+- **Enhanced TypeScript** - Complete type definitions and IntelliSense support
+
+### 🎨 **Enhanced UI Library**
+
+- **6 New Components** - Switch, Slider, Textarea, Accordion, Breadcrumbs, EmptyState
+- **Fixed Glassmorphism API** - Proper `border` and `accent` properties now available
+- **Cross-Platform Ready** - Single codebase supports Next.js + React Native/Expo
+- **Node.js 18+ Support** - Broader compatibility for more environments
+
+### 🔐 **Expanded Authentication**
+
+- **12 OAuth Providers** - Added Microsoft, LinkedIn, Spotify, Twitch, Slack, Notion
+- **Enhanced User Types** - Comprehensive profiles with extended role system
+- **Beautiful Provider UI** - Proper branding and SVG icons for all providers
+
+### 💳 **Improved Payments**
+
+- **Enhanced Type System** - Better TypeScript definitions and error handling
+- **Future-Ready Foundation** - Prepared for PayPal, Apple Pay, and analytics features
+
+## 🚀 Quick Start
+
+```bash
+# Interactive mode (recommended)
+npx @digilogiclabs/create-saas-app create
+
+# Or create directly with popular templates
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-ai-saas --with-ai=all
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai mobile-ai-app --with-ai=all
+npx @digilogiclabs/create-saas-app create web ui-auth-payments saas-app
+```
+
+> 💡 **New to the CLI?** See the complete [Template Generator Guide](#-template-generator-guide) above for all options and examples.
+
+## ⚡ What You Get
+
+### 🤖 **AI-First Development**
+
+- **Claude CLI integration** - AI assistant configured for your specific template
+- **Template-aware context** - AI understands your packages and architecture
+- **Auto-generated documentation** - Context files and development guides
+- **AI-powered components** - Text, audio, and video generation ready to use
+
+### 🏗️ **Production-Ready Stack**
+
+- **Next.js 15.3** with App Router and Server Components
+- **TypeScript** throughout with strict typing
+- **Supabase** for database, auth, and real-time features
+- **Stripe** for payments and subscriptions
+- **Tailwind CSS v4** with glassmorphism design system
+
+### 🎯 **Developer Experience**
+
+- **Setup guides** with copy-paste configurations
+- **Deployment guides** for Vercel, Netlify, Railway, and Docker
+- **Environment validation** and troubleshooting
+- **Package documentation** and code examples
+
+## 🎨 Template Gallery
+
+> 📋 **Quick Reference?** See the [Template Generator Guide](#-template-generator-guide) at the top for a complete table of all templates and commands.
+
+Choose from **12 production-ready templates** across web and mobile platforms:
+
+### 🌐 **Web Templates (9 Available)**
+
+#### **Core Templates**
+
+##### **Base Template** (`base`)
+
+Clean Next.js 15 starter with minimal dependencies
+
+- **Next.js 15.3** - App Router with Server Components
+- **TypeScript** - Strict typing throughout
+- **Tailwind CSS v4** - Modern utility-first styling
+- **Essential setup** - Perfect foundation for custom builds
+
+```bash
+npx @digilogiclabs/create-saas-app create web base my-app
+```
+
+##### **UI Only Template** (`ui-only`)
+
+Components library showcase without authentication
+
+- **Component gallery** - All @digilogiclabs/saas-factory-ui components
+- **Design system** - Glassmorphism and modern patterns
+- **No auth required** - Perfect for design system demos
+- **Storybook-style** - Interactive component documentation
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-only design-system
+```
+
+#### **Authentication Templates**
+
+##### **UI + Auth** (`ui-auth`)
+
+Modern authentication flow with beautiful UI
+
+- **User management** - Sign up, login, profile management
+- **12 OAuth providers** - Google, GitHub, Microsoft, LinkedIn, Spotify, and more
+- **Protected routes** - Authentication-gated content
+- **Email verification** - Secure account activation
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth auth-app
+```
+
+##### **UI + Auth + Payments** (`ui-auth-payments`)
+
+Complete SaaS foundation with billing
+
+- **Subscription management** - Stripe integration with webhooks
+- **User dashboards** - Account management and billing portal
+- **Team features** - Multi-user support and permissions
+- **Analytics** - Revenue and usage tracking
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth-payments saas-platform
+```
+
+#### **AI-Powered Templates**
+
+##### **AI + Auth** (`ui-auth-ai`)
+
+Text and chat AI integration platform
+
+- **Text generation** - OpenAI GPT-4 integration
+- **AI chat interface** - Interactive conversation UI
+- **Content management** - Save and organize AI outputs
+- **Usage tracking** - Monitor API consumption
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth-ai text-ai-app --with-ai=text
+```
+
+##### **AI + Auth + Payments** (`ui-auth-payments-ai`)
+
+Full AI SaaS platform with multi-modal generation
+
+- **Multi-modal AI** - Text, audio, and video generation
+- **AI Dashboard** - Generation history and usage analytics
+- **Smart UI** - Tabbed interface for different AI tools
+- **Real-time features** - Live generation status and updates
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-platform --with-ai=all
+```
+
+#### **Media Templates**
+
+##### **Audio SaaS** (`ui-auth-payments-audio`)
+
+Music streaming and audio processing platform
+
+- **Audio streaming** - Playlist management and playback
+- **Audio generation** - AI-powered voice synthesis
+- **Waveform visualization** - Real-time audio analysis
+- **Offline support** - Cached playback and PWA features
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform
+```
+
+##### **Video SaaS** (`ui-auth-payments-video`)
+
+Video streaming and media platform
+
+- **Video streaming** - Quality selection and adaptive bitrate
+- **Video generation** - AI-powered video creation
+- **Content management** - Upload, process, and organize videos
+- **Analytics dashboard** - View counts and engagement metrics
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio
+```
+
+#### **Development Templates**
+
+##### **UI Package Test** (`ui-package-test`)
+
+Component testing environment for package development
+
+- **Component testing** - Isolated testing environment
+- **Package validation** - Test UI components before release
+- **Development tools** - Hot reload and debugging setup
+- **Documentation** - Auto-generated component docs
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-package-test component-test
+```
+
+### 📱 **Mobile Templates (5 Available)**
+
+#### **Base Mobile** (`base`)
+
+React Native + Expo starter for mobile development
+
+- **Expo 50** - Modern React Native development platform
+- **TypeScript** - Full type safety for mobile
+- **Navigation** - React Navigation v6 setup
+- **Cross-platform** - iOS and Android support
+
+```bash
+npx @digilogiclabs/create-saas-app create mobile base mobile-app
+```
+
+#### **Mobile SaaS** (`ui-auth-payments`)
+
+Full mobile SaaS platform with native UI v0.27.0
+
+- **Native UI components** - 240+ components with enhanced mobile features
+- **Authentication** - Supabase Auth v1.0.4 with biometric support
+- **Payments** - Stripe React Native v0.28.0 integration
+- **Advanced features** - Onboarding, tours, offline support, haptic feedback
+- **Updated Dependencies** - Latest package versions for stability
+
+```bash
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments mobile-saas
+```
+
+#### **Mobile AI SaaS** (`ui-auth-payments-ai`)
+
+Complete mobile AI platform with generation capabilities
+
+- **AI Generation Suite** - Text, audio, and video AI generation
+- **Native AI Components** - AITextGenerator, AIAudioGenerator, AIVideoGenerator, AIChat
+- **AI Dashboard** - Usage statistics and generation history
+- **Multi-modal AI** - OpenAI, ElevenLabs, Replicate integration
+- **Mobile-optimized** - Touch-friendly AI interfaces with haptic feedback
+- **Offline AI Cache** - Cached responses for better mobile experience
+- **Enhanced TypeScript** - bundler moduleResolution for better compatibility
+
+```bash
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai ai-mobile-app --with-ai=all
+```
+
+#### **Mobile RAG Knowledge App** (`ui-auth-payments-ai-rag`)
+
+Advanced mobile knowledge base with RAG capabilities
+
+- **RAG Integration** - Vector search and document processing
+- **Offline RAG** - Local knowledge base for mobile-first experience
+- **Document Scanning** - Native camera integration for document capture
+- **Knowledge Management** - Organize and search through personal knowledge
+- **AI-Powered Q&A** - Intelligent question answering from documents
+- **Complete Mobile Setup** - All required config files and dependencies
+
+```bash
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai-rag knowledge-mobile --with-ai=rag
+```
+
+### 🚀 **Cross-Platform Templates**
+
+#### **Full Stack Platform** (`ui-auth-payments`)
+
+Web + Mobile SaaS platform
+
+- **Shared codebase** - Unified components and logic
+- **Web dashboard** - Full-featured admin interface
+- **Mobile app** - Native mobile experience
+- **Real-time sync** - Cross-platform data synchronization
+
+```bash
+npx @digilogiclabs/create-saas-app create both ui-auth-payments fullstack-platform
+```
+
+#### **AI Full Stack** (`ui-auth-payments-ai`)
+
+Web + Mobile AI platform
+
+- **AI everywhere** - Consistent AI features across platforms
+- **Mobile-optimized** - Touch-friendly AI interfaces
+- **Cloud sync** - AI generations sync across devices
+- **Offline capable** - Cached AI responses for mobile
+
+```bash
+npx @digilogiclabs/create-saas-app create both ui-auth-payments-ai ai-fullstack --with-ai=all
+```
+
+## 🤖 AI Development Workflow
+
+Every template includes **Claude AI integration** for enhanced development:
+
+### 🎯 **Instant AI Setup**
+
+```bash
+# Create your app
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-app --with-ai=all
+
+# Navigate to setup
+cd my-app && open http://localhost:3000/dev-setup
+
+# Copy .claude configuration (auto-generated)
+# Copy context.md documentation (auto-generated)
+
+# Start coding with AI assistance
+claude "Help me add a new AI feature"
+claude "Create a user profile component"
+claude "Debug this authentication error"
+```
+
+### 📚 **Smart AI Context**
+
+Each template generates intelligent context for Claude:
+
+- **Package integration guides** - How to use each Digi Logic Labs package
+- **Architecture documentation** - Next.js patterns and best practices
+- **Code examples** - Common patterns for auth, payments, AI
+- **Environment setup** - Configuration and troubleshooting
+
+### ⚡ **AI-Powered Components** (v3.1.1)
+
+Templates with `--with-ai` include complete component library:
+
+```typescript
+import {
+  AIProvider,
+  AIChat,
+  AITextGenerator,
+  AIAudioGenerator,
+  AIVideoGenerator,
+  AISetupStatus,
+  getAIConfigFromEnv
+} from '@digilogiclabs/saas-factory-ai'
+
+function App() {
+  const config = getAIConfigFromEnv()
+
+  return (
+    <AIProvider config={config}>
+      {/* Configuration validation */}
+      <AISetupStatus />
+
+      {/* Text generation */}
+      <AITextGenerator
+        placeholder="Generate blog content..."
+        templates={['Blog post', 'Email', 'Social media']}
+        showWordCount={true}
+        maxLength={2000}
+      />
+
+      {/* AI chat interface */}
+      <AIChat
+        placeholder="Ask me anything..."
+        showTypingIndicator={true}
+        enableFileUpload={true}
+        maxMessages={50}
+      />
+
+      {/* Audio generation */}
+      <AIAudioGenerator
+        placeholder="Describe the audio..."
+        supportedFormats={['mp3', 'wav', 'ogg']}
+        showWaveform={true}
+        maxDuration={300}
+      />
+
+      {/* Video generation */}
+      <AIVideoGenerator
+        placeholder="Describe the video..."
+        supportedFormats={['mp4', 'webm']}
+        resolution="1080p"
+        showPreview={true}
+        maxDuration={60}
+      />
+    </AIProvider>
+  )
+}
+```
+
+## 🚀 Deployment Made Simple
+
+Every template includes **comprehensive deployment guides**:
+
+### 📋 **Multiple Hosting Options**
+
+#### **Vercel (Recommended)**
+
+```bash
+# One-command deployment
+vercel --prod
+
+# Automatic HTTPS, edge functions, preview deployments
+```
+
+#### **Netlify**
+
+```bash
+# Git-based deployment with form handling
+npm run build && netlify deploy --prod
+```
+
+#### **Railway**
+
+```bash
+# Full-stack with integrated database
+railway init && railway up
+```
+
+#### **Docker + Cloud Run**
+
+```bash
+# Containerized deployment with auto-scaling
+gcloud run deploy --source .
+```
+
+### ✅ **Pre-Deployment Checklist**
+
+Built-in validation ensures your app is deployment-ready:
+
+- ✅ Environment variables configured
+- ✅ Database tables created and RLS enabled
+- ✅ Stripe webhooks configured (if using payments)
+- ✅ Build succeeds locally
+- ✅ Tests pass
+
+## 🎛️ Advanced Configuration
+
+### 🤖 **AI Capabilities**
+
+```bash
+# Enable specific AI capabilities
+--with-ai=text                    # Text generation only
+--with-ai=audio                   # Audio generation only
+--with-ai=video                   # Video generation only
+--with-ai=text,audio              # Text and audio
+--with-ai=all                     # All AI capabilities
+
+# Specify AI provider
+--ai-provider=openai              # OpenAI (default)
+--ai-provider=anthropic           # Anthropic Claude
+--ai-provider=gemini              # Google Gemini
+```
+
+### 🎨 **Theming & Styling**
+
+```bash
+# Theme options
+--theme=default                   # Clean and modern
+--theme=corporate                 # Professional blue
+--theme=startup                   # Bold purple
+
+# Theme colors
+--theme-color=blue               # Blue accents (default)
+--theme-color=purple             # Purple accents
+--theme-color=green              # Green accents
+
+# Default theme mode
+--default-theme=system           # Follow system (default)
+--default-theme=light            # Always light
+--default-theme=dark             # Always dark
+```
+
+### 🔐 **Service Providers**
+
+```bash
+# Authentication
+--auth=supabase                  # Supabase Auth (default)
+--auth=firebase                  # Firebase Auth
+
+# Database
+--database=supabase              # Supabase (default)
+--database=firebase              # Firebase Firestore
+```
+
+## 📦 Package Ecosystem
+
+### 🎨 **UI & Design** (v0.27.1)
+
+- **@digilogiclabs/saas-factory-ui** - 240+ components with mobile-first design
+- **75% Component Increase** - From 140+ to 240+ components in v0.22.0
+- **Cross-Platform Support** - Single codebase for Next.js + React Native/Expo
+- **Native Mobile Components** - AppShell, BottomTabBar, NativeTour, VirtualScrollList
+- **Advanced Features** - Haptic feedback, gesture support, offline capabilities
+- **Enhanced Glassmorphism** - Fixed API with proper `border` and `accent` properties
+- **Next.js 15.3** - App Router with Server Components
+- **Tailwind CSS v4** - Design tokens and utility classes
+- **Node.js 18+ Support** - Broader compatibility range
+
+### 🔐 **Authentication** (v1.0.5)
+
+- **@digilogiclabs/saas-factory-auth** - Enhanced Supabase Auth integration
+- **12 OAuth Providers** - Google, GitHub, Microsoft, LinkedIn, Spotify, Twitch, Slack, Notion + more
+- **Enhanced TypeScript Types** - Comprehensive user profiles and metadata
+- **Beautiful UI Components** - Proper branding and SVG icons for all providers
+- **Extended User Roles** - owner, editor, viewer, contributor, manager, developer, analyst, support
+- **Row Level Security** - Database-level permissions
+- **Email verification** - Secure account management
+
+### 💳 **Payments** (v1.2.6)
+
+- **@digilogiclabs/saas-factory-payments** - Enhanced Stripe integration
+- **Improved Type System** - Better TypeScript definitions with cross-platform compatibility
+- **Enhanced Error Handling** - Expanded error types for comprehensive management
+- **Better Subscription Management** - Enhanced types with additional compatibility fields
+- **Future-Ready Architecture** - Foundation for PayPal, Apple Pay, and analytics
+- **Webhook handling** - Secure payment event processing
+- **Customer portal** - Self-service billing management
+
+### 🤖 **AI Platform** (v3.1.1)
+
+- **@digilogiclabs/saas-factory-ai** - Complete React component library
+- **Ready-to-Use Components** - AIChat, AITextGenerator, AIAudioGenerator, AIVideoGenerator, AIProvider
+- **@digilogiclabs/saas-factory-ai-types** - Complete TypeScript definitions
+- **Client-Side Configuration** - NEXT*PUBLIC* environment variable support
+- **Configuration Validation** - AISetupStatus component and validateAIConfig() helper
+- **Environment Helpers** - getAIConfigFromEnv() for seamless setup
+- **OpenAI integration** - GPT-4 for text and audio
+- **ElevenLabs integration** - High-quality voice synthesis
+- **Replicate integration** - Video and image generation
+
+## 🛠️ Command Reference
+
+### 📋 **Create Command**
+
+```bash
+npx @digilogiclabs/create-saas-app create <platform> [template] [name] [options]
+
+# Arguments
+platform                         # web, mobile, or both
+template                          # ui-auth-payments-ai, ui-auth-payments, ui-auth, etc.
+name                              # your-project-name
+
+# Options
+-a, --auth <provider>            # firebase, supabase
+-d, --database <provider>        # supabase, firebase
+-t, --theme <theme>              # default, corporate, startup
+-c, --theme-color <color>        # blue, green, purple, orange, red, slate
+--default-theme <mode>           # light, dark, system
+--with-ai [capabilities]         # text,audio,video or all
+--ai-provider <provider>         # openai, anthropic, gemini
+--no-install                     # Skip package installation
+--no-git                        # Skip git initialization
+-y, --yes                       # Skip interactive prompts
+```
+
+### ➕ **Add Features** (Coming Soon)
+
+```bash
+# Add features to existing projects
+npx @digilogiclabs/create-saas-app add billing --provider=stripe
+npx @digilogiclabs/create-saas-app add analytics --provider=mixpanel
+npx @digilogiclabs/create-saas-app add ai --capabilities=text,audio
+```
+
+### 🔄 **Update Command** (Coming Soon)
+
+```bash
+# Check for package updates
+npx @digilogiclabs/create-saas-app update --check
+
+# Update all Digi Logic Labs packages
+npx @digilogiclabs/create-saas-app update
+```
+
+## 🌟 Examples
+
+### 🤖 **AI-Powered SaaS**
+
+```bash
+# Full AI platform with all capabilities
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai \
+  my-ai-platform \
+  --with-ai=all \
+  --ai-provider=openai \
+  --theme=startup \
+  --theme-color=purple
+```
+
+### 🎵 **Music Streaming Platform**
+
+```bash
+# Audio platform with Supabase and corporate theme
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio \
+  music-streaming \
+  --auth=supabase \
+  --database=supabase \
+  --theme=corporate \
+  --theme-color=blue
+```
+
+### 🎬 **Video Creation Studio**
+
+```bash
+# Video platform with AI generation capabilities
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-video \
+  video-studio \
+  --with-ai=video \
+  --ai-provider=replicate \
+  --theme=startup \
+  --default-theme=dark
+```
+
+## 📚 Getting Started Guide
+
+### 1. **Create Your App**
+
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-saas --with-ai=all
+cd my-saas
+```
+
+### 2. **Follow Setup Guide**
+
+```bash
+npm run dev
+# Open http://localhost:3000/setup
+# Configure Supabase, Stripe, and AI providers
+```
+
+### 3. **Set Up Development Workflow**
+
+```bash
+# Visit http://localhost:3000/dev-setup
+# Copy .claude configuration
+# Copy context.md documentation
+# Install Claude CLI: npm install -g @anthropic-ai/claude-cli
+```
+
+### 4. **Start Building with AI**
+
+```bash
+claude "Help me add a user profile page"
+claude "Create a subscription management component"
+claude "Add error handling to the payment flow"
+```
+
+### 5. **Deploy to Production**
+
+```bash
+# Follow deployment guide at /dev-setup
+vercel --prod  # One-command deployment
+```
+
+## 🔧 Development
+
+### 📋 **Requirements**
+
+- **Node.js**: 18.0.0 or higher
+- **Package Manager**: npm, yarn, or pnpm
+- **Git**: For repository initialization
+
+### 🛠️ **Local Development**
+
+```bash
+# Clone repository
+git clone https://github.com/DigiLogicLabs/create-saas-app.git
+cd create-saas-app
+
+# Install dependencies
+npm install
+
+# Build CLI
+npm run build
+
+# Test locally
+node bin/index.js create web ui-auth-payments-ai test-app --with-ai=all
+```
+
+## 🐛 Troubleshooting
+
+### ❓ **Common Issues**
+
+#### CLI Command Not Found
+
+```bash
+# Use npx (recommended)
+npx @digilogiclabs/create-saas-app
+
+# Or install globally
+npm install -g @digilogiclabs/create-saas-app
+```
+
+#### Template Generation Fails
+
+```bash
+# Check Node.js version (18.0.0+ required)
+node --version
+
+# Clear npm cache
+npm cache clean --force
+
+# Try with --no-install flag
+npx @digilogiclabs/create-saas-app create web ui-auth test-app --no-install
+```
+
+#### Environment Variables Issues
+
+```bash
+# Check setup guide in your app
+open http://localhost:3000/setup
+
+# Copy environment variables from setup page
+# Verify all required services are configured
+```
+
+#### AI Integration Issues
+
+```bash
+# Verify AI API keys in .env.local
+OPENAI_API_KEY=your_openai_key
+ELEVENLABS_API_KEY=your_elevenlabs_key
+REPLICATE_API_TOKEN=your_replicate_token
+
+# Check AI setup guide
+open http://localhost:3000/dev-setup
+```
+
+## 📄 License
+
+MIT © [Digi Logic Labs](https://digilogiclabs.com)
+
+## 🆘 Support & Community
+
+- 💬 **Discord**: [Join our community](https://discord.gg/digilogiclabs)
+- 📖 **Documentation**: [docs.digilogiclabs.com](https://docs.digilogiclabs.com)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/DigiLogicLabs/create-saas-app/issues)
+- 💡 **Feature Requests**: [GitHub Discussions](https://github.com/DigiLogicLabs/create-saas-app/discussions)
+- 📧 **Email**: support@digilogiclabs.com
+
+## 🚀 What's Next?
+
+- 📱 **Enhanced Mobile Templates** - Additional React Native templates with specialized features
+- 🔌 **Plugin System** - Extensible architecture for custom features
+- 🤖 **More AI Providers** - Anthropic, Google, and custom model support
+- 📊 **Analytics Integration** - Built-in analytics and monitoring
+- 🌍 **Internationalization** - Multi-language support out of the box
+- 🎨 **Theme Marketplace** - Community-contributed themes and components
+
+---
+
+**Built with ❤️ by [Digi Logic Labs](https://digilogiclabs.com)**
+
+_Creating the future of SaaS development, one template at a time._