Open Ham Prep

A modern web application for studying US Amateur Radio license exams. Open source, community-driven, born in North Carolina.

Live App: app.openhamprep.com

Features

• Practice Tests - Simulated exam experience with optional timer
• Random Practice - Study questions with instant feedback
• Study by Topics - Focus on specific subelements with learning resources
• Weak Questions - Review questions you've missed
• Glossary & Flashcards - Learn key terms with spaced repetition
• Progress Tracking - Dashboard with test readiness, streaks, and goals
• Bookmarks - Save questions with personal notes

Supports all three license classes: Technician, General, and Extra.

Quick Start

Prerequisites: Node.js 20+, Docker Desktop

git clone https://github.com/sonyccd/openhamprep.git
cd openhamprep
npm install
npm run dev:full

• App: http://localhost:8080
• Database GUI: http://localhost:54323

See LOCAL_SETUP_QUICKSTART.md for details.

Commands

npm run dev              # Start dev server
npm run dev:full         # Start Supabase + dev server
npm run supabase:stop    # Stop Supabase
npm run supabase:reset   # Reset database
npm test                 # Run tests
npm run build            # Production build

Tech Stack

React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui, Supabase (PostgreSQL, Auth, Edge Functions)

Documentation

• Local Development Guide
• Testing Guide
• Contributing Guidelines
• Deployment Guide
• Claude Code Instructions

Contributing

1. Fork the repo
2. Run locally with npm install && npm run dev:full
3. Make your changes
4. Submit a pull request

See CONTRIBUTING.md for guidelines.

License

© Brad Bazemore

Support

• File issues on GitHub
• Visit ARRL.org for ham radio learning resources