TeamBeacon

Turn your phone into a team beacon.

TeamBeacon is a tiny real-time web app for finding your people in a crowd.
Open the site, get redirected into a room, share the link, and every device in that room becomes part of the same color beacon.

Why this project is useful

Practical uses:

• finding friends at concerts, festivals, stadiums, malls, and crowded streets
• creating a temporary visual marker for a group in the dark
• demonstrating real-time fan-out with SignalR in a dead-simple way

Engineering signals for recruiters:

• ASP.NET Core
• SignalR / WebSockets
• real-time room state
• automatic room creation + shareable URLs
• Dockerized local run
• GitHub Actions CI

Features

• automatic room creation on /
• shareable room link on /r/{ROOM}
• live connected-user count
• any participant can change the room color
• color updates broadcast to everyone in the room instantly
• reconnect-friendly client

Tech stack

• .NET 10
• ASP.NET Core minimal hosting
• SignalR
• plain HTML/CSS/JS
• in-memory room state

Architecture

Run locally

Option 1: plain

dotnet run --project src/Server --urls "http://0.0.0.0:5000"

Open:

http://localhost:5000/

Option 2: Docker

docker compose up --build

Open:

http://localhost:5000/

Test on local network

Run:

dotnet run --project src/Server --urls "http://0.0.0.0:5000"

Then find your machine IP:

ipconfig

Open from another device:

http://YOUR_IP:5000/

Project structure

src/
  Server/
    Program.cs
    Server.csproj
    wwwroot/
      index.html
Dockerfile
docker-compose.yml
docs/
  demo.gif
  architecture.png

Notes

• State is kept in memory on purpose to keep the demo tiny and easy to understand.
• This is a demo-first portfolio project, not a hardened production system.
• The GIF in docs/demo.gif is an illustrative demo asset generated for the repository.

What helps with recruiters

• one-command local run
• shareable room link with immediate visible effect
• small but complete real-time product, not just CRUD
• CI config included
• Docker included
• visual documentation included

Roadmap

• full-screen mode
• optional blinking/pulse patterns
• per-user color identities
• QR code for room sharing
• latency / RTT diagnostics