Hack Together. Ship Together. Open Source.
HackBoard is an open-source, self-hostable hackathon platform by the DemonDie organization. It provides the tools needed to manage hackathons, coordinate teams, submit projects, and normalize scoring.
- Event Management: Tools to configure hackathons, custom tracks, schedules, prizes, and registration.
- Team Matchmaking: Skill-based matchmaking algorithm to pair participants automatically.
- Project Submissions: GitHub-integrated submission system tracking repo stats, demo links, and screenshots.
- Judging and Scoring: Rubric-based scoring interface with Z-score bias normalization across judges.
- Live Leaderboard: Real-time rankings with animated rank transitions.
- Authentication: Native GitHub and Google OAuth integration via NextAuth.js.
- Self-Hostable: Containerized development and production setup guidelines.
Get HackBoard running locally in five steps:
# 1. Clone the repository
git clone https://github.com/SharanyoBanerjee/hackboard.git && cd hackboard
# 2. Install dependencies
pnpm install
# 3. Set up environment variables
cp .env.example .env.local
# 4. Start local services and run migrations
docker-compose -f infra/docker-compose.yml up -d && pnpm db:migrate && pnpm db:seed
# 5. Start the development server
pnpm devThe application will be accessible at http://localhost:3000.
Requirements: Node.js 20+, pnpm 8+, Docker.
| Layer | Technology |
|---|---|
| Framework | Next.js 14 (App Router) |
| Language | TypeScript (Strict Mode) |
| Styling | Tailwind CSS + shadcn/ui |
| Database | PostgreSQL + Prisma ORM |
| Auth | NextAuth.js |
| API | tRPC v11 |
| Real-time | Socket.io |
| State | Zustand |
| Validation | Zod |
| Cache | Redis (Upstash / Local) |
Refer to the Self-Hosting Guide in docs/self-hosting.md for instructions on deploying to services like Railway, Render, or a Virtual Private Server (VPS) using Docker Compose, Cloudflare R2, and Nginx.
Review CONTRIBUTING.md for coding standards, pull request templates, and workflow instructions.
Please report vulnerabilities directly to security@demondie.dev. See SECURITY.md for details.
This project is licensed under the MIT License. See LICENSE for details.