Darkhold

<h1 align="center"> Darkhold [Beta version ready] </h1> <p align="center"> <a href="https://github.com/surajcm/darkhold/commits/" title="Last Commit"><img src="https://img.shields.io/github/last-commit/surajcm/darkhold?style=flat"></a> <a href="https://github.com/surajcm/darkhold/issues" title="Open Issues"><img src="https://img.shields.io/github/issues/surajcm/darkhold?style=flat"></a> <a href="https://github.com/surajcm/darkhold/actions/workflows/build.yml" title="Java CI"><img src="https://github.com/surajcm/darkhold/actions/workflows/build.yml/badge.svg"></a> <a href="https://github.com/surajcm/darkhold/blob/master/LICENSE" title="License"><img src="https://img.shields.io/badge/License-Apache%202.0-green.svg?style=flat"></a> <a href="https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg" title="code_of_conduct.md"><img src="https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg"></a> <a href="https://github.com/surajcm/darkhold/pulls?q=is%3Apr+is%3Amerged+created%3A2024-10-01..2024-10-31" title="Hacktoberfest 2024 stats"><img src="https://img.shields.io/github/hacktoberfest/2022/surajcm/darkhold?label=Hacktoberfest+2024"></a> </p> <a href="https://foojay.io/today/works-with-openjdk"><img align="right" src="https://github.com/foojayio/badges/blob/0aa8a69ff09d88d650f8a2e9d54b0d43c14b058d/works_with_openjdk/Works-with-OpenJDK.png" width="100"></a>

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

• Github: @surajcm

🐋 Docker

• surajcm/darkhold

🤝 Contributing

Contributions, issues and feature requests are welcome!<br />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 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.