@digilogiclabs/create-saas-app 1.10.7 → 1.13.0

package/README.md

@@ -1,496 +1,477 @@
 # @digilogiclabs/create-saas-app
 
-Create modern SaaS applications with Digi Logic Labs packages in seconds. This CLI tool generates production-ready web and mobile applications with authentication, theming, and best practices built-in.
+**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
 
 ```bash
-# Create a web SaaS application
-npx @digilogiclabs/create-saas-app create web saas my-startup
+# Create an AI-powered SaaS platform
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-ai-saas --with-ai=all
 
-# Create an audio streaming app
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio my-music-app
+# Create an audio streaming platform
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform
 
-# Create a mobile app with tab navigation
-npx @digilogiclabs/create-saas-app create mobile tabs my-mobile-app
+# Create a video generation platform  
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio
 
-# Create both web and mobile apps
-npx @digilogiclabs/create-saas-app create both base my-full-stack-app
+# Create a simple authentication app
+npx @digilogiclabs/create-saas-app create web ui-auth simple-app
 ```
 
-## 📦 Installation
+## ⚡ What You Get
 
-### Using npx (Recommended)
-```bash
-npx @digilogiclabs/create-saas-app
-```
+### 🤖 **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
 
-### Global Installation
-```bash
-npm install -g @digilogiclabs/create-saas-app
-create-saas-app --help
-```
+### 🏗️ **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
 
-## 🎯 Features
+### 🎯 **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
 
-- 🚀 **Rapid Development**: From idea to running app in under 5 minutes
-- 🎯 **Platform Flexibility**: Web (Next.js), Mobile (Expo), or both
-- 🔧 **Smart Configuration**: Auto-configures auth, database, and themes
-- 📦 **Package Integration**: Pre-configured with Digi Logic Labs packages
-- 🎨 **Multiple Themes**: Corporate, startup, or default styling
-- 🎵 **Media Support**: Audio and video streaming templates
-- 🔐 **Auth Ready**: Firebase or Supabase authentication
-- 📊 **Database Ready**: Supabase or Firebase database setup
-- 🚀 **Deploy Ready**: Vercel, Netlify, and Expo deployment configs
-- 📱 **Responsive Design**: Mobile-first approach for web apps
-- 🌙 **Dark Mode**: Built-in theme switching
-- 📦 **TypeScript**: Type-safe development
-- 🎯 **ESLint & Prettier**: Code quality tools
+## 🎨 Template Gallery
 
-## 🌐 Web Applications
+### 🤖 **AI-Powered Templates**
 
-### Available Web Templates
+#### **Full-Stack AI Platform** (`ui-auth-payments-ai`)
+Complete AI platform with text, audio, and video generation
+- **Multi-modal AI** - OpenAI, ElevenLabs, Replicate integration
+- **AI Dashboard** - Generation history and usage analytics  
+- **Smart UI** - Tabbed interface for different AI tools
+- **Real-time features** - Live generation status and updates
 
-#### **Base Template**
-Clean Next.js starter with authentication and UI components
 ```bash
-npx @digilogiclabs/create-saas-app create web base my-web-app
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-platform --with-ai=all
 ```
 
-#### **Dashboard Template**
-Admin dashboard with analytics and user management
-```bash
-npx @digilogiclabs/create-saas-app create web dashboard admin-panel
-```
+#### **Audio Platform** (`ui-auth-payments-audio`)  
+Professional audio streaming and generation 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
 
-#### **SaaS Template**
-Multi-tenant SaaS application with billing and teams
 ```bash
-npx @digilogiclabs/create-saas-app create web saas my-saas-platform
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-app
 ```
 
-#### **Audio Player Template**
-Full SaaS application with audio streaming features and playlist support
-```bash
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio my-audio-app
-```
+#### **Video Platform** (`ui-auth-payments-video`)
+Video streaming and generation 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
 
-#### **Video Player Template**
-Full SaaS application with video streaming features and quality selection
 ```bash
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-video my-video-app
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-platform
 ```
 
