Moai Platform Baas

⚠️ UV Script Migration Notice

All 2 UV CLI scripts have been consolidated into the builder-skill-uvscript skill on 2025-11-30.

New script locations:

• builder-skill_select_provider.py (previously provider_selector.py)
• builder-skill_migrate_provider.py (previously migration_helper.py)
• Find all scripts in: .claude/skills/builder-skill-uvscript/scripts/

Usage: uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_select_provider.py

This skill retains its BaaS knowledge base and integration patterns.

moai-platform-baas: Comprehensive BaaS Integration Hub

Quick Reference (30 seconds)

Enterprise BaaS Provider Unification: One skill to manage authentication, database, and deployment across 9 major BaaS providers with AI-powered provider selection, cross-provider integration patterns, and automated migration assistance.

Core Provider Matrix

Key Capabilities

• ✅ AI Provider Selection: Automatically choose optimal providers based on requirements
• ✅ Cross-Provider Integration: Seamless setup between auth, database, and deployment
• ✅ Migration Guides: Step-by-step migration between any providers
• ✅ Production Patterns: Enterprise-ready configurations and security
• ✅ Cost Optimization: Provider-specific cost analysis and recommendations
• ✅ Context7 Integration: Latest API documentation and best practices

When to Use

• New Project: AI-driven provider selection for optimal stack
• Migration: Smooth transition between BaaS providers
• Multi-Provider: Complex integrations across different services
• Cost Optimization: Analyze and reduce BaaS infrastructure costs
• Security Audits: Ensure compliance across all providers

Quick Provider Selection

# AI-powered provider recommendation
ai_selector = BaaSProviderSelector()
recommendation = ai_selector.select_optimal_stack({
    "requirements": ["scalable", "real-time", "enterprise"],
    "tech_stack": "Next.js",
    "team_size": 5,
    "budget": "$500/month"
})
# Returns: { auth: "Clerk", database: "Supabase", deployment: "Vercel" }

Implementation Guide

Phase 1: AI Provider Selection & Setup

Requirements Analysis & Provider Selection:

async def analyze_baas_requirements(project_context: ProjectContext) -> ProviderRecommendation:
    """AI-powered provider selection based on project requirements."""
    
    # Get latest Context7 documentation for all providers
    context7_docs = await fetch_all_provider_docs()
    
    # Analyze requirements against provider capabilities
    analysis = ProviderAnalyzer().analyze_requirements(project_context, context7_docs)
    
    # Generate weighted recommendation
    return ProviderRecommender().generate_recommendation(analysis)

Unified Provider Configuration:

# Unified provider setup (works for all 9 providers)
provider_manager = UnifiedBaaSManager()

# Authentication setup
auth_config = provider_manager.configure_auth({
    "provider": "clerk",  # or "auth0", "firebase-auth"
    "features": ["social_auth", "mfa", "organizations"]
})

# Database setup  
db_config = provider_manager.configure_database({
    "provider": "supabase",  # or "neon", "convex", "firestore"
    "schema_path": "./schema.sql",
    "migrations": True
})

# Deployment setup
deploy_config = provider_manager.configure_deployment({
    "provider": "vercel",  # or "railway"
    "framework": "nextjs",
    "environment": "production"
})

Phase 2: Authentication Providers

Auth0 (Enterprise SSO Focus):

• Enterprise SSO with 50+ connections (SAML, OIDC, ADFS)
• B2B SaaS with organizations and RBAC
• Custom database connections and advanced security

Clerk (Modern Auth Focus):

• Modern WebAuthn and passkey support
• Built-in organization management
• Multi-platform SDKs and beautiful UI components

Firebase Auth (Google Integration):

• Deep Google services integration
• Firebase Analytics and Cloud Functions
• Mobile-first design with Google Cloud integration

Phase 3: Database Providers

Supabase (PostgreSQL 16+ Focus):

• PostgreSQL 16 with pgvector and AI extensions
• Row-Level Security for multi-tenant apps
• Real-time subscriptions and Edge Functions

Neon (Serverless PostgreSQL):

• Auto-scaling serverless PostgreSQL
• Instant database branching
• 30-day Point-in-Time Recovery

Convex (Real-time Backend):

• Real-time reactive queries and optimistic updates
• Instant database branching for development
• TypeScript-first design with built-in caching

Firebase Firestore (Mobile Focus):

• Real-time synchronization with offline caching
• Mobile-first SDKs for iOS and Android
• Google ecosystem integration

Phase 4: Deployment Platforms

Vercel (Edge Deployment):

• Global edge network with Next.js optimization
• Edge Functions and zero-config deployments
• Analytics and built-in observability

Railway (Full-stack Containers):

• Full-stack container deployment with Docker
• Multi-region support and built-in CI/CD
• Environment variables management

Phase 5: Cross-Provider Integration

Modern Web Stack (Vercel + Clerk + Supabase):

class ModernWebStack:
    """Vercel + Clerk + Supabase integration."""
    
    def setup_integration(self):
        """Seamless integration setup."""
        return {
            "authentication": "clerk",
            "database": "supabase", 
            "deployment": "vercel",
            "real_time_features": True,
            "server_functions": True,
            "edge_optimization": True
        }

Enterprise Stack (Auth0 + Supabase + Vercel):

• Enterprise SSO with 50+ connections
• PostgreSQL 16 with Row-Level Security
• Global edge performance

