HackathonTUI

A terminal user interface (TUI) application for managing hackathons, built in Rust.

Features

• Hackathon Management: Create, edit, and delete hackathons with themes and descriptions
• Participant Registration: Track participants with skills, contact info, and check-in status
• Team Formation: Create teams and assign participants
• Project Submissions: Manage project submissions with tech stacks and repository links
• Judging System: Add judges, assign projects, and enter scores with weighted criteria
• Sponsorship Tracking: Manage sponsors with tiers (Platinum/Gold/Silver/Bronze) and contribution amounts
• Prize Management: Define prizes by category and assign winners
• Event Scheduling: Plan workshops, meals, ceremonies, networking, and hacking sessions
• Analytics & Export: View statistics and export data to CSV

Installation

cargo build --release
./target/release/hackathontui

Usage

Navigation

• q / Esc - Go back / Quit
• Tab / Shift+Tab - Switch between tabs
• 1-0 - Jump to specific tab
• j/k or ↓/↑ - Move selection
• Enter - Select / Confirm
• ? - Show help
• / - Search

Actions

• n - Create new item
• e - Edit selected item
• d - Delete selected item

Context-Specific

• c - Check in participant (Participants tab)
• t - Assign participant to team (Participants tab)
• s - Submit project (Projects tab) / Enter score (Judging tab)
• a - Assign project to judge (Judges tab)
• w - Assign prize winner (Prizes tab)
• e - Export to CSV (Analytics tab)

Data Storage

Data is stored as JSON files in ~/.hackathontui/data/.

Dependencies

• ratatui - TUI framework
• crossterm - Terminal manipulation
• serde - Serialization
• chrono - Date/time handling
• uuid - Unique identifiers

License

See LICENSE for details.