Mrhonest255/swahili-speaker

# Safari Speak - Learn Swahili for Your Safari Adventure 🦁 Building a bridge between travelers and East African culture through language. ## 🚀 Features * **Learn Essentials:** Curated lessons for tourists (Greetings, Transport, Dining). * **AI Pronunciation Coach:** Real-time feedback on your Swahili pronunciation using Gemini AI. * **Audio Lessons:** Text-to-speech generation for all phrases. * **Admin Dashboard:** Generate new lessons instantly with AI. * **Gamification:** Earn XP, track progress, and unlock achievements. ## 🛠️ Configuration & API Keys This app uses **Google Gemini AI** for audio and pronunciation features. You can configure the API key in two ways: ### 1. For All Users (Production / "Global") To allow ALL users to use the app without entering their own key (e.g., when you share the link): * Create a `.env.local` file in the root directory. * Add: `VITE_GEMINI_API_KEY=your_actual_api_key_here` * **Note:** If deploying to Vercel/Netlify, add `VITE_GEMINI_API_KEY` in their "Environment Variables" settings. ### 2. For Testing (Local / "Admin Panel") If you don't want to expose your key or are just testing: * Open the app. * Go to **Admin Portal** (footer link) or **Settings** tab. * Paste your key there. * *This only saves the key for YOU in your current browser.* ## 💻 Run Locally **Prerequisites:** Node.js 18+ 1. **Install dependencies:** ```bash npm install ``` 2. **Start the development server:** ```bash npm run dev ``` 3. Open localhost to view it in the browser. ## 📦 Deployment When ready to share: ```bash npm run build ``` Upload the `dist` folder to any static host (Vercel, Netlify, GitHub Pages). ## 📄 License MIT