🚀 Orbital CTF Platform

A retro space-themed Capture The Flag platform built with modern tech stack that actually Just Works™️

Experience a CTF in a sleek, dark-themed environment with real-time scoring and team collaboration.

Static Demo Site · Report Bug · Request Feature

✨ Features

• 🔐 User Authentication - Individual and team registration system
• 🎯 Challenge Management - Create, edit, import/export and manage CTF challenges
• 📊 Real-time Scoring - Live leaderboard updates
• 🌙 Retro UI Theme - Space-inspired design with stunning visuals for both the categories and challenge selection screens
• 📱 Responsive Design - Works on both desktop and mobile
• 🚀 Modern Stack - Built with Next.js 15, Prisma, and Tailwind CSS
• 🏁 Multi-Flag Challenges - Supports problems with multiple flags for partial credit
• 📈 Scoreboard History - Visualize team progress with a dynamic chart
• 🔓 Unlock Conditions - Time-based and prerequisite challenge gates

🛠️ Prerequisites

Before you begin, ensure you have the following installed:

• Node.js 20.x or later
• npm or yarn
• SQLite (included with Prisma)

🚀 Quick Start

1. Clone the repository bash git clone https://github.com/asynchronous-x/orbital-ctf.git cd orbital-ctf

2. Install dependencies bash npm install # or yarn install

3. Create a .env file bash cp .env.example .env

4. Set up the database bash npx prisma migrate reset

5. Seed initial challenges bash npm run prisma:seed # or yarn prisma:seed

6. Start development server bash npm run dev # or yarn dev

Open http://localhost:3000 to launch the platform.

📁 Project Structure

orbital-ctf/
├── src/
│   ├── app/            # Next.js app router pages
│   ├── components/     # React components
│   ├── lib/            # Server-side helpers
│   ├── utils/          # Client-side utilities
│   ├── types/          # Shared TypeScript types
│   ├── middleware.ts   # Next.js middleware
│   └── instrumentation.ts # Startup tasks (challenge import)
├── prisma/
│   ├── schema.prisma # Database schema
│   └── migrations/   # Database migrations
└── public/           # Static assets
    └── uploads/      # Challenge file uploads

💾 Database Schema

The platform is built on these core models:

🔧 Configuration

The platform can be configured through environment variables:

DATABASE_URL="file:./dev.db"
NEXTAUTH_SECRET="your-secret-here"
NEXTAUTH_URL="http://localhost:3000"
INGEST_CHALLENGES_AT_STARTUP=true
CHALLENGES_DIR="./challenges"

Set INGEST_CHALLENGES_AT_STARTUP to true if you want challenges in CHALLENGES_DIR automatically imported when the server starts.

📝 License

This project is licensed under the GPL-3.0 License. See the LICENSE file for details.

🌟 Acknowledgments

• Next.js
• Prisma
• Tailwind CSS
• NextAuth.js

Made with 💯 by Asynchronous-X