@digilogiclabs/create-saas-app 1.17.0 → 1.18.0

package/CHANGELOG.md

@@ -1,5 +1,87 @@
 # @digilogiclabs/create-saas-app
 
+## 1.18.0
+
+### Minor Changes
+
+- 🚀 **RAG Knowledge System v4.0.0 - Complete AI Templates**
+
+  #### 🧠 **New RAG-Powered Templates**
+  - **Web Template**: `ui-auth-payments-ai-rag` - Full-stack AI knowledge platform
+  - **Mobile Template**: `ui-auth-payments-ai-rag` - React Native AI assistant with offline support
+  - **Auto-Selection**: CLI automatically chooses RAG templates with `--with-ai=rag` or `--with-ai=knowledge`
+
+  #### 🎯 **Web RAG Features**
+  - **Intelligent Chat Interface**: Streaming responses with source citations and confidence scores
+  - **Knowledge Management**: Full CRUD operations, bulk import/export, and advanced search
+  - **Analytics Dashboard**: Usage insights, performance metrics, and user satisfaction tracking
+  - **Multi-Domain Support**: Pre-configured for plants, e-commerce, education, or generic use
+  - **Production-Ready**: Caching, rate limiting, security policies, and SEO optimization
+
+  #### 📱 **Mobile RAG Features**
+  - **Voice-Enabled Chat**: Native speech recognition and text-to-speech
+  - **Offline-First Architecture**: Cached responses, queued queries, and smart synchronization
+  - **Touch-Optimized UI**: Swipeable knowledge cards, haptic feedback, and native gestures
+  - **Camera Integration**: Document scanning and visual knowledge search
+  - **Background Sync**: Knowledge updates while app is backgrounded
+
+  #### 🛠 **Technical Implementation**
+  - **AI Packages**: Updated to `@digilogiclabs/saas-factory-ai@4.0.0` and `@digilogiclabs/saas-factory-ai-types@4.0.0`
+  - **Database Schema**: PostgreSQL with vector embeddings (pgvector extension)
+  - **Search Functions**: Hybrid search combining vector similarity and full-text search
+  - **Setup Scripts**: One-command RAG system initialization with `npm run setup:rag`
+  - **Comprehensive Documentation**: Complete setup guides, API references, and examples
+
+  #### 🚀 **Quick Start**
+  ```bash
+  # Create RAG-powered web app
+  npx create-saas-app web my-ai-platform --with-ai=rag
+
+  # Create RAG-powered mobile app
+  npx create-saas-app mobile my-ai-assistant --with-ai=rag
+
+  # Setup and seed knowledge base
+  npm run setup:rag && npm run seed:knowledge
+  ```
+
+  #### 📊 **Template Capabilities**
+  - **Generic AI Assistant**: Configurable for any domain
+  - **Plant Care Assistant**: Botanical expertise with seasonal guidance
+  - **E-commerce Assistant**: Product search and shopping recommendations
+  - **Education Platform**: Tutoring with adaptive explanations
+  - **Custom Domains**: Fully configurable for specific use cases
+
+## 1.17.1
+
+### Patch Changes
+
+- 🎉 **Quality of Life Enhancements Across All Templates**
+
+  #### 🌐 **Web Template Improvements**
+  - **Toast Notification System**: Added `Toaster` component to all web app providers for user feedback
+  - **Enhanced Loading States**: Upgraded loading screens with `SkeletonCard` and `SkeletonText` components
+  - **Search Functionality**: Added `SearchBar` with mobile-responsive design and toast feedback
+  - **Command Palette**: Verified and enhanced existing `CommandPalette` integration across dashboards
+  - **Theme System**: Maintained existing `ThemeToggle` with light/dark/system support
+  - **Fixed**: JSON parsing issue in ui-auth-ai template package.json
+
+  #### 📱 **Mobile Template Enhancements**
+  - **Native Toast System**: Added `NativeToast` component to all mobile app providers
+  - **Advanced Skeleton Loading**: Enhanced loading states with realistic content placeholders
+  - **Verified Existing Features**: Confirmed all premium mobile QoL features are properly implemented:
+    - Pull-to-refresh with haptic feedback ✅
+    - Search functionality with `NativeSearchBar` ✅
+    - Comprehensive haptic feedback integration ✅
+    - Swipe gestures with `SwipeableCard` components ✅
+    - Network-aware content and offline support ✅
+    - Native tours and progressive image loading ✅
+
+  #### 🛠 **Technical Improvements**
+  - **Build Verification**: All templates compile successfully
+  - **Package Integrity**: 2.6MB compressed, 14.8MB unpacked
+  - **Backward Compatibility**: All changes are non-destructive
+  - **Cross-Platform**: Enhanced both web and mobile template experiences
+
 ## 1.6.0
 
 ### Minor Changes