Real-time Stack (Clerk + Convex + Vercel):

• Modern authentication with organizations
• Real-time collaborative features
• Edge performance for global users

Provider Selection Decision Trees

Authentication Provider Selection

Need Enterprise SSO with 50+ connections?
  ├─ YES → Auth0 (Enterprise grade)
  │        ├─ B2B SaaS focus? → Auth0 Organizations
  │        └─ General enterprise? → Auth0 Enterprise
  └─ NO → Need modern WebAuthn?
           ├─ YES → Clerk (Passwordless)
           │        ├─ Organizations needed? → Clerk Pro
           │        └─ Simple auth only? → Clerk Starter
           └─ NO → Google ecosystem integration?
                    ├─ YES → Firebase Auth
                    └─ NO → Clerk (default)

Database Provider Selection

Need PostgreSQL with advanced features?
  ├─ YES → Real-time subscriptions required?
  │        ├─ YES → Supabase (PostgreSQL 16 + pgvector)
  │        └─ NO → Neon (Serverless PostgreSQL)
  └─ NO → Real-time collaborative features?
           ├─ YES → Convex (Real-time backend)
           └─ NO → Mobile-first app?
                    ├─ YES → Firestore (Mobile optimized)
                    └─ NO → Supabase (default)

Deployment Platform Selection

Edge performance critical?
  ├─ YES → Vercel (Edge optimization)
  │        ├─ Next.js app? → Vercel (optimized)
  │        └─ Other framework? → Vercel (universal)
  └─ NO → Full-stack container needed?
           ├─ YES → Railway (Container optimized)
           │        ├─ Multi-region? → Railway Pro
           │        └─ Single region? → Railway Standard
           └─ NO → Vercel (default)

Real-World Integration Examples

Example 1: Enterprise SaaS Application

• Stack: Auth0 + Supabase + Vercel
• Features: Multi-tenant architecture, enterprise SSO, global edge performance
• Cost: $800-1200/month
• Setup Time: 2-3 days

Example 2: Modern Web Application

• Stack: Clerk + Neon + Vercel
• Features: Passwordless auth, serverless database, edge functions
• Cost: $200-400/month
• Setup Time: 1-2 days

Example 3: Real-time Collaborative Platform

• Stack: Clerk + Convex + Vercel
• Features: Real-time sync, database branching, collaborative editing
• Cost: $300-600/month
• Setup Time: 2-4 days

Available Scripts

This skill includes two UV CLI scripts for automated BaaS provider selection and migration planning:

1. Provider Selector (provider_selector.py)

Purpose: Interactive BaaS provider selection based on user requirements

Usage:

# Basic usage
uv run scripts/provider_selector.py --auth oauth --database postgres --hosting serverless --budget hobby

# JSON output
uv run scripts/provider_selector.py --auth jwt --database realtime --budget professional --json

# Minimal options (uses defaults)
uv run scripts/provider_selector.py --database postgres --budget free

Features:

• AI-powered provider scoring based on requirements
• Cost estimation per budget tier
• Alternative provider recommendations
• Dual output modes (human-readable and JSON)

Options:

• --auth: Authentication type (oauth, jwt, passkey, session)
• --database: Database type (postgres, firestore, realtime, none)
• --hosting: Hosting preference (serverless, containers, static, any)
• --budget: Budget tier (free, hobby, professional, enterprise)
• --json: Output as JSON

2. Migration Helper (migration_helper.py)

Purpose: Generate migration scripts and checklists for moving between BaaS providers

Usage:

# Full migration (auth, database, storage)
uv run scripts/migration_helper.py --from firebase --to supabase --components auth db storage

# Auth-only migration
uv run scripts/migration_helper.py --from auth0 --to clerk --components auth --json

# Database migration
uv run scripts/migration_helper.py --from firestore --to neon --components db

Features:

• Step-by-step migration plans
• Code snippets for each migration phase
• Risk analysis and mitigation strategies
• Rollback planning
• Complexity and time estimates

Options:

• --from: Source provider (firebase, auth0, clerk, supabase, etc.)
• --to: Target provider (supabase, clerk, neon, vercel, etc.)
• --components: Components to migrate (auth, db, storage) - can specify multiple
• --json: Output as JSON

Advanced Patterns & Migration

Migration Engine: Automated migration between any providers with data transformation and verification

Cost Optimization: AI-powered cost analysis and recommendations for optimal provider configurations

Security Compliance: Unified security framework supporting GDPR, HIPAA, and enterprise compliance requirements

Multi-Region Deployment: Global deployment strategies with automatic failover and data residency

For detailed implementation patterns, migration scripts, and cost optimization examples, see:

• reference.md - Comprehensive provider documentation
• examples.md - Production-ready implementation examples

Works Well With

• moai-context7-integration - Latest BaaS provider documentation and API patterns
• moai-domain-frontend - Frontend integration patterns for BaaS providers
• moai-domain-backend - Backend architecture patterns for BaaS integration
• moai-security-api - BaaS security best practices and compliance
• moai-cloud-aws-advanced - AWS integration with BaaS providers
• moai-foundation-trust - Quality validation for BaaS implementations

Status: Production Ready (Enterprise) Generated with: MoAI-ADK Skill Factory v2.0 Last Updated: 2025-11-25 Providers Covered: 9 major BaaS services (Auth0, Clerk, Firebase Auth, Supabase, Neon, Convex, Firestore, Vercel, Railway)