🛠 How Wheelio Works

From zero to spinning in under 30 seconds. Here's everything you need to know about how Wheelio turns your options into fair, exciting, and truly random decisions.

Step-by-Step Guide

01Build Your Wheel

Click Add Segment and type in any label — a name, a food, a task, a prize. You can add as many segments as you want. Each one can carry a different weight (percentage), so some options can appear more or less likely than others.

💡 Tip: use emojis in labels to make the wheel more visually fun and recognizable at a glance.

02Customize Colors & Weights

Each segment has its own color, chosen via the built-in color picker. The percentage field controls how large that slice appears on the wheel — and directly influences the probability of it being selected. All percentages must add up to 100.

💡 Tip: equal percentages = equal chances. Unequal percentages = weighted random selection.

03Spin with Realistic Physics

Hit the spin button and watch the wheel accelerate with a smooth ease-in, then decelerate gradually with realistic friction physics — just like a real wheel. The animation runs at 60fps for a fluid, satisfying visual experience on any device.

🔒 The final result is determined by a cryptographically secure random number generated before the animation starts — the spin is purely visual.

04Discover the Winner

A fixed arrow pointer highlights the winning segment as the wheel comes to rest. The result is displayed prominently with visual feedback — making it perfect for live presentations, classrooms, or streaming.

💡 Tip: pair it with sound effects for extra drama during live events!

05Save & Load Configurations

Don't rebuild your wheel every time. Use the Download button to export your segment configuration as a JSON file. Next time, just click Load to restore it instantly — labels, colors, and percentages all included.

Your wheel also auto-saves in the browser, so refreshing the page won't lose your work.

06Embed on Any Website

Click Embed to generate an <iframe> snippet with your current wheel configuration baked right into the URL. Set a custom width, height, and background color — then paste it anywhere: blogs, course platforms, event pages.

💡 The embed is fully self-contained — no login or account needed for your visitors.

🎲 How the Randomness Works

Wheelio uses the browser's built-in crypto.getRandomValues() API to generate its random numbers. This is the same cryptographic-grade source of entropy used in password managers and security tokens — far more unpredictable than a standard Math.random().

The winning segment is determined before the wheel starts spinning. The visual animation is then computed in reverse — the wheel is made to stop exactly at the pre-determined position, after a randomized spin duration to keep things visually exciting.

This means: the result is always truly fair, and the animation can never be manipulated or predicted from how it looks while spinning.

❓ Common Questions

Can I have more than 100 segments?

Yes. There's no hard limit. However, very small slices may become hard to read visually — we recommend keeping labels short or using icons when you have many segments.

What if my percentages don't add up to 100?

Wheelio will warn you. The wheel won't spin until the total is exactly 100 — this ensures the probability distribution is always valid and fair.

Does it work offline?

Yes! Wheelio is a Progressive Web App (PWA). Once you've visited the site with a connection, everything is cached locally — you can spin the wheel even without internet access.

Can I install it on my phone?

Absolutely. On Chrome (Android) or Safari (iOS), tap Add to Home Screen in the browser menu. Wheelio will install like a native app — no App Store needed.

Ready to spin?

🎡 Launch Wheelio