l-isaro/RiseMasterFrontend

# RISEMASTER Frontend **RISEMASTER** is an AI-powered adaptive mathematics learning platform for Rwandan secondary school students (S1–S6). It uses real REB national examination past papers, step-by-step guidance, teen-friendly concept introductions, multi-level hints, and **Bayesian Knowledge Tracing (BKT)** to track and celebrate individual learning progress — promoting a growth mindset over final scores. This repository contains the **frontend web application**. > **Full Title:** Modeling Individual Educational Gain in STEM: An AI-Powered Platform for Tracking and Rewarding Learning Progress in African Higher Education --- ## Table of Contents - Prerequisites - Getting Started - Available Scripts - Routing - API Integration - Bayesian Knowledge Tracing - Testing - Linting - Features - Screenshots ## Prerequisites - **Node.js** ≥ 18 (LTS recommended) - **npm** ≥ 9 (ships with Node) — or **Bun** ≥ 1.0 --- ## Getting Started ### 1. Clone the repository ```bash git clone github.com /RiseMasterFrontend.git cd RiseMasterFrontend ``` ### 2. Install dependencies ```bash # Using npm npm install # Or using Bun bun install ``` ### 3. Start the development server ```bash npm run dev ``` The app will be available at **http://localhost:8080**. ### 4. Build for production ```bash npm run build ``` The output will be in the `dist/` directory. Preview it locally with: ```bash npm run preview ``` --- ## Available Scripts | Command | Description | | -------------------- | ------------------------------------------------ | | `npm run dev` | Start Vite dev server on port 8080 | | `npm run build` | Production build (TypeScript check + Vite build) | | `npm run build:dev` | Development build (unminified, with source maps) | | `npm run preview` | Preview the production build locally | | `npm run lint` | Run ESLint across the codebase | | ` …