-### Web Project Structure
-```
-my-web-app/
-├── src/
-│   ├── app/                 # Next.js App Router
-│   │   ├── globals.css     # Global styles with Tailwind
-│   │   ├── layout.tsx      # Root layout with providers
-│   │   └── page.tsx        # Home page component
-│   ├── components/         # Reusable React components
-│   │   ├── auth/          # Authentication components
-│   │   ├── layout/        # Layout components (header, footer)
-│   │   ├── ui/            # UI components (buttons, cards, etc.)
-│   │   └── providers/     # Context providers
-│   ├── lib/               # Utility libraries
-│   │   └── utils.ts       # Helper functions
-│   ├── hooks/             # Custom React hooks
-│   └── types/             # TypeScript type definitions
-├── public/                # Static assets
-├── .env.example          # Environment variables template
-├── tailwind.config.js    # Tailwind CSS configuration
-├── next.config.js        # Next.js configuration
-└── package.json          # Dependencies and scripts
-```
-
-### Getting Started with Web Apps
+### 🏢 **Business Templates**
 
-1. **Create your project**:
-   ```bash
-   npx @digilogiclabs/create-saas-app create web base my-web-app
-   cd my-web-app
-   ```
+#### **SaaS with Payments** (`ui-auth-payments`)
+Complete SaaS platform 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
 
-2. **Configure environment variables**:
-   ```bash
-   cp .env.example .env.local
-   # Edit .env.local with your configuration
-   ```
-
-3. **Start development server**:
-   ```bash
-   npm run dev
-   ```
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth-payments saas-platform
+```
 
-4. **Open in browser**: http://localhost:3000
+#### **Authentication App** (`ui-auth`)
+Simple auth-enabled application
+- **User management** - Sign up, login, profile management
+- **Protected routes** - Authentication-gated content
+- **Social logins** - Google, GitHub, and more
+- **Email verification** - Secure account activation
 
-### Web Environment Variables
 ```bash
-# App Configuration
-NEXT_PUBLIC_APP_NAME=my-web-app
-NEXT_PUBLIC_APP_URL=http://localhost:3000
-
-# Firebase (if selected)
-NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key
-NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
-NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
-
-# Supabase (if selected)
-NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
-NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
+npx @digilogiclabs/create-saas-app create web ui-auth auth-app
 ```
 
-## 📱 Mobile Applications
+## 🤖 AI Development Workflow
 
-### Available Mobile Templates
+Every template includes **Claude AI integration** for enhanced development:
 
-#### **Base Template**
-Simple Expo app with navigation and authentication
+### 🎯 **Instant AI Setup**
 ```bash
-npx @digilogiclabs/create-saas-app create mobile base my-mobile-app
-```
+# Create your app
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-app --with-ai=all
 
-#### **Tabs Template**
-Tab-based navigation structure
-```bash
-npx @digilogiclabs/create-saas-app create mobile tabs my-tabs-app
-```
+# Navigate to setup
+cd my-app && open http://localhost:3000/dev-setup
 
-#### **Stack Template**
-Stack-based navigation structure
-```bash
-npx @digilogiclabs/create-saas-app create mobile stack my-stack-app
-```
+# Copy .claude configuration (auto-generated)
+# Copy context.md documentation (auto-generated) 
 
-### Mobile Project Structure
-```
-my-mobile-app/
-├── src/
-│   ├── navigation/        # React Navigation setup
-│   ├── screens/          # Screen components
-│   │   ├── auth/         # Authentication screens
-│   │   └── main/         # Main app screens
-│   ├── components/       # Reusable components
-│   │   ├── auth/         # Auth-related components
-│   │   ├── layout/       # Layout components
-│   │   └── ui/           # UI components
-│   ├── providers/        # Context providers
-│   ├── hooks/            # Custom hooks
-│   ├── services/         # API and external services
-│   ├── utils/            # Utility functions
-│   └── types/            # TypeScript definitions
-├── assets/               # Images, icons, fonts
-├── App.tsx              # Root component
-├── app.json             # Expo configuration
-└── package.json         # Dependencies and scripts
+# Start coding with AI assistance
+claude "Help me add a new AI feature"
+claude "Create a user profile component"
+claude "Debug this authentication error"
 ```
 
-### Getting Started with Mobile Apps
+### 📚 **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
 
-1. **Create your project**:
-   ```bash
-   npx @digilogiclabs/create-saas-app create mobile base my-mobile-app
-   cd my-mobile-app
-   ```
+### ⚡ **AI-Powered Components**
+Templates with `--with-ai` include:
+```typescript
+import { AIProvider, AITextGenerator, AIChat } from '@digilogiclabs/saas-factory-ai'
 
