README.md

Community Raffle

A template repository to run fair, transparent, and automated raffles for your community events using GitHub Issues and GitHub Actions.

📋 How to Run a Raffle

Creating a Raffle:

Fill out the raffle template with:

• Event Name: Descriptive name for your raffle
• Number of Winners: How many people will win
• Prize Details: What winners will receive

What Happens Automatically:

• ✅ Issue title gets updated with your event name
• ✅ QR code is generated for easy sharing
• ✅ Ready to accept participants via comments

Selecting Winners:

1. Go to the Actions tab
2. Find "Raffle Winner Selection"
3. Click "Run workflow"
4. Select your raffle from the dropdown menu
5. Winners are announced automatically

Tips:

• Share the issue URL or QR code with participants
• Set clear entry deadlines in your raffle description
• Pin the raffle issue to make it visible
• Close the issue after distributing prizes

🎯 Quick Actions

Ready to get started? Use these quick links:

• 📝 Create New Raffle - Start a new raffle event for your community
• 🏆 Select Winners - Run the automated winner selection process
• 📊 View Past Raffles - Browse completed raffle events

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.