# Soma AI - Generative Engine Optimization Platform

> Soma AI is Africa's leading Generative Engine Optimization (GEO) platform that helps brands monitor, analyze, and optimize their visibility across AI-powered search engines like ChatGPT, Claude, Gemini, and Perplexity. Founded in Nairobi, Kenya, we serve 500+ businesses across Africa, Middle East, and Europe with real-time AI brand monitoring, competitive intelligence, and LLM Discoverability Index (LDI) scoring.

**Core Platform Capabilities:**
- Real-time brand mention tracking across 5 LLM models (Llama-3.1-70b, Mixtral-8x7b, Gemma-7b)
- LLM Discoverability Index (LDI) calculation and trend analysis
- Multi-tenant SaaS architecture with Account → Brand → Workspace hierarchy
- Competitive intelligence and market positioning analysis
- Content optimization recommendations for Answer Engine Optimization (AEO)
- Regional market analysis for African, Middle Eastern, and European businesses

**Geographic Focus:** Specialized in emerging markets including South Africa, Nigeria, Kenya, Ghana, UAE, Saudi Arabia, UK, and Germany with local market insights, currency support (ZAR, NGN, AED, GBP, EUR), and region-specific AI optimization strategies.

**Technical Architecture:** Next.js 15 + Supabase multi-tenant platform with Groq API integration, TypeScript throughout, Tailwind CSS + Radix UI components, and comprehensive analytics dashboard.

## Documentation

- [Project Overview and Setup](README.md): Complete platform overview, environment variables, and deployment instructions
- [Technical Implementation Summary](PROJECT_SUMMARY.md): Comprehensive technical documentation including database schema, API endpoints, and architecture decisions
- [Authentication Flow Documentation](AUTHENTICATION_SIMPLIFIED.md): Supabase auth integration with multi-tenant support
- [Brand Intelligence Service](lib/services/brand-intelligence.ts): Core AI-powered brand research and analysis engine
- [LLM Monitoring Service](lib/services/llm-monitoring-service.ts): Real-time brand mention tracking across multiple AI models
- [Multi-tenant Architecture Guide](.github/copilot-instructions.md): Development patterns for Account → Brand → Workspace hierarchy

## API Reference

- [Visibility Report Generation](app/api/reporting/visibility-report/generate/route.ts): Comprehensive AI visibility analysis and reporting
- [Brand Management API](app/api/brands/route.ts): Full CRUD operations for brand management with multi-tenant support
- [LLM Monitoring API](app/api/llm-monitoring/route.ts): Real-time AI model testing and mention tracking
- [Analytics and LDI Calculation](app/api/analytics/llm-indices/route.ts): LLM Discoverability Index scoring and trend analysis
- [Ground Truth Research API](app/api/ground-truth/route.ts): Pure online research capabilities without LLM processing
- [Regional SEO Utilities](lib/seo/meta-tags.ts): Market-specific metadata and optimization tools

## Regional Market Pages

- [South Africa Market](app/south-africa/page.tsx): AI brand monitoring for South African businesses with ZAR pricing and local market focus
- [Nigeria Market](app/nigeria/page.tsx): Fintech and startup-focused GEO services for Nigerian companies
- [UAE Market](app/uae/page.tsx): Premium AI optimization services for Dubai and Abu Dhabi businesses
- [Saudi Arabia Market](app/saudi-arabia/page.tsx): Vision 2030-aligned GEO strategies for Saudi Arabian enterprises
- [United Kingdom Market](app/united-kingdom/page.tsx): Enterprise AI marketing solutions for UK businesses and agencies
- [Germany Market](app/germany/page.tsx): Industry 4.0 and AI optimization for German manufacturing and tech companies

## Component Library

- [Brand Intelligence Dashboard](components/brand-intelligence-dashboard.tsx): Advanced analytics and competitive intelligence interface
- [AI Visibility Report](components/ai-visibility-report.tsx): Comprehensive brand visibility reporting component
- [Brand Creation Dialog](components/brand-creation-dialog.tsx): Multi-step brand onboarding with website analysis
- [Competitive Analysis](components/competitor-analysis.tsx): Real-time competitor tracking and benchmarking
- [Content Optimization](components/content-optimization.tsx): AEO recommendations and content gap analysis

## Business Intelligence

- [African Business GEO Guide](app/blog/geo-for-african-businesses/page.tsx): Expert insights on AI optimization for African companies by founders Danny Kofi-Armah and Dela Agbenyegah
- [European Business GEO Guide](app/blog/geo-for-european-businesses/page.tsx): Specialized strategies for European market AI dominance
- [AI Search Future Analysis](content/blog/ai-search-will-replace-google-by-2026.md): Comprehensive guide to the future of AI-powered search
- [SEO and AI Crawling Strategy](SEO_AI_CRAWLING_STRATEGY.md): Technical implementation guide for AI optimization

## Services Architecture

- [Contextual Brand Analyzer](lib/services/contextual-brand-analyzer.ts): Advanced brand research with website analysis and market intelligence
- [Search Optimization Service](lib/services/search-optimization-service.ts): Multi-locale LDI calculation and market visibility analysis
- [Source Analysis Utilities](lib/utils/source-analyzer.ts): Geographic relevance and authority scoring for content sources
- [Brand Context Research](lib/services/contextual-brand-analyzer.ts): Comprehensive brand intelligence gathering with SerpAPI and Tavily integration

## Optional

- [Database Migrations](supabase/migrations/20250827055000_llm_monitoring_tables.sql): Complete schema for LLM monitoring, LDI snapshots, and analytics
- [Integration Testing Framework](scripts/test-integration.js): Comprehensive testing suite for API endpoints and database operations
- [Onboarding Flow Documentation](ONBOARDING_TECHNICAL_DOCUMENTATION.md): Technical implementation of user onboarding with workspace creation
- [Performance Optimization Guide](PERFORMANCE_OPTIMIZATION_SUMMARY.md): Database indexing and API optimization strategies
- [Production Deployment Guide](PRODUCTION_AUTH_FIX.md): Supabase authentication and environment configuration for production