package/README.md

@@ -5,6 +5,134 @@
 [![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)
 
+## 🚀 Template Generator Guide
+
+### **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 (12 Total)**
+
+#### **🌐 Web Templates (9)**
+| Template | Description | Command |
+|----------|-------------|---------|
+| `base` | Clean Next.js 15 starter | `npx @digilogiclabs/create-saas-app create web base my-app` |
+| `ui-only` | Component library showcase | `npx @digilogiclabs/create-saas-app create web ui-only design-system` |
+| `ui-auth` | Authentication flow | `npx @digilogiclabs/create-saas-app create web ui-auth auth-app` |
+| `ui-auth-payments` | Complete SaaS foundation | `npx @digilogiclabs/create-saas-app create web ui-auth-payments saas-app` |
+| `ui-auth-ai` | Text & chat AI platform | `npx @digilogiclabs/create-saas-app create web ui-auth-ai text-ai-app --with-ai=text` |
+| `ui-auth-payments-ai` | Full AI SaaS platform | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-platform --with-ai=all` |
+| `ui-auth-payments-audio` | Audio streaming SaaS | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform` |
+| `ui-auth-payments-video` | Video streaming SaaS | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio` |
+| `ui-package-test` | Component testing env | `npx @digilogiclabs/create-saas-app create web ui-package-test component-test` |
+
+#### **📱 Mobile Templates (3)**
+| Template | Description | Command |
+|----------|-------------|---------|
+| `base` | React Native + Expo starter | `npx @digilogiclabs/create-saas-app create mobile base mobile-app` |
+| `ui-auth-payments` | Full mobile SaaS (v0.22.0) | `npx @digilogiclabs/create-saas-app create mobile ui-auth-payments mobile-saas` |
+| `ui-auth-payments-ai` | Mobile AI SaaS with generation | `npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai ai-mobile-app --with-ai=all` |
+
+#### **🚀 Cross-Platform Templates**
+| Template | Description | Command |
+|----------|-------------|---------|
+| `ui-auth-payments` | Web + Mobile SaaS | `npx @digilogiclabs/create-saas-app create both ui-auth-payments fullstack-app` |
+| `ui-auth-payments-ai` | Web + Mobile AI platform | `npx @digilogiclabs/create-saas-app create both ui-auth-payments-ai ai-fullstack --with-ai=all` |
+
+### **🛠 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
+```
+
+### **💡 Usage Examples**
+
+#### **Beginner: Interactive Mode**
+```bash
+# Let the CLI guide you through all options
+npx @digilogiclabs/create-saas-app create
+```
+
+#### **Advanced: Direct Commands**
+```bash
+# Full AI platform with all features
+npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai my-ai-saas \
+  --with-ai=all \
+  --ai-provider=openai \
+  --theme=startup \
+  --theme-color=purple \
+  --auth=supabase \
+  --database=supabase
+
+# Mobile-first AI app
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai mobile-ai-app \
+  --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**
@@ -31,19 +159,17 @@
 ## 🚀 Quick Start
 
 ```bash
-# 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 platform
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform
+# Interactive mode (recommended)
+npx @digilogiclabs/create-saas-app create
 
-# Create a video generation platform  
-npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studio
-
-# Create a simple authentication app
-npx @digilogiclabs/create-saas-app create web ui-auth simple-app
+# 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**
@@ -67,7 +193,9 @@ npx @digilogiclabs/create-saas-app create web ui-auth simple-app
 
 ## 🎨 Template Gallery
 
-Choose from **11 production-ready templates** across web and mobile platforms:
+> 📋 **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)**
 
@@ -180,7 +308,7 @@ Component testing environment for package development
 npx @digilogiclabs/create-saas-app create web ui-package-test component-test
 ```
 
-### 📱 **Mobile Templates (2 Available)**
+### 📱 **Mobile Templates (3 Available)**
 
 #### **Base Mobile** (`base`)
 React Native + Expo starter for mobile development
@@ -204,6 +332,19 @@ Full mobile SaaS platform with native UI v0.22.0
 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
+
+```bash
+npx @digilogiclabs/create-saas-app create mobile ui-auth-payments-ai ai-mobile-app --with-ai=all
+```
+
 ### 🚀 **Cross-Platform Templates**
 
 #### **Full Stack Platform** (`ui-auth-payments`)