Skip to content

SahirVhora/11plus-prep

Repository files navigation

🎓 11+ Prep - Interactive Learning Platform

A comprehensive, region-specific exam preparation platform designed to help students master the 11+ entrance exams. This application provides a structured, interactive environment for practicing core subjects and region-specific patterns.

🌟 Key Features

🗺️ Region-Specific Preparation

The platform recognizes that 11+ exams vary significantly by region. It includes dedicated question banks and validation for:

  • Regional Boards: Birmingham, Buckinghamshire, Essex, Hertfordshire, Kent, Lancashire, Lincolnshire, Manchester, Warwickshire, and Yorkshire.
  • Core Subjects: English, Maths, Verbal Reasoning, and Non-Verbal Reasoning.
  • Regional Intelligence: Integrated region info panels and validators to ensure students are studying the correct material for their area.

✍️ Interactive Quiz Engine

  • Smart Sampling: Dynamic question sampling to provide a fresh experience in every session.
  • Performance Tracking: Real-time progress monitoring with a custom quiz timer.
  • Weak Area Analysis: Built-in logic to analyze scores and identify specific areas where the student needs more focus.
  • Adaptive Difficulty: Visual badges to categorize question difficulty levels.

📄 Study Tooling

  • PDF Generation: Ability to generate printable versions of questions and results using jspdf and html2canvas.
  • AI-Powered Content: Integrated with the Anthropic SDK for generating high-quality practice questions.

🛠️ Technical Stack

  • Frontend: React 19, TypeScript, Vite
  • Styling: Tailwind CSS
  • State Management: React Context API
  • Key Libraries:
    • react-router-dom for seamless page navigation.
    • jspdf & html2canvas for document generation.
    • @anthropic-ai/sdk for AI-driven content generation.

🚀 Getting Started

Installation

npm install

Development

npm run dev

Build for Production

npm run build

Utility Commands

To validate the regional data integrity:

npm run validate-regions

📂 Project Structure

  • src/data/questions: JSON-based question banks partitioned by region and subject.
  • src/hooks: Custom hooks for timer management, quiz logic, and score analysis.
  • src/utils: Core logic for PDF generation and regional validation.
  • src/components: Modular UI components split by functionality (Quiz, Home, Region, Shared).