https://github.com/exios66/intro-knowledge-quiz
Supplementary Assessment for Primary Research Project
https://github.com/exios66/intro-knowledge-quiz
Last synced: 5 months ago
JSON representation
Supplementary Assessment for Primary Research Project
- Host: GitHub
- URL: https://github.com/exios66/intro-knowledge-quiz
- Owner: Exios66
- License: mit
- Created: 2024-12-28T23:17:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-30T03:50:00.000Z (over 1 year ago)
- Last Synced: 2025-09-05T01:39:09.132Z (10 months ago)
- Language: HTML
- Homepage: https://exios66.github.io/Intro-Knowledge-Quiz/
- Size: 27.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Knowledge Assessment Quiz 🎓
A modern, interactive web-based quiz application that tests users' knowledge across various subjects including Geography, Chemistry, History, Literature, Astronomy, Psychology, and more. Built with accessibility and user experience in mind.
## ✨ Key Features
- 🎯 Multiple choice questions across diverse academic categories
- 📊 Real-time progress tracking with detailed analytics
- 🎨 Modern, responsive UI design with customizable themes
- ⌨️ Full keyboard navigation and shortcuts support
- 📱 Mobile-first responsive design that works on all devices
- 📈 Comprehensive results with category-wise breakdown and insights
- 🎚️ Adaptive difficulty levels with visual indicators
- 🔄 Session management with quiz restart capability
- 🌐 Offline support with PWA capabilities
- ♿ WCAG 2.1 compliant accessibility features
## 🚀 Getting Started
### Prerequisites
- Any modern web browser
- Local development server (optional but recommended)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/Intro-Knowledge-Quiz.git
cd Intro-Knowledge-Quiz
```
2. Choose one of these methods to run:
- Open `index.html` directly in your browser
- Use a local server (recommended):
```bash
# Using Python
python -m http.server 8000
# Using Node.js
npx serve
```
## 🎮 Usage Guide
### Basic Navigation
- Select answers by clicking or using number keys (1-4)
- Use arrow keys or buttons for question navigation
- Track progress through the visual progress bar
- Review detailed performance analytics after completion
### Keyboard Shortcuts
| Key | Action |
|---------------|---------------------------|
| 1-4 | Select answer choice |
| ←/→ | Previous/Next question |
| Space | Submit answer |
| R | Restart quiz |
| Esc | Exit current session |
## 🔧 Technical Architecture
### Core Technologies
- HTML5 with semantic markup
- CSS3 with modern features:
- CSS Grid & Flexbox
- Custom Properties
- CSS Animations
- Media Queries
- Vanilla JavaScript (ES6+)
- Progressive Web App (PWA) support
### Performance Features
- Lazy loading of images and resources
- Optimized asset delivery
- Caching strategies for offline use
- Minimal external dependencies
## 🌐 Browser Compatibility
Thoroughly tested and supported on:
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+
- Opera 76+
- Mobile browsers (iOS Safari, Chrome for Android)
## 🤝 Contributing
We welcome contributions! Here's how you can help:
1. Fork the repository
2. Create your feature branch:
```bash
git checkout -b feature/AmazingFeature
```
3. Commit your changes:
```bash
git commit -m 'Add some AmazingFeature'
```
4. Push to the branch:
```bash
git push origin feature/AmazingFeature
```
5. Open a Pull Request
### Development Guidelines
- Follow existing code style
- Add comments for complex logic
- Update documentation as needed
- Include tests for new features
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- Font Awesome for comprehensive icon set
- Modern CSS Reset by Andy Bell
- Quiz content curated from verified educational sources
- Open source community for inspiration and tools
## 📞 Support
- Create an issue for bug reports
- Join our Discord community for discussions
- Check the wiki for additional documentation