User Guide

1 Getting Started

Welcome to RaffleDraw! This guide will help you create and manage raffles easily.

  • Create an account or log in to access your dashboard
  • Each user has their own private space to manage raffles
  • You can switch between English and Arabic using the language selector

2 Creating a Raffle

To create a new raffle:

  • Click 'Create Raffle' on your dashboard
  • Enter a title and optional description
  • Set the number of winners you want to draw
  • Choose whether to allow repeat winners
  • Optionally upload a banner image

Raffle Status Lifecycle:

  • Draft: Prepare your raffle, add participants and prizes
  • Open: Raffle is active and ready for the draw
  • Closed: No more changes allowed
  • Drawn: Winners have been selected

3 Adding Participants

You can add participants in two ways:

Manual Entry

Add participants one by one with name, email, phone, and weighted chances

File Upload

Upload TXT or XLSX files with participant data

Duplicate Detection:

The system automatically detects duplicates by email, then phone, then name. Duplicate entries are merged and their chances are combined.

4 Managing Prizes

Add prizes that will be assigned to winners:

  • Give each prize a name and description
  • Set the quantity available for each prize
  • Order prizes by priority (first prize, second prize, etc.)
  • Prizes are assigned to winners in order during the draw

5 Conducting the Draw

When you're ready to select winners:

  • Make sure your raffle status is 'Open'
  • Click 'Draw Winners' on the raffle details page
  • The system uses weighted random selection based on participant chances
  • A unique seed is generated for reproducibility and auditing
  • Winners are assigned prizes in order

6 Viewing Results

After the draw, you have several options:

  • Results Page: View all winners with full details (owner only)
  • Projector Mode: Display winners publicly with privacy masking (emails/phones hidden)
  • Export CSV: Download results as a spreadsheet
  • Export PDF: Generate a printable results report

7 Sharing & Collaboration

You can share raffles with other users:

  • Add managers by their username
  • Managers can view and edit participants and prizes
  • Managers cannot delete the raffle or view final results
  • Only the owner can conduct the draw