swervendy/african-exam-prep

A world-class African exam preparation and tutoring platform powered by AI. Practice JAMB questions and get personalized tutoring for free. # African Exam Prep A world-class African exam preparation and tutoring platform powered by AI. Practice JAMB questions and get personalized tutoring for free. ## 🚀 Features ### 📚 Test Practice - **Multiple Subjects**: English, Mathematics, Biology, Physics, Chemistry, and more - **Past Questions**: Access to real JAMB past questions - **Adaptive Learning**: Questions are shuffled for better practice - **Score Tracking**: Monitor your progress with detailed scoring - **Session Management**: Track your study sessions and progress ### 🤖 AI Tutoring - **Personalized Explanations**: Get detailed explanations for any question - **Step-by-Step Guidance**: Break down complex problems - **Conversation History**: Review your tutoring sessions - **Voice Synthesis**: Listen to explanations (coming soon) ### 📱 User Experience - **Mobile-First Design**: Optimized for mobile devices - **Dark Mode Support**: Comfortable viewing in any lighting - **Responsive Layout**: Works seamlessly across all devices - **Accessibility**: Built with accessibility in mind ## 🛠️ Tech Stack ### Frontend - **Next.js 13** - React framework with App Router - **TypeScript** - Type-safe JavaScript - **Tailwind CSS** - Utility-first CSS framework - **FontAwesome** - Icon library ### Backend - **Next.js API Routes** - Serverless API endpoints - **OpenAI GPT-4** - AI-powered tutoring - **Vercel Postgres** - Primary database - **MongoDB** - Additional data storage - **Azure Blob Storage** - File storage ### Development - **ESLint** - Code linting - **Prettier** - Code formatting - **Jest** - Testing framework ## 📦 Installation ### Prerequisites - Node.js 18+ - npm or yarn - Vercel account (for deployment) ### Setup 1. **Clone the repository** ```bash git clone github.com cd africanexamprep ``` 2. **Install dependencies** ```bash npm install ``` 3. **Set up environment variables** Create a `.env.local` file in the root directory: ```env # OpenAI OPENAI_ …