Skip to content

SigmaSauer07/gridplay

Repository files navigation

GridPlay

"Your Grid. Their Game. Instant Glory." Digital Sports Squares Made Easy, Fair, and Fun! Ready to revolutionize sports squares? Launch your GridPlay board today—no spreadsheets, no stress, just wins!

Elevator Pitch:

Tired of messy spreadsheets, cash piles, and manual score-checking for your sports squares game? GridPlay automates the classic sports betting experience, turning chaotic paper grids into sleek, real-time digital boards. Host or join games in seconds, buy squares securely, and let the app handle live scores, random number assignments, and instant payouts—perfect for Super Bowl parties, March Madness, or casual game nights!

How It Works:

  1. Create or Join a Board

    • Choose an upcoming sports game. The system will automatically assign the playing teams on the board.
    • Choose from Shotgun Boards (Halftime and Final), 10x10 (classic 100 squares), or 5x5 (25 square mini-grid).
    • Choose or Set squares value (each board will have squares the same value, this 5x5 board is $1 per square. this 5x5 board is $5 per square, etc.) and for premium users, set your house cut (default 10%).
  2. Buy Squares Digitally

    • Users claim squares via Stripe, PayPal, or crypto.
    • Squares are marked instantly with their username—no duplicates!
  3. Auto-Assign Numbers

    • After squares sell out, the app randomly assigns 0-9 digits to rows/columns (ensuring fairness).
  4. Track Scores Live

    • Integrates with ESPN/SportsRadar APIs to auto-update scores by quarter/halftime/final.
    • Winners are highlighted in real time.
  5. Win & Cash Out Instantly

    • Payouts split by quarter (e.g., 16% for Q1, 24% for halftime).
    • Winnings go straight to users’ wallets or bank accounts.

Game Modes:

  1. Shotgun Board (2-Row Quick Play)

    • Top row = Halftime, Bottom row = Final Score.
    • Last digit of each teams score added wins (e.g., 23-17 → 3+7=10 → 0 wins).
    • Payout: 90% of the total pot for that row (Halftime and Final). Example: $1 per square pays $9 to halftime winner and $9 to final winner, house cut 10% ($2).
  2. Classic 10x10 & 5x5 Grids

    • 10x10: Match column (home team) and row (visitors) digits for each quarter.
    • 5x5: Double digits per row/column for faster action.
    • Each square has a chance to win in all 4 quarters. Your square could win them all.
    • Payouts: 16% (Q1), 24% (halftime), 16% (Q3), 32% (final), 12% house.

Core Features:

  • Real-Time Updates: Live scores, sold squares, and winners update automatically – you don't have to lift a finger!
  • Secure Payments: PCI-compliant gateways (Stripe, PayPal) + crypto options.
  • Social Integration: Invite friends to a board your playing, or make a private board for social events.
  • Mobile-First Design: Play on any device—no app download needed.
  • Fair Randomization: Transparent RNG for number assignments.
  • User Profiles: Track wins, balance, and game history.
  • "Board Rooms": Chat rooms that square holders of the same board can chat together.

Premium User Benefits:

  • Keep and adjust house cut and adjust payout percentage
  • Customizable board designs, including branded themes, logos, team colors and more.
  • Multi-board management
  • Personalized alerts (squares left needing to sell before game starts, board sells out, etc.)
  • Access to beta features (early access to upcoming tools or enhancements, such as new game modes or integrations with additional sports data feeds.)

Why Users Love It:

  • Zero Hassle: No cash, paper, or math—just pure fun.
  • Equal Chance: Luck-based (no sports knowledge needed).
  • Social Buzz: Perfect for watch parties, bars, or online groups.
  • Instant Payouts: No waiting for hosts to Venmo you.

Use Cases:

  • Super Bowl, NBA Championship, Finals, March Madness, college, and other sports events: Fill boards in minutes.
  • Group Events/Parties: Social gatherings such as office parties, family reunions, or informal meet-ups
  • Bars/Restaurant/Event Hosts: Looking to draw in, retain, and engage customers during live sports games.
  • Virtual Watch-Alongs: Remote friends can play together.
  • Influencers/Content Creators/Streamers: Host branded games for audiences.

Technical Edge

  • APIs: Live scores via ESPN/SportsRadar.
  • Security: End-to-end encryption, GDPR compliance.
  • Scalability: Handles 10,000+ concurrent users.

Setup Instructions

Prerequisites

  • Node.js
  • npm or yarn
  • Supabase account

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/GridPlay.git
    cd GridPlay
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Set up Supabase:

    • Create a new project on Supabase.
    • Copy the API URL and public anon key from your Supabase project settings.
  4. Create a .env.local file in the root directory and add your Supabase credentials:

    NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
    NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key
  5. Run the development server:

    npm run dev
    # or
    yarn dev
  6. Open http://localhost:3000 with your browser to see the result.

Deployment (maybe)

You can deploy the app to Vercel with one click:

Deploy with Vercel

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors