IsaacJootar/GonaAfrica

AI Visibility Engine for African Businesses # GonaAfrica GonaAfrica is a Laravel-based AI visibility platform for African businesses. It combines a public AI visibility check, an admin workspace for managed client operations, and a client portal for reporting and visibility improvement workflows. ## Product Areas - Public lead magnet: free AI visibility check at `/check` - Admin portal: organization onboarding, audits, reporting, readiness, content, schema, competitors, reviews, and intelligence - Client portal: dashboards, prompts, competitors, readiness, share of voice, FAQ, reports, and profile management - AI services: prompt generation, AI querying, mention detection, sentiment analysis, scoring, and share-of-voice tracking ## Stack - PHP 8.2+ - Laravel 12 - MySQL-compatible database for primary app runtime - SQLite-compatible tests - Vite + Tailwind CSS - Laravel Horizon, Telescope, and queue workers - OpenAI via `openai-php/laravel` ## Supported Today - Live adapter support: `OpenAI / ChatGPT`, `Gemini`, `Perplexity`, `Claude`, and `Grok` - Runtime rule: a provider only runs when it is enabled in admin settings and its API key is present - Free public audit scope: 3 prompts per submission ## Planned Next - Manus audit support - Broader model-by-model comparison reporting ## Provider Registry The app now ships with a staged provider registry for: - `OpenAI / ChatGPT` - `Gemini` - `Perplexity` - `Claude` - `Grok` - `Manus` This does not mean all of them are live in the audit pipeline yet. It means: - each provider has a named platform entry - each provider has reserved `.env` variables for API key and default model - the admin settings screen can enable, disable, and choose a preferred default provider - the runtime fails clearly when enabled providers are missing keys or adapters - the runtime dispatches audits across every enabled provider that is truly runnable ## Local Setup 1. Install PHP, Composer, Node.js, and a database supported by your `.env` 2. Copy environment variables if nee …