@digilogiclabs/create-saas-app 2.9.1 → 2.11.0

package/README.md

@@ -15,11 +15,17 @@ Get started instantly with our most popular, production-ready templates:
 # 💳 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
+# 🚀 Micro SaaS Starter (Landing + Auth + Dashboard)
+npx @digilogiclabs/create-saas-app create web micro-saas my-micro-saas
+
+# 🛒 Digital Marketplace (Products, Cart, Orders)
+npx @digilogiclabs/create-saas-app create web marketplace my-marketplace
 
-# 🧠 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
+# 🤖 AI-Powered SaaS Platform (Chat, Models, Playground)
+npx @digilogiclabs/create-saas-app create web ai-platform my-ai-app --with-ai=all
+
+# 📡 IoT Dashboard (Devices, Telemetry, Alerts)
+npx @digilogiclabs/create-saas-app create web iot-dashboard my-iot-app
 
 # 🎵 Audio Streaming SaaS (Music/Podcast Platform)
 npx @digilogiclabs/create-saas-app create web ui-auth-payments-audio music-platform
@@ -29,9 +35,6 @@ npx @digilogiclabs/create-saas-app create web ui-auth-payments-video video-studi
 
 # 📱 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
@@ -52,16 +55,23 @@ npx @digilogiclabs/create-saas-app create --help
 
 ### **📋 All Available Templates (16 Total)**
 
-#### **🌐 Web Templates (11)**
+#### **🌐 Web Templates (13)**
 
-**💎 Premium SaaS Templates**
+**🏗️ Vertical Templates (Full App Flows)**
+| Template | Description | Pages | Command |
+|----------|-------------|-------|---------|
+| `micro-saas` | **Micro SaaS Starter** | Landing, Login, Signup, Dashboard | `npx @digilogiclabs/create-saas-app create web micro-saas my-saas` |
+| `marketplace` | **Digital Marketplace** | Landing, Auth, Products, Cart, Orders, Dashboard, Settings | `npx @digilogiclabs/create-saas-app create web marketplace my-shop` |
+| `ai-platform` | **AI Platform** | Landing, Auth, Chat, Models, Playground, Dashboard, Settings | `npx @digilogiclabs/create-saas-app create web ai-platform my-ai --with-ai=all` |
+| `iot-dashboard` | **IoT Dashboard** | Landing, Auth, Devices, Device Detail, Alerts, Dashboard, Settings | `npx @digilogiclabs/create-saas-app create web iot-dashboard my-iot` |
+
+**💎 Tier Templates (Composable Foundation)**
 | 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` |
+| `ui-auth-payments-ai` | **AI-Powered SaaS** | Full AI Suite (Text, Audio, Video) | `npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai ai-app --with-ai=all` |
+| `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 |
@@ -72,19 +82,13 @@ npx @digilogiclabs/create-saas-app create --help
 | `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)**
+#### **📱 Mobile Templates (3)**
 
-**💎 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` |
+| Template              | Description                 | Features                    | Command                                                                                            |
+| --------------------- | --------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------- |
+| `base`                | React Native + Expo starter | Minimal mobile setup        | `npx @digilogiclabs/create-saas-app create mobile base mobile-app`                                 |
+| `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` |
 
 ### **🤖 AI Capabilities Reference**
 
@@ -94,7 +98,6 @@ npx @digilogiclabs/create-saas-app create --help
 | `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`)**
@@ -161,14 +164,12 @@ npx @digilogiclabs/create-saas-app create web ui-auth-payments-ai content-ai \
   --theme-color=blue
 ```
 
-**🧠 Knowledge Base & AI Assistant**
+**📡 IoT Dashboard**
 
 ```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 \
