Spin-Wheel
Project Overview
The WebSocket Spin-Wheel is an interactive gamification system designed for retail events, conferences, and digital marketing. It solves the challenge of remote synchronization by separating the controller and display screens. The application allows users to spin the wheel on a mobile device or admin terminal and watch the physical or digital display screen spin in real-time, backed by absolute administrative control over probabilities and display settings.
The Challenge
Creating a low-latency, synchronized multi-screen promotional wheel application that allows admins to rig/control winning probabilities in real time and display results instantly on public screens.
The Solution
Built a dual-screen architecture using WebSocket connections for sub-100ms sync. Created a secure Super Admin dashboard for credential provisioning, and an Admin dashboard to add/edit options (text or video), set win/lose flags, and choose target display monitors.
The Outcome
Successfully delivered a scalable marketing engagement tool that handles hundreds of concurrent wheel spins with real-time probability logic and remote display rendering.
Key Features & Capabilities
- •Real-time dual-screen sync powered by persistent WebSocket channels.
- •Rigging & probability control allowing admins to toggle winnable/unwinnable flags for specific slots.
- •Dynamic wheel items supporting either video embeds (MP4/YouTube) or styled text displays.
- •Super Admin dashboard to provision admin credentials and monitor concurrent connections.
- •Multi-monitor targeting allowing admins to assign the wheel to specific display screens remotely.
- •Vibrant animations built with HTML5 Canvas and CSS transitions.
Technical Architecture
- •Frontend: Next.js App Router for server-rendered dashboards and lightweight display client.
- •Backend: Node.js with Express.js and ws (WebSocket) server for low-latency message passing.
- •Database: MongoDB storing wheel configurations, history, and admin credentials.
- •Communication Protocol: Custom WebSocket JSON events for wheel spin triggers, configurations, and display updates.
Project Details
Need a similar system?
If you are looking to build a high-performance, real-time application or scale database throughput for surge event traffic, we can collaborate.
Let's Build It