Usage Guide

How to use SpinTheWheel.dev

Set up entries, spin confidently, and keep history tidy—optimized for clean, uncluttered layouts.

Open the wheel Home

Step 1

Add entries

Use single add or bulk list (one per line). Optional: color + weight.

Step 2

Tune settings

Adjust spin duration, text size/style, pointer color, sounds, and remove-winner toggle.

Step 3

Spin

Click SPIN or press Space/S to start. Weighted odds pick the winner fairly.

Step 4

Save & share

Export JSON, copy history, or print results. Import later to restore.

Set up your entries

Speed through inputs with bulk add, or fine-tune each item.

Single add

Enter text, choose weight (1-10), then Add. Edit/delete inline.

Tip: add emoji via the smile icon.

Bulk list

Paste one per line: Item, #HEX, weight. Missing colors auto-assign.

Weights clamp 1-10; hex must be 6-digit.

Sorting & shuffle

Sort alphabetically or shuffle for quick randomization before spinning.

Use clear-all to reset quickly.

Spin controls

  • Spin duration: Slide 2-10s to fit your pacing.
  • Sound & confetti: Toggle sound if you’re on-stream or presenting.
  • Remove winner: Auto-remove after a spin for one-time draws.
  • Shortcuts: Space/S to spin, Esc to close modals, Enter to add entry.

Look & feel

  • Apply presets (Vibrant, Pastel, Neon, Earth, Grayscale) or add custom colors.
  • Set pointer color to match your theme.
  • Pick text size and style (normal/bold/italic) for readability on streams.
  • Toggle dark mode from the header for low-light setups.

Import, export, and history

Keep your wheel reproducible and your audit trail printable.

Import

Paste JSON or line items; choose replace vs append. Upload .json files directly.

Export

Download JSON or copy to clipboard. Includes entries, colors, spin settings, and history.

History

View, copy, download TXT, or print. Auto-saves locally; clear when you need a fresh session.

Tips for clean layouts

  • Keep footer and help links spaced to prevent accidental clicks near ad slots.
  • Test on mobile: ensure CTA buttons remain finger-friendly with generous padding.
  • Avoid stacking too many links in a single row; use short labels.

Quick FAQs

Do weights affect fairness?

Yes. Weight 5 is five times more likely than weight 1. All weights are normalized before spinning.

What if I need to pause mid-spin?

Spins run to completion; to retry quickly, hit Spin Again in the winner modal.

Where is my data stored?

Entries, colors, and history are stored locally in your browser. Export JSON to back it up.

Ready to spin?

Jump back to the wheel and try your configuration now.

Go to wheel Try Yes/No wheel