+# Real-time IoT monitoring platform
+npx @digilogiclabs/create-saas-app create web iot-dashboard iot-monitor \
+  --theme=default \
   --theme-color=green
 ```
 
@@ -230,32 +231,26 @@ npx @digilogiclabs/create-saas-app create web ui-auth-payments prototype \
 - **Mobile Only**: Use `mobile` platform
 - **Universal**: Use `both` platform (web + mobile)
 
-## 🎉 What's New in v1.13.0
+## 🎉 What's New in v2.10.0
 
-### 🤖 **Complete AI Integration**
+### 🏗️ **Complete Vertical Templates**
 
-- **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
+- **4 vertical templates** with full app flows: Micro SaaS, Marketplace, AI Platform, IoT Dashboard
+- **Working auth out of the box** - Demo cookie-based session (swap for Keycloak/Supabase in production)
+- **30+ pages** across verticals: landing, login, signup, dashboard, settings, and domain-specific pages
 
-### 🎨 **Enhanced UI Library**
+### 🎨 **Design System Compliance**
 
-- **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
+- **Tailwind v4 migration** - All templates use `@theme` block with CSS custom properties
+- **Zero hardcoded structural colors** - Everything uses semantic tokens (`bg-background`, `text-foreground`, etc.)
+- **Brand-specific tokens** - Purple (AI), Emerald (IoT), Blue (Marketplace/SaaS)
+- **Skip-to-content** accessibility links in all 12 layouts
 
-### 🔐 **Expanded Authentication**
+### 📋 **Design Principles**
 
-- **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
+- **Unified DESIGN_PRINCIPLES.md** - 22-section source of truth for all apps and templates
+- **Search/Filter/Sort standard** - Global search vs page filters, debounce, URL state
+- **20 quality standards** - Page composition, z-index, density, interaction states, content/copy, and more
 
 ## 🚀 Quick Start
 
@@ -282,7 +277,7 @@ npx @digilogiclabs/create-saas-app create web ui-auth-payments saas-app
 
 ### 🏗️ **Production-Ready Stack**
 
-- **Next.js 15.3** with App Router and Server Components
+- **Next.js 15.5** with App Router and Server Components
 - **TypeScript** throughout with strict typing
 - **Supabase** for database, auth, and real-time features
 - **Stripe** for payments and subscriptions
@@ -299,9 +294,66 @@ npx @digilogiclabs/create-saas-app create web ui-auth-payments saas-app
 
 > 📋 **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:
+Choose from **16 production-ready templates** across web and mobile platforms:
+
+### 🌐 **Web Templates (13 Available)**
+
+#### **Vertical Templates (Full App Flows)**
+
+##### **Micro SaaS** (`micro-saas`)
+
+Complete micro SaaS starter with landing page and auth
+
+- **Landing page** - Hero, features, pricing CTA
+- **Authentication** - Login, signup with demo auth
+- **Dashboard** - Stats, quick actions, user profile
+- **Design system** - Tailwind v4 tokens, dark/light mode
+
+```bash
+npx @digilogiclabs/create-saas-app create web micro-saas my-saas
+```
+
+##### **Digital Marketplace** (`marketplace`)
+
+Full marketplace with products, cart, and seller dashboard
+
+- **Product catalog** - Browse, search, filter, sort
+- **Product detail** - Images, ratings, vendor info, add to cart
+- **Shopping cart** - Quantity controls, order summary, checkout
+- **Seller dashboard** - Stats, orders, product management
+- **Settings** - Profile, notifications, payment methods
+
+```bash
+npx @digilogiclabs/create-saas-app create web marketplace my-shop
+```
+
+##### **AI Platform** (`ai-platform`)
 
-### 🌐 **Web Templates (9 Available)**
+AI chat and model management platform
+
+- **AI Chat** - Multi-model chat with conversation history
+- **Models catalog** - Browse providers (OpenAI, Anthropic, Google)
+- **API Playground** - Test prompts with temperature/token controls
+- **Dashboard** - Usage stats, credits, API keys
+- **Settings** - Profile, API key management, billing
+
+```bash
+npx @digilogiclabs/create-saas-app create web ai-platform my-ai-app --with-ai=all
+```
+
+##### **IoT Dashboard** (`iot-dashboard`)
+
+Real-time IoT monitoring and device management
+
+- **Device management** - List, detail, add, filter by status/type
+- **Live telemetry** - Real-time sensor data (temperature, humidity, pressure)
+- **Alerts center** - Severity-based alerts with acknowledge flow
+- **Dashboard** - Stats, device status, recent alerts
+- **Settings** - Profile, notifications, API key
+
+```bash
+npx @digilogiclabs/create-saas-app create web iot-dashboard my-iot-app
+```
 
 #### **Core Templates**
 
@@ -430,7 +482,7 @@ Component testing environment for package development
 npx @digilogiclabs/create-saas-app create web ui-package-test component-test
 ```
 
