moai-adk 0.25.4__py3-none-any.whl → 0.32.8__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-platform-baas/SKILL.md

@@ -0,0 +1,290 @@
+---
+name: moai-platform-baas
+description: Comprehensive unified BaaS (Backend-as-a-Service) integration hub for 9 major providers: Auth0, Clerk, Firebase Auth, Supabase, Neon, Convex, Firebase Firestore, Vercel, and Railway with AI-powered provider selection, cross-provider patterns, and migration guides.
+version: 2.0.0
+aliases: [moai-platform-baas]
+category: platform
+modularized: false
+updated: 2025-11-27
+status: active
+tags:
+ - platform
+ - baas
+ - backend
+ - integration
+ - firebase
+ - supabase
+ - auth0
+ - clerk
+ - vercel
+ - railway
+allowed-tools: Read, Write, Bash, Grep, Glob
+# 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
+
+| Category | Providers | Key Strength |
+|----------|-----------|--------------|
+| Authentication | Auth0, Clerk, Firebase Auth | SSO, Modern Auth, Google Integration |
+| Database | Supabase, Neon, Convex, Firestore | PostgreSQL 16, Serverless, Real-time |
+| Deployment | Vercel, Railway | Edge Optimization, Full-stack |
+
+### 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
+```python
+# 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:
+```python
+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:
+```python
+# 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):
+```python
+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
+
+---
+
+## 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](reference.md) - Comprehensive provider documentation
+- [examples.md](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)