🎯 Soc Ops — Social Bingo

Break the ice, make connections, win at networking!

Soc Ops is an interactive social bingo game designed for in-person mixers, team events, and conferences. Find people who match the prompts, mark your card, and race to get 5 in a row!

🎮 Play the Game • 📚 View Lab Guide

✨ Features

• 🎲 Randomized boards — Every player gets a unique arrangement
• 💾 Auto-save progress — Pick up where you left off
• 🏆 Bingo detection — Automatic win detection for rows, columns, and diagonals
• 🎉 Celebration modal — Confetti-worthy victory screen
• 📱 Mobile-first — Works great on phones at events

---

🚀 Quick Start

Prerequisites

• .NET 10 SDK

Run Locally

cd SocOps
dotnet run
# Open http://localhost:5166

Build

dotnet build SocOps/SocOps.csproj

---

🎨 Customize Your Game

Change Questions

Edit SocOps/Data/Questions.cs to add your own icebreaker prompts:

public static readonly List<string> QuestionsList = new()
{
    "has a pet",
    "speaks more than 2 languages",
    "your custom question here",
    // ... 24+ questions for a full board
};

Workshop Guide

👉 Follow the Lab Guide for a hands-on workshop experience with GitHub Copilot agents.

Part	Title
00	Overview & Checklist
01	Setup & Context Engineering
02	Design-First Frontend
03	Custom Quiz Master
04	Multi-Agent Development

📝 Lab guides are also available in the workshop/ folder for offline reading.

---

🛠️ Tech Stack

• Framework: Blazor WebAssembly (.NET 10)
• Styling: Custom CSS utilities (Tailwind-inspired)
• State: Scoped services with localStorage persistence
• Deployment: GitHub Pages via Actions

📁 Project Structure

SocOps/
├── Components/     # BingoBoard, BingoSquare, Modals
├── Models/         # Game state & data models
├── Services/       # Game logic & state management
├── Data/           # Question bank
└── wwwroot/        # Static assets

🚢 Deployment

Automatically deploys to GitHub Pages on push to main:

• Your game: https://{username}.github.io/{repo-name}

📝 License

MIT — use it for your next event!