Everything you need to know about LuckyWheel Pro's three features — Spin Wheel, QR Prize Code, and Lucky Box.
Visit spinwheel.msdevbuild.com or open index.html in any modern browser. No installation or account needed.
Use the top navigation to switch between 🎡 Spin Wheel, 📲 QR Prize Code, and 🎁 Lucky Box. Each feature is fully independent.
Click ⚙️ Edit Details in the top-right header to set your company name, event name, logo, and theme. These branding details appear across all features and on prize reveal pages.
All participants, prizes, settings, and history are automatically saved in your browser's local storage. Use the 🔄 Reset button to start fresh.
Type a name in the Add Participant field and press Enter or click Add. Duplicate names are automatically ignored.
Paste up to 1,000 names into the Bulk Import textarea (one name per line) and press Import All or use Ctrl + Enter.
Each name appears as a chip tag. Click × on any tag to remove that participant. Use Clear All to remove everyone at once.
The Now Awarding bar above the wheel shows the current prize. Click ↻ to cycle to the next prize level, or configure prizes in Settings.
Click 🎡 Spin the Wheel (requires at least 2 participants). The wheel spins with a dramatic deceleration. The last 3 seconds feature escalating tick sounds and countdown beeps.
After spinning, the winner's name is shown in a popup with the prize. Click ✕ Remove from Wheel to eliminate them from future rounds, or ✓ Keep in Wheel to leave them in.
| Participants | Display Mode | What shows on wheel |
|---|---|---|
| ≤ 30 | Full Name | Truncated name label |
| 31–80 | Initials | Up to 2 initials |
| 81–200 | Number | Slot number |
| 200+ | Dot | Small coloured dot |
| Option | Description |
|---|---|
| Confetti on win | Launches theme-coloured confetti after every spin |
| Spin tick sound | Plays tick sounds while spinning, escalating in last 3 seconds |
| Auto-remove winner | Immediately removes the winner without showing the popup |
The QR Prize Code feature generates a QR code that links to a hidden prize. Participants scan the code with their phone to reveal what they've won. The prize is never shown on the admin screen — only the scanner sees it.
In the left panel, enter a prize name (e.g. RM 500 Cash), description, and emoji. Click + Add. Repeat for all prizes. Prizes are randomly selected each round.
Choose 🔒 One scan per device per session (each phone can scan once per QR — duplicate scan shows a full-screen block page) or ✅ Allow multiple scans (anyone can scan, no limit).
| Feature | ⚡ Automatic Mode | 🎛️ Manual Mode |
|---|---|---|
| Timer starts | ✅ Automatically | Manual trigger |
| Prize rotation | ✅ Auto on expiry | Admin clicks Next |
| Timer duration | ✅ Configurable 5–120s | No timer (or manual start) |
| Admin can stop | ✅ Yes | ✅ Yes |
| Best for | Busy events, crowds | Controlled presentations |
Click ▶ Start QR Prize Session. A large QR code appears on screen. The timer ring counts down. When time expires (Auto mode), a new random prize is selected and the QR regenerates automatically.
Anyone who scans within the time window sees a full-screen prize reveal page with confetti and their prize badge. Scanning after expiry shows an "expired round" message.
In Manual mode, use ⏱ Start Timer to begin countdown, ⏭ Next Prize to rotate immediately, or ⏹ Stop to end the session. Also 🔗 Copy Link to share the prize URL and ⬇ Save QR to download as PNG.
localStorage. It works per browser per device. Different browsers on the same phone, or incognito mode, will bypass it. For higher-security events, use a server-based solution.When a participant scans the QR code with their phone, they see a beautiful full-screen reveal page with:
Lucky Box shows a grid of closed gift boxes. Each box has a randomly assigned prize from your pool. A participant (or the admin on their behalf) clicks a box to open it — the lid flips with a spring animation and the prize is revealed with a confetti modal.
Enter prize name, emoji and description and click + Add Prize. Add as many prizes as you like. Prizes can repeat — if you have 3 prizes and 12 boxes, each prize appears ~4 times.
Select 6, 9, 12, 16, 20 or 25 boxes. The grid layout auto-adjusts columns. More boxes = more participants can play per round.
Click any closed box. The lid flips open with a spring animation, the prize appears inside the box, and a large prize reveal modal pops up with confetti and sound.
Click 🔄 New Round to reset all boxes and re-shuffle prizes randomly. Session stats (total / opened / remaining) update live.
Click ⚙️ Edit Details in the top-right header to open the settings panel. It has 4 tabs:
| Tab | What you can configure |
|---|---|
| 🏢 Branding | Company name, event name, tagline, event type, company logo (upload PNG/JPG/SVG) |
| 🏆 Prizes | Add/remove/activate prize levels (1st Prize, 2nd Prize, Consolation etc.) used by the Spin Wheel |
| 🎨 Theme | 14 festival themes: Corporate, Diwali, Chinese New Year, Hari Raya, Christmas, Holi, Birthday, School, Halloween, New Year, Malaysia, Deepavali, Light & Clean |
| ⚙️ Options | Confetti, tick sound, auto-remove winner, auto-advance prize, scan policy |
Click 🎬 Present in the header. The app goes full-screen showing the spinning wheel on the left and winner list on the right. Your branding (logo + company name) appears at the top.
Click the 🎡 Spin the Wheel button or press Space. The 3-second countdown beeps flash large numbers (3→2→1) over the wheel. The winner popup still appears over Presentation Mode.
If a QR Prize Code session is active, a live QR panel appears in the bottom of the Presentation Mode winner panel — attendees can scan directly from the screen.
Press Esc or click the ✕ Exit button in the top-right of Presentation Mode.
LuckyWheel Pro is 100% free and built with passion by Sutahhar Jegatheesan from Malaysia. If it has been useful at your event or class, a coffee goes a long way towards keeping it alive and adding new features!