Skip to content

SomeGuy02312/recruiting-bingo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

27 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ‰ Recruiting Bingo

A lightweight, real-time, multiplayer bingo game for recruiters, sourcers, hiring teams, and anyone who lives in the madness of talent acquisition.


πŸ“Œ Overview

Recruiting Bingo is a modern web app built for fun team moments, offsites, training sessions, and live meetings. Create a room in seconds, share a link, and watch everyone sync up in real time as they click squares like:

  • β€œCan we push this to next quarter?”
  • β€œWhat’s the budget for this role?”
  • β€œWe need someone with 10 years of experience in a 3-year-old technology.”

Players get automatic Bingo detection, real-time winner announcements, and fireworks πŸ”₯πŸŽ†

No accounts. No logins. No tracking. Just a delightful little game.

Try it at https://bingo.hiregear.us


πŸš€ Features

  • Real-time multiplayer rooms β€” everyone sees the same card instantly.
  • Multiple card libraries built for TA, sourcing, hiring managers, and more.
  • Custom games β€” enter your own 25 custom squares.
  • Winner flow + fireworks β€” shared celebrations across all players.
  • Modern UI with dark mode β€” crisp, polished, and readable.
  • Open Graph preview integration for social sharing.

🧰 Tech Stack

Frontend

  • React + TypeScript
  • Vite
  • Tailwind CSS
  • Zustand (or similar) for local state
  • A shared logic package for bingo validation

Architecture

  • Monorepo structure (apps/, packages/)
  • apps/web β€” main application
  • packages/ β€” shared state + game logic

Real-time sync model:

  • Each room has a unique ID
  • Clients subscribe on join
  • Actions emit small events (mark square, call Bingo)
  • Canonical room state updates and re-broadcasts
  • UI re-renders from shared snapshot

Styling

  • Tailwind dark: variants
  • Glassy white + dark cards
  • Responsive grid layout for the board

Build & Deploy

  • Vite build
  • Cloudflare Pages hosting
  • GitHub Pages support included

πŸ“¦ Installation & Local Development

git clone https://github.com/SomeGuy02312/recruiting-bingo
cd recruiting-bingo
npm install
npm run dev

Local dev server: http://localhost:5173


πŸš€ Deployment (Cloudflare Pages)

  1. Create a Cloudflare Pages project

  2. Connect your GitHub repo

  3. Settings:

    • Build command: npm run build
    • Output directory: dist
  4. Deploy πŸŽ‰

Production URL: https://bingo.hiregear.us


πŸ“„ Project Structure

recruiting-bingo/
β”‚
β”œβ”€ apps/
β”‚   └─ web/                # React app
β”‚       β”œβ”€ src/routes/     # Pages
β”‚       β”œβ”€ src/components/ # UI components
β”‚       └─ index.html      # OG metadata
β”‚
β”œβ”€ packages/
β”‚   β”œβ”€ game-logic/         # Bingo rules + validation
β”‚   └─ types/              # Shared TS types
β”‚
└─ README.md

⭐ About the Creator

Hi, I’m Ed β€” a product nerd, ex-recruiter, and Director of Product in TA Tech.

I build tools for recruiters and hiring teams. I love polished, delightful side projects β€” especially ones that blend UX, product thinking, and modern development.

This project is part of HireGear, a collection of experimental tools for the recruiting world.

πŸ”— Links


🀝 How This Project Was Built (Human + AI Collaboration)

This app was built through a tight iterative loop between:

🧠 Ed (Human)

  • Drove product vision & UX
  • Designed game mechanics and flows
  • Set polish standards (layout, spacing, animation)
  • Debugged issues and integrated code

πŸ€– ChatGPT (AI Coding Partner)

  • Wrote major React + TS components
  • Debugged live errors
  • Refactored layout and winner flow
  • Generated copy, UI patterns, and Tailwind structures
  • Produced specs, PRDs, and documentation

This wasn’t β€œAI-built software.” It was human-led product development with AI as a high-speed engineering copilot.


πŸ“£ Contributing

Contributions welcome! Open an issue or PR.


πŸ›‘ License

Licensed under the Polyform Non-Commercial License.


πŸŽ† Final Notes

Recruiting is chaotic, funny, and endlessly human.

This project is a small celebration of that energy β€” with fireworks.

About

Open source multiplayer web-based bingo supporting up to 24 players per room, with fun recruiting-themed cards

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors