A web-based platform for creating and sharing coding adventures - promoting active learning through gamification and adaptive problem sequences.
Adventure Code is an educational platform that enables educators and students to create "coding adventures" - sequences of programming problems represented as interactive graphs. Each node represents a coding problem, and edges determine the path through the adventure based on whether problems are solved correctly or incorrectly. This approach facilitates adaptive learning experiences that can adjust difficulty dynamically based on performance.
- Interactive Adventure Creation: Build coding adventures using a visual graph interface
- Adaptive Problem Sequences: Create branching paths based on correct/incorrect solutions
- Secure Code Execution: Safe execution of user code using containerised sandboxing (Piston engine)
- Multi-language support: Adventure Code supports Python, JavaScript, TypeScript, Java, C++, C, Go, Rust, PHP, Ruby, and Bash.
- Guest Mode: Attempt adventures without account creation
- Progress Tracking: Save progress for registered users
- Leaderboard System: Gamification through fastest completion times
- Sharable Adventures: Generate unique 6-digit access codes for easy sharing of adventures.
Adventure Code follows a 3-tier architecture
- Frontend: React with TypeScript, Vite, React Flow, and TailwindCSS
- Backend: FastAPI with Python
- Database: PostgreSQL
Prerequisite: Must have Docker downloaded and running on your machine.
-
Clone the repository: run
git clone https://github.com/Joshua-Onley/AdventureCode -
cdinto the project directory -
run
docker-compose up --build -d -
open a web-browser and go to http://localhost:5173