🎡 Spinning Wheel - Flutter Package #

A fully customizable spinning wheel for Flutter applications! Easily create fortune wheels, prize spinners, or game-based random selectors with smooth animations and custom segments.

🌟 Features #

• ✅ Fully customizable spinning wheel 🎨
• ✅ Dual Image Support (Local Assets & Network URLs) 🖼️🌐
• ✅ Advanced Label Styling (Control rotation, style, and alignment) ✍️
• ✅ Smart Text Clipping (Auto-ellipsis or clipping for long text) 🛡️
• ✅ Supports text labels, colors, and images 🖼️
• ✅ Smooth animation with realistic spin physics 🎯
• ✅ Weighted Probability Support (Control win frequencies) ⚖️
• ✅ Flexible Padding (Independent control for rim, center, and side spacing) 📏

📸 Preview #

📦 Installation #

Add this package to your pubspec.yaml:

dependencies:
  spinning_wheel: ^0.0.7

🔧 Usage #

1️⃣ Import the Package #

import 'package:spinning_wheel/spinning_wheel.dart';

2️⃣ Create a SpinnerController #

final SpinnerController controller = SpinnerController();

3️⃣ Define Wheel Segments #

List<WheelSegment> segments = [
  WheelSegment("Jackpot!", 1000, color: Colors.orange, probability: 0.05), 
  WheelSegment("Prize 2", 20, color: Colors.blue, probability: 0.3),
  // Supports Network Images! 🌐
  WheelSegment("Gift", 100, path: "https://example.com/gift_icon.png"), 
  WheelSegment("Empty", 0, color: Colors.grey, probability: 0.2), 
];

4️⃣ Add the SpinnerWheel Widget #

SpinnerWheel(
  controller: controller,
  segments: segments,
  // NEW: Precise Padding 📏
  slicePadding: const EdgeInsets.only(top: 20, bottom: 10, left: 5, right: 5),
  // NEW: Advanced Label Styling 🎨
  labelStyle: const WheelLabelStyle(
    labelStyle: TextStyle(
      color: Colors.white,
      fontWeight: FontWeight.bold,
      fontSize: 14,
    ),
    overflow: TextOverflow.ellipsis, // Auto-handle long text
    maxLines: 1,
    angle: 0.0,
  ),
  onComplete: (result, index) {
    print("You won: ${result.label}!");
  },
),

5️⃣ Start Spinning! #

controller.startSpin();

📜 API Reference #

SpinnerWheel #

WheelLabelStyle #

📄 License #

This package is licensed under the MIT License.

🙏 Support #

If you like this package, ⭐ Star it on GitHub!
For issues or feature requests, open an issue on GitHub.