-2. **Install dependencies**:
-   ```bash
-   npm install
-   ```
+// Text generation
+<AITextGenerator 
+  placeholder="Generate blog content..."
+  templates={['Blog post', 'Email', 'Social media']}
+/>
 
-3. **Start Expo development server**:
-   ```bash
-   npm start
-   # or
-   npx expo start
-   ```
+// AI chat interface  
+<AIChat
+  placeholder="Ask me anything..."
+  showTypingIndicator={true}
+  enableFileUpload={true}
+/>
 
-4. **Run on device/simulator**:
-   - **iOS**: `npm run ios` or scan QR code with Camera app
-   - **Android**: `npm run android` or scan QR code with Expo Go app
-   - **Web**: `npm run web`
+// Audio generation
+<AIAudioGenerator
+  placeholder="Describe the audio..."
+  supportedFormats={['mp3', 'wav']}
+  showWaveform={true}
+/>
+```
 
-### Mobile Development Requirements
+## 🚀 Deployment Made Simple
 
-- **Node.js**: 16.0.0 or higher
-- **Expo CLI**: `npm install -g @expo/cli`
-- **iOS Development**: Xcode (macOS only)
-- **Android Development**: Android Studio
-- **Physical Device**: Expo Go app for testing
+Every template includes **comprehensive deployment guides**:
 
-## 🔧 Command Line Interface
+### 📋 **Multiple Hosting Options**
 
-### Interactive Mode
+#### **Vercel (Recommended)**
 ```bash
-npx @digilogiclabs/create-saas-app
+# One-command deployment
+vercel --prod
+
+# Automatic HTTPS, edge functions, preview deployments
 ```
-The CLI will guide you through project configuration with interactive prompts.
 
-### Command Line Options
+#### **Netlify**
 ```bash
-npx @digilogiclabs/create-saas-app create <platform> [template] [name] [options]
-
-Arguments:
-  platform              Platform: web, mobile, or both
-  template              Template type (optional)
-  name                  Project name (optional)
-
-Options:
-  -a, --auth <provider>      Auth provider: firebase, supabase
-  -d, --database <provider>  Database provider: supabase, firebase
-  -t, --theme <theme>        Theme: default, corporate, startup
-  --no-install              Skip package installation
-  --no-git                  Skip git initialization
-  -y, --yes                 Skip interactive prompts
-  -h, --help                Display help for command
+# Git-based deployment with form handling
+npm run build && netlify deploy --prod
 ```
 
-### Usage Examples
-
-#### Web Applications
+#### **Railway**  
 ```bash
-# Basic web app with defaults
-npx @digilogiclabs/create-saas-app create web base my-app
-
-# SaaS app with Supabase and corporate theme
-npx @digilogiclabs/create-saas-app create web saas my-startup \
-  --auth=supabase --database=supabase --theme=corporate
-
-# Dashboard with Firebase auth
-npx @digilogiclabs/create-saas-app create web dashboard admin-panel \
-  --auth=firebase --database=firebase
-
-# Audio streaming app with Supabase
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio my-music-app \
-  --auth=supabase --database=supabase
-
-# Video streaming app with Firebase
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-video my-streaming-app \
-  --auth=firebase --database=firebase
-
-# Skip installation and git init
-npx @digilogiclabs/create-saas-app create web base my-app \
-  --no-install --no-git
+# Full-stack with integrated database
+railway init && railway up
 ```
 
-#### Mobile Applications
+#### **Docker + Cloud Run**
 ```bash
-# Basic mobile app
-npx @digilogiclabs/create-saas-app create mobile base my-mobile-app
+# Containerized deployment with auto-scaling
+gcloud run deploy --source .
+```
 
-# Tab navigation with Firebase
-npx @digilogiclabs/create-saas-app create mobile tabs my-tabs-app \
-  --auth=firebase
+### ✅ **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
 
-# Stack navigation with Supabase
-npx @digilogiclabs/create-saas-app create mobile stack my-stack-app \
-  --auth=supabase --database=supabase
-```
+## 🎛️ Advanced Configuration
 