-### 📱 **Mobile Templates (5 Available)**
+### 📱 **Mobile Templates (3 Available)**
 
 #### **Base Mobile** (`base`)
 
@@ -475,21 +527,6 @@ Complete mobile AI platform with generation capabilities
 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`)
@@ -706,49 +743,52 @@ Built-in validation ensures your app is deployment-ready:
 
 ## 📦 Package Ecosystem
 
-### 🎨 **UI & Design** (v0.27.1)
+### 📦 **Platform Core** (v1.14.0)
 
-- **@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
+- **@digilogiclabs/platform-core** - Vendor-agnostic backend toolkit
+- **34 interfaces** - IDatabase, ICache, IEmail, IStorage, IQueue, ITenant, IAI, and more
+- **Production adapters** - PostgreSQL, Redis, S3/R2, SMTP, BullMQ, Stripe, OpenAI, Anthropic
+- **Enterprise patterns** - Retry, circuit breaker, rate limiting, multi-tenancy
+- **1,363+ tests** - All features testable with in-memory adapters
+
+### 🎨 **UI & Design** (v1.8.3)
+
+- **@digilogiclabs/saas-factory-ui** - Cross-platform React component library
+- **100+ components** - Cards, buttons, forms, data grids, charts, audio players, and more
+- **Cross-platform** - Single codebase for Next.js + React Native/Expo
+- **Design system** - Surface variants, density modes, motion presets
+- **Accessibility** - WCAG 2.1 AA compliant, SkipToContent, focus management
+- **Tailwind CSS v4** - Design tokens with `@theme` integration
+
+### 🔐 **Authentication** (v5.1.1)
+
+- **@digilogiclabs/saas-factory-auth** - Pluggable authentication
+- **20+ components** - LoginForm, SignupForm, SessionExpiredModal, AccessDeniedScreen
+- **12 OAuth providers** - Google, GitHub, Microsoft, LinkedIn, Spotify, and more
+- **ARIA compliant** - role="alert", aria-live, focus management
+- **Keycloak + Supabase** adapters with platform-core IAuth
+
+### 💳 **Payments** (v5.1.1)
+
+- **@digilogiclabs/saas-factory-payments** - Stripe integration
+- **Multi-provider** - Stripe, Apple Pay, PayPal buttons
+- **Subscription lifecycle** - Create, update, cancel, pause, resume
+- **Webhook handling** - Secure event processing and signature verification
+- **platform-core IPayment** - Provider-agnostic payment interface
+
+### 🤖 **AI Platform** (v8.0.1)
+
+- **@digilogiclabs/saas-factory-ai** - Unified AI interface
+- **Multi-provider** - OpenAI, Anthropic Claude, Google Gemini
+- **Streaming** - Real-time token streaming for chat
+- **Tool calling** - Function calling across all providers
+- **RAG pipeline** - Pinecone and Weaviate vector search adapters
+
+### 📱 **App SDK** (v1.1.0)
+
+- **@digilogiclabs/app-sdk** - Unified React hooks
+- **DLLProvider** - Single context wrapper for auth, payments, data
+- **useAuth, usePayments, useData** - Consistent API across apps
 
 ## 🛠️ Command Reference