User guide

🎡 What is TWINVOTE?

TWINVOTE is a playful decision spinner app. Can't decide where to eat? Who should do the dishes? What to watch tonight? Build a wheel, give it a spin, and let fate decide. You can create custom wheels, spin community-made wheels, earn achievements, and level up your Lucky Level.

🛠️ Creating a wheel

Head to the Builder to create your own decision spinner. Give it a name, pick an emoji, and add options — these are the choices the wheel will land on. You can also add an optional description to explain what the wheel is for.

• Standard mode — every option has an equal chance of being picked. Fair and square.
• Weighted mode— assign weights to options. Higher weight = more likely to land on it. Great for "mostly pizza but sometimes salad" scenarios.
• Mystery mode — hide option labels on the wheel. Perfect for surprise decisions or party games.
• Public wheels— tick "Make this wheel public" to share it with the community on the Discover page. Others can spin and import your creation.

🎯 Spinning a wheel

Open any wheel and press the big SPIN button. The wheel will spin with a satisfying animation, tick sounds, and a celebratory confetti burst when the result is revealed. Your spin counts toward achievements and your Lucky Level.

After spinning, you can spin again, share the result with a fun tagline, or copy a shareable link. Your spin history is saved and viewable on your profile.

🌍 Discover & community

The Discover page shows community-created wheels ranked by total spins. Browse what others have made, spin them, and if you like one, click "Import to my collection" to save a copy to your My Wheels library.

☁️ Account & cloud sync

Sign in to save your wheels, achievements, and spin history to the cloud. Your data syncs across devices — spin on your phone, check your stats on your laptop. Anonymous users can still create and spin wheels via local storage, but signing in unlocks achievements and the creator dashboard.

🏆 Achievements & Lucky Levels

Earn XP by spinning wheels, creating wheels, sharing results, and maintaining daily spin streaks. Accumulating XP raises your Lucky Level — see Lucky Levels for the full breakdown. Each achievement tier unlocks at specific milestones (e.g. 10 spins, 50 spins, 100 spins) and grants bonus XP.

📊 Creator dashboard

Once you've published public wheels, visit your Dashboard to see stats like total spins across your wheels, your most popular wheel, and a feed of recent spin activity. A great way to see how the community is using your creations.

🔧 Sound & theme

Use the sound toggle (🔊/🔇) in the toolbar to enable or mute spin sound effects. The theme toggle lets you cycle through System, Light, and Dark modes — your preference is saved automatically.

💬 Feedback & support

Have a feature request, found a bug, or just want to say hi? Use the floating 💬 button at the bottom-right of any screen, or visit the Contact page. We read every message and appreciate your feedback.