-#### Full-Stack Applications
+### 🤖 **AI Capabilities**
 ```bash
-# Create both web and mobile
-npx @digilogiclabs/create-saas-app create both base my-full-stack-app
+# 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
 
-# With specific configuration
-npx @digilogiclabs/create-saas-app create both base my-platform \
-  --auth=supabase --database=supabase --theme=startup
+# Specify AI provider
+--ai-provider=openai              # OpenAI (default)
+--ai-provider=anthropic           # Anthropic Claude
+--ai-provider=gemini              # Google Gemini
 ```
 
-## 🎨 Themes
-
-### Default Theme
-Clean and modern design with neutral colors
+### 🎨 **Theming & Styling**
 ```bash
---theme=default
-```
+# Theme options
+--theme=default                   # Clean and modern
+--theme=corporate                 # Professional blue
+--theme=startup                   # Bold purple
 
-### Corporate Theme
-Professional business theme with blue accents
-```bash
---theme=corporate
+# 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
 ```
 
-### Startup Theme
-Bold and innovative design with purple accents
+### 🔐 **Service Providers**
 ```bash
---theme=startup
+# Authentication
+--auth=supabase                  # Supabase Auth (default)
+--auth=firebase                  # Firebase Auth
+
+# Database  
+--database=supabase              # Supabase (default)
+--database=firebase              # Firebase Firestore
 ```
 
-## 🔐 Authentication Setup
+## 📦 Package Ecosystem
 
-### Firebase Authentication
+### 🎨 **UI & Design**
+- **@digilogiclabs/saas-factory-ui** - Modern components with glassmorphism
+- **Next.js 15.3** - App Router with Server Components  
+- **Tailwind CSS v4** - Design tokens and utility classes
+- **Responsive design** - Mobile-first with PWA support
 
-1. **Create Firebase Project**: https://console.firebase.google.com
-2. **Enable Authentication**: Go to Authentication > Sign-in method
-3. **Get Configuration**: Project Settings > General > Your apps
-4. **Update Environment Variables**:
-   ```bash
-   NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key
-   NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
-   NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
-   ```
+### 🔐 **Authentication**
+- **@digilogiclabs/saas-factory-auth** - Supabase Auth integration
+- **Row Level Security** - Database-level permissions
+- **Social logins** - Google, GitHub, and more
+- **Email verification** - Secure account management
 
-### Supabase Authentication
+### 💳 **Payments**  
+- **@digilogiclabs/saas-factory-payments** - Stripe integration
+- **Subscription management** - Recurring billing and invoices
+- **Webhook handling** - Secure payment event processing
+- **Customer portal** - Self-service billing management
 
-1. **Create Supabase Project**: https://supabase.com/dashboard
-2. **Get API Keys**: Settings > API
-3. **Update Environment Variables**:
-   ```bash
-   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
-   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
-   ```
+### 🤖 **AI Platform**
+- **@digilogiclabs/saas-factory-ai** - Multi-modal AI components
+- **@digilogiclabs/saas-factory-ai-types** - TypeScript definitions
+- **OpenAI integration** - GPT-4 for text and audio
+- **ElevenLabs integration** - High-quality voice synthesis
+- **Replicate integration** - Video and image generation
 
-## 🚀 Deployment
+## 🛠️ Command Reference
 
-### Web Deployment
+### 📋 **Create Command**
+```bash
+npx @digilogiclabs/create-saas-app create <platform> [template] [name] [options]
 
-#### Vercel (Recommended)
+# 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
-npm install -g vercel
-vercel
+# 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
 ```
 
-#### Netlify
+### 🔄 **Update Command** (Coming Soon)
 ```bash
-npm run build
-# Upload dist folder to Netlify
+# Check for package updates
+npx @digilogiclabs/create-saas-app update --check
+
+# Update all Digi Logic Labs packages
+npx @digilogiclabs/create-saas-app update
 ```
 
-### Mobile Deployment
+## 🌟 Examples
 
-#### Expo Application Services (EAS)
+### 🤖 **AI-Powered SaaS**
 ```bash
-npm install -g eas-cli
-eas build
-eas submit
+# 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
 ```
 
-#### Manual Build
+### 🎵 **Music Streaming Platform**  
 ```bash
-# iOS
-npx expo run:ios --configuration Release
-
-# Android
-npx expo run:android --variant release
+# 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
 ```
 
-## 🛠️ Adding Features
-
-Add features to existing projects:
-
+### 🎬 **Video Creation Studio**
 ```bash
-# Add billing to your SaaS app
-npx @digilogiclabs/create-saas-app add billing --provider=stripe
+# 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
+```
 
