EKUB-RANDOM-PICKER 🎯

A digital modern random winner picker — a sleek, intuitive web application designed to randomly select winners from a list. Perfect for contests, raffles, giveaways, and any scenario where fair random selection is needed.

---

 ✨ Features

- **Random Selection**: Fair and unbiased picking of winners from any user-provided list.
- **Multiple Winners**: Choose more than one winner in a single draw.
- **Real-time Display**: Instantly shows selected winners with smooth animations.
- **Participant Management**: Easily add, remove, and edit participants.
- **Bulk Add**: Paste or upload lists for quick entries.
- **Exclusion Mode**: Optionally remove already-picked winners from further draws.
- **Selection History**: Keep track of previous winners throughout your event/session.
- **Responsive UI**: Works on any device—desktop, tablet, or mobile.
- **Visual Effects**: Celebration animations and sound effects (optional).
- **Local Storage**: Save and load participant lists using your browser.
- **Export Results**: Download the list of winners for your records.

---

 🚀 Quick Start

1. **Clone the repository:**
   ```bash
   git clone https://github.com/brukcodes/EKUB-RANDOM-PICKER.git
   cd EKUB-RANDOM-PICKER

2. Open in your browser:
   • Double-click or open the index.html file.
   • Or use a local server for more advanced usage:

     # Python 3
     python -m http.server 8000
     # Then visit http://localhost:8000 in your browser.

---

📖 How to Use

1. Add Participants:

   • Enter names individually or paste a list.
   • Use bulk add for speedy entry.

2. Configure the Draw:

   • Set the number of winners.
   • Choose if drawn winners should be excluded from further draws.

3. Pick Winner(s):

   • Click "Pick Winner".
   • Watch the animated selection and see results instantly.

4. View & Export Results:

   • Check previous draws in selection history.
   • Export winner lists if needed.

---

🛠 Technology Stack

• HTML5
• CSS3
• JavaScript (ES6+)
• Browser LocalStorage (for data persistence)

---

📁 Project Structure

EKUB-RANDOM-PICKER/
├── index.html           # Main application file
├── src/
│   ├── css/
│   │   └── styles.css   # Styling and animations
│   ├── js/
│   │   ├── app.js       # Core logic
│   │   ├── picker.js    # Winner selection algorithm
│   │   └── utils.js     # Helper functions
│   └── assets/
│       └── sounds/      # Sound effects (optional)
└── README.md            # This file

---

🎯 Use Cases

• Classroom random student picker
• Contest/giveaway winner selection
• Team member random selection
• Raffle draws and event lotteries
• Game show contestant picking

---

⚙️ Configuration

• Animation speed and effects
• Sound effects toggle (if implemented)
• Exclude winners after picking
• Data storage options (browser local storage)

---

📝 Feature Status

Feature	Done
Add/Bulk Add	✅
Random Winner Picker	✅
Multi-Winner Support	✅
Exclusion Mode	✅
Selection History	✅
Responsive UI	✅
Visual Effects	✅
Data Persistence	✅
Export Results	✅

---

🤝 Contributing

Contributions welcome!

1. Fork the repository
2. Create your branch (git checkout -b feature/AmazingFeature)
3. Commit changes
4. Push branch
5. Open a Pull Request

---

---

👤 Author

brukcodes

• GitHub: @brukcodes

---

🙏 Acknowledgments

• Built for fair and transparent random selection
• Created using modern web standards

---

📞 Support

• For issues, open an Issue
• Suggestions and bug reports are welcome!

---

🎉 Enjoy!

If you find EKUB-RANDOM-PICKER useful, give it a ⭐ on GitHub!