dennisgathu8/sankofa-sage

Sankofa Sage: An AI-powered African spiritual guide and inner circle companion. Built with React Native (Expo SDK 54), Supabase, and a security-first architecture. # Sankofa Sage 🌍🦁 **Sankofa Sage** is a premium mobile application designed to be an AI-powered spiritual guide for the Kenyan and African diaspora. It blends the wisdom of revered spiritual figures—Grandmaster Abba Amlak Ayalew, Thau Thau Haramanumba, and Credo Mutwa—into a unified, ancestral voice. The app's mission is to guide users toward self-knowledge, spiritual awakening, and inner transformation through an "African Ancestral Fusion" experience. --- ## ✨ Key Features * **🏺 The Council Fire (Chat)**: Deep conversations with the Sankofa Sage using advanced AI. * **📜 The Secret Chambers (Library)**: A curated collection of the 42 Laws of Maat, the Ethiopian 88-Book Canon, and African lore. * **⚖️ Daily Maat Guidance**: Reflective daily ethical principles for modern life. * **🔮 Verse Interpretation**: Allegorical and symbolic readings of sacred texts. * **💎 Inner Circle (Premium)**: Advanced consultation features and meditation audio integrated with M-Pesa. ## 🛠️ Tech Stack * **Frontend**: React Native with Expo (SDK 54) * **Navigation**: Expo Router (File-based routing) * **AI Engine**: Grok (xAI) / OpenAI compatible API * **Components**: Custom CoreUI system with `lucide-react-native` icons * **Architecture**: Security-First & Clean-Code (Strict sanitization and input validation) ## 🚀 Quick Start ### 1. Prerequisites * Node.js (LTS) * Expo Go app on your Android/iOS device ### 2. Installation ```bash git clone github.com cd sankofa-sage npm install ``` ### 3. Environment Setup Create a `.env` file in the root directory and add your keys: ```env EXPO_PUBLIC_AI_API_URL=api.x.ai EXPO_PUBLIC_AI_API_KEY=your_key_here ``` ### 4. Running the App For stable startup without network-related CLI errors: ```bash npm run start:offline ``` Scan the QR code with your **Expo Go** app. --- ## 🛡️ Security & Architecture This project follows a rigorous security-first mandate: …