-# Add analytics
-npx @digilogiclabs/create-saas-app add analytics --provider=mixpanel
+## 📚 Getting Started Guide
 
-# Add team management
-npx @digilogiclabs/create-saas-app add teams
+### 1. **Create Your App**
+```bash
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-saas --with-ai=all
+cd my-saas
 ```
 
-## 🔄 Updating Dependencies
+### 2. **Follow Setup Guide**
+```bash
+npm run dev
+# Open http://localhost:3000/setup
+# Configure Supabase, Stripe, and AI providers
+```
 
-Keep your Digi Logic Labs packages up to date:
+### 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
-# Check for updates
-npx @digilogiclabs/create-saas-app update --check
+claude "Help me add a user profile page"
+claude "Create a subscription management component"
+claude "Add error handling to the payment flow"
+```
 
-# Update all packages
-npx @digilogiclabs/create-saas-app update
+### 5. **Deploy to Production**
+```bash
+# Follow deployment guide at /dev-setup
+vercel --prod  # One-command deployment
 ```
 
-## 📋 Requirements
+## 🔧 Development
 
-- **Node.js**: 16.0.0 or higher
+### 📋 **Requirements**
+- **Node.js**: 18.0.0 or higher
 - **Package Manager**: npm, yarn, or pnpm
 - **Git**: For repository initialization
-- **Expo CLI**: For mobile development (`npm install -g @expo/cli`)
-
-## 🤝 Contributing
-
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
 
-### Development Setup
-
-1. **Clone the repository**:
-   ```bash
-   git clone https://github.com/DigiLogicLabs/create-saas-app.git
-   cd create-saas-app
-   ```
-
-2. **Install dependencies**:
-   ```bash
-   npm install
-   ```
-
-3. **Build the CLI**:
-   ```bash
-   npm run build
-   ```
+### 🛠️ **Local Development**
+```bash
+# Clone repository
+git clone https://github.com/DigiLogicLabs/create-saas-app.git
+cd create-saas-app
 
-4. **Test locally**:
-   ```bash
-   node bin/index.js create web base test-app
-   ```
+# Install dependencies  
+npm install
 
-## 📚 Documentation
+# Build CLI
+npm run build
 
-- [Getting Started Guide](./docs/getting-started.md)
-- [Web Templates](./docs/templates/web-templates.md)
-- [Mobile Templates](./docs/templates/mobile-templates.md)
-- [Authentication Setup](./docs/auth-setup.md)
-- [Theming Guide](./docs/theming.md)
-- [Deployment Guide](./docs/deployment.md)
+# Test locally
+node bin/index.js create web ui-auth-payments-ai test-app --with-ai=all
+```
 
 ## 🐛 Troubleshooting
 
-### Common Issues
+### ❓ **Common Issues**
 
-#### "Command not found" error
+#### CLI Command Not Found
 ```bash
-# Make sure you're using npx
+# Use npx (recommended)
 npx @digilogiclabs/create-saas-app
 
 # Or install globally
 npm install -g @digilogiclabs/create-saas-app
 ```
 
-#### Template generation fails
+#### Template Generation Fails
 ```bash
-# Check Node.js version
-node --version  # Should be 16.0.0+
+# 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
 ```
 
-#### Mobile app won't start
+#### AI Integration Issues  
 ```bash
-# Install Expo CLI
-npm install -g @expo/cli
+# 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
 
-# Clear Expo cache
-npx expo start --clear
+# Check AI setup guide
+open http://localhost:3000/dev-setup
 ```
 
 ## 📄 License
 
-MIT © Digi Logic Labs
+MIT © [Digi Logic Labs](https://digilogiclabs.com)
 
-## 🆘 Support
+## 🆘 Support & Community
 
-- 📧 **Email**: support@digilogiclabs.com
-- 💬 **Discord**: [Join our community](https://discord.gg/digilogiclabs)
+- 💬 **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?
+
+- 📱 **Mobile Templates** - React Native templates with AI capabilities
+- 🔌 **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
 
 ---
 
-**Built with ❤️ by Digi Logic Labs**
+**Built with ❤️ by [Digi Logic Labs](https://digilogiclabs.com)**
 
+*Creating the future of SaaS development, one template at a time.*