Pyramid Scheme V2

A Rails app for running Hack Club referral campaigns. Users earn tickets by sharing referral links and placing physical posters, then enter raffles to win prizes.

How it works

• Referrals: Users share personalized links to drive signups (3 tickets per qualified signup)
• Posters: Users upload photos of physical posters they've placed (1 ticket per approved poster)
• Prizes: Users spend tickets in raffles to win electronics, gear, and other prizes

Setup

1. Configure GitHub OAuth at https://github.com/settings/applications/new

   • Set callback URL: http://localhost:3000/auth/github/callback
   • Add credentials to .env (copy from .env.example)

2. Start the app:

   docker-compose up

3. Setup database:

   docker-compose run web bin/rails db:create db:migrate

Admin dashboard available at /admin. Job monitoring at /jobs.