Skip to content

Latest commit

 

History

History
85 lines (63 loc) · 3.82 KB

File metadata and controls

85 lines (63 loc) · 3.82 KB

Darkhold [Beta version ready]

Self-hosted quiz platform, inspired by kahoot. Please note that this is work in progress and not ready for production use. This is maintained by a single developer and contributions are welcome.

Author

👤 Suraj Muraleedharan

🐋 Docker

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page. If you contribute please commit to a new branch and explain details in your pull request not in your commit.

Remember to abide by our adapted from Contributor Covenant 2.1 Code of Conduct too

Show your support

Give a ⭐️ if this project helped you!

Screenshots

Please head over to Wiki

✨ Key Features

🎮 Game Modes

  • Multiplayer - Real-time quiz with live PIN-based join
  • Practice Mode - Solo play with instant feedback
  • Team Mode - Collaborative gameplay with 3 assignment methods (Balanced, Random, Manual)

📝 Question Types

  • Multiple Choice (2-4 options, single or multiple correct answers)
  • True/False
  • Type Answer (with fuzzy matching for typos)
  • Poll (no correct answer, shows distribution)

🎨 Rich Content

  • Image support for questions
  • YouTube video embedding
  • Configurable time limits per question
  • Customizable point values

📊 Analytics & Reports

  • Detailed game results with participant statistics
  • Question-level analytics (success rate, difficulty)
  • CSV export for external analysis
  • Past games history

🌍 Internationalization

  • English (en) - Complete ✅
  • Spanish (es) - Complete ✅
  • French (fr) - Partial (contributors welcome!)
  • German (de) - Partial (contributors welcome!)

🎨 Modern UI/UX

  • Dark/Light mode toggle
  • Sound effects and animations
  • PWA support for mobile
  • Fully responsive design
  • Accessibility features (ARIA, keyboard navigation)

🔧 Technical

  • Spring Boot 4.0 with WebSocket/STOMP for real-time gameplay
  • PostgreSQL or H2 database support
  • Docker & Docker Compose ready
  • Comprehensive test suite (427 tests, 51% coverage)

For detailed installation guides and system requirements, please head over to Wiki.