A React-based offline mock exam application designed for students in Nigeria with limited internet access.

• View available mock exams
• Take mock exams offline
• Receive instant feedback and scores
• Review detailed answers and explanations
• Track personal performance history

• Create, edit, update, and delete exam questions
• Organize questions into mock exams
• View student performance statistics
• Manage user accounts locally

• Frontend: React with TypeScript
• Routing: React Router
• State Management: React Context API
• Local Storage: IndexedDB for offline data persistence
• Styling: TailwindCSS
• PWA Support: For offline installation and usage

├── backend/
│   └── index.ts             # HTTP entry point for the application
├── frontend/
│   ├── components/
│   │   ├── admin/           # Teacher/Admin components
│   │   ├── student/         # Student components
│   │   ├── shared/          # Shared UI components
│   │   └── App.tsx          # Main application component
│   ├── contexts/            # React Context providers
│   ├── hooks/               # Custom React hooks
│   ├── pages/               # Page components
│   ├── services/            # Service layer for data access
│   ├── types/               # TypeScript type definitions
│   ├── utils/               # Utility functions
│   ├── index.html           # Main HTML template
│   └── index.tsx            # Frontend entry point
└── shared/
    ├── database/            # IndexedDB schema and operations
    └── models/              # Shared data models

1. Clone the repository
2. Install dependencies
3. Run the development server
4. Build for production

This application is designed to work completely offline. All data is stored locally in the browser's IndexedDB storage. The application can be installed as a PWA for offline access.

MIT