Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
208 changes: 208 additions & 0 deletions submissions/Team-valquiz
Original file line number Diff line number Diff line change
@@ -0,0 +1,208 @@
# Project Name

ValQuiz — Real-Time Multiplayer Quiz Powered by Valkey
Comment on lines +1 to +3

---

## Attendee/Team Details

### Team Lead

**Name:** Abdul Samad Yaqoob
**GitHub Username:** samad3600
**LinkedIn Profile:** https://www.linkedin.com/in/abdul-samad-yaqoob-7bb0372a9/
**GitHub Project Repository:** https://github.com/samad3600/valquiz-react-Hyd

---

### Team Members

**Name:** Syed Mohammed Ishaq Hasan
**LinkedIn Profile:** https://www.linkedin.com/in/syed-mohammed-ishaq-hasan-47a87b254/

---

**Name:** Soudager Irfan Ahmed
**LinkedIn Profile:** https://www.linkedin.com/in/soudager-irfan-ahmed-009093357/

---

**Name:** Syed Ismail Ul Haq
**LinkedIn Profile:** https://www.linkedin.com/in/syed-ismail-aaa404349/

---

## Problem Statement Selected

Track B — Build an Application

Selected Problem Statement:

Kahoot-like Multiplayer Quiz Game

Comment on lines +35 to +42
---

## Project Description

ValQuiz is a real-time multiplayer quiz platform inspired by Kahoot.

Users can create quiz rooms, join instantly using room codes, answer questions live, compete on dynamic leaderboards, and view results at the end of each session.

The project is designed for students, educators, communities, events, and interactive learning experiences.

Valkey acts as the core backend datastore and powers real-time synchronization, session persistence, room management, and score updates.

Our solution demonstrates how Valkey can be used beyond caching to enable scalable real-time applications.

---

## Approach

Our approach focused on building a responsive, low-latency multiplayer experience.

We designed a room-based architecture where:

1. Hosts create quiz sessions
2. Players join using room codes
3. Questions broadcast in real time
4. Scores update instantly
5. Leaderboards refresh dynamically

Features selected:

* Multiplayer room system
* Live score updates
* Countdown timers
* Session persistence
* Real-time synchronization

AI-assisted development was used to accelerate prototyping and implementation using Codex and ChatGPT.

Our goal was to prioritize usability, scalability, and seamless multiplayer interaction.

---

## Tech Stack and Tools Used

**Frontend:** React, Vite, Tailwind CSS, Socket.IO Client

**Backend:** Node.js, Express.js, Socket.IO

**Database:** Valkey

**AI Tools/API:** Codex, ChatGPT

**Cloud/Deployment:** Docker, Vercel

**Other Tools:** GitHub, Postman, VS Code

---

## Key Features

1. Create Quiz Rooms
2. Join via Room Codes
3. Real-Time Question Broadcasting
4. Live Countdown Timer
5. Instant Score Updates
6. Dynamic Leaderboard
7. Session Persistence
8. End Game Results
9. Multiplayer Synchronization

---

## What is Working?

Current working components include:

* Quiz room creation
* Join room functionality
* Multiplayer communication
* Real-time updates
* Timer functionality
* Score calculation
* Leaderboard updates
* Backend APIs
* Valkey integration

---

## What is Still in Progress?

Areas being improved:

* UI polishing
* Additional quiz modes
* Analytics dashboard
* Performance optimization
* Deployment enhancements

---

## Screenshots or Demo

**Deployed Link:**
(Add URL)

**Demo Video Link:**
(Add URL)
Comment on lines +145 to +149

**Screenshots:**
(Add screenshots)
Comment on lines +151 to +152

---

## Challenges Faced

Challenges during development:

* Real-time synchronization
* Multiplayer state management
* Session persistence
* Valkey integration
* Event handling
* Deployment setup

---

## Learnings

Key learnings from this project:

* Real-time application architecture
* Event-driven systems
* Multiplayer application design
* State management using Valkey
* Collaborative development workflows
* Team coordination during hackathons

---

## Future Improvements

Planned future enhancements:

* AI-generated quizzes
* Tournament mode
* Analytics dashboard
* Mobile application
* Classroom support
* Public matchmaking

---

## Final Note

ValQuiz demonstrates how Valkey can power scalable, low-latency multiplayer experiences through real-time synchronization and event-driven architecture.

This project was built collaboratively during the Valkey Hackathon and reflects our focus on performance, user experience, and practical real-world applications.

Project Leadership:

Abdul Samad Yaqoob (Team Lead)

Team:
Syed Mohammed Ishaq Hasan
Soudager Irfan Ahmed
Syed Ismail Ul Haq
Empty file.