How rhombusgg/rhombus works
Project type and purpose
• This is a full-stack, extendable Capture-The-Flag (CTF) framework written in Rust, with a TypeScript/JS frontend and a plugin system.
• It provides a core Rust web server (rhombus/), a CLI tool (rhombus-cli/), build-script support (rhombus-build/), plus example deployments and plugins.
File structure
• Top-level components:
• rhombus/ – the core library and server (Rust, templates, static, frontend TSX, migrations, locales)
• rhombus-cli/ – CLI management tool for contests
• rhombus-build/ – build-time library for code‐generation or assets
• examples/ – standalone servers, demo site, plugin samples
• docs/ – documentation site (VitePress)
• Within rhombus/:
• src/internal/ – HTTP routing, business logic, plugin loader, email, Discord, database providers
• frontend/ – Deno/TypeScript React-style code for interactive UI components
• templates/ – server-side Minijinja HTML templates
• static/ – JS helper scripts and CSS assets
• migrations/ – SQL schema for Postgres and libSQL (SQLite)
• Config and CI: Dockerfile, Taskfile.yaml, GitHub workflows, Nix flake
README for insights
• Project is deployed as a monolithic Rust server that embeds TSX frontend via Deno, serves HTML templates, and exposes HTTP/gRPC endpoints.
• Supports swapping database backends, email providers, upload backends, and plugin extensions.