TeamForge — Race-Proof Team Formation Platform
A race-proof team formation platform ensuring fair seat allocation, secure invites, and reliable concurrent joins at scale.
Built at Hack4Hack Crew Hiring Challenge 2026
Theme: Full-Stack Development, Distributed Systems, Concurrency
Team Mishthi Jain: Mishthi Jain
Built with React, Vite, JavaScript, Node.js, Express.js, PostgreSQL, Neon, Docker, JWT, bcrypt, Zod, k6, GitHub Actions, Vercel
About the project
TeamForge is a full-stack hackathon team formation platform built for Hack4Hack Crew Hiring Challenge 2026 — Problem Statement 1.
Problem: Traditional team formation systems can suffer from race conditions when multiple users attempt to claim the final available seat simultaneously. This can cause overbooking, duplicate memberships, and inconsistent team sizes.
Solution: TeamForge uses PostgreSQL transactions and row-level locking (SELECT FOR UPDATE) to ensure atomic team membership operations. Even when 50 users compete for the final available seat, exactly one succeeds.
Key Features:
User authentication and team creation
Secure, expiring invitation codes
Join requests with leader approval
Automatic leadership transfer and member management
Prevention of duplicate memberships and team overbooking
Idempotency protection for repeated requests
Team recommendations based on skills and time zones
Audit logs for team activities
Responsive React dashboard with automatic updates
Testing and Performance:
The application passed 32 automated API tests, including a 50-user concurrent join test.
Local load testing with Grafana k6 achieved a p95 response time of 58.64 ms across 61,857 requests with 100 concurrent virtual users and a 0% HTTP failure rate.
The local database was tested with 10,059 users and 2,004 teams.
Architecture: React and Vite frontend, Express backend, PostgreSQL database, Docker-based local development, and Vercel deployment with Neon PostgreSQL.
The deployed version uses periodic polling for updates, while local development supports PostgreSQL notifications and Server-Sent Events.
Links
Submitted