CodX

Project Concept

CodX was developed as my final graduation thesis (Trabalho de Conclusão de Curso) for the Analysis and Systems Development degree at the Federal Institute of Bahia (IFBA). The project addresses the high dropout rates and low motivation typical of introductory programming courses. By combining structured RPG elements with modern full-stack web technologies, CodX transforms learning how to code into an engaging, interactive journey.

In introductory programming courses, abstract syntax and lack of immediate progress indicators often cause frustration. CodX implements **Mastery Learning** (Bloom, 1968) and **Scaffolding** models. Instead of arbitrary loops or math puzzles, it contextualizes tasks inside progressive theme-based learning tracks (Trilhas) and courses.

System Architecture

The application integrates the pedagogical strategies of Mastery Learning and scaffolding. Instead of repetitive, context-free syntax exercises, students follow structured learning paths (Trilhas) and courses. The platform features an online editor connected to the remote Piston API for live code execution across 20+ languages. This is accompanied by an AI assistant powered by Google's Gemini API to guide users with contextual tips, helping them debug their solutions in real-time.

Database Design

The database model uses a relational PostgreSQL structure hosted on Supabase and typed with Drizzle. It tracks user state, XP point metrics, unlocked achievements, and learning roadmap progression.

Gamification & Feedback

CodX's design system is built around the color psychology principles of Faber Birren. It uses carefully selected, customizable complementary color palettes to reduce eye strain and cognitive monotony during long study sessions. Error feedback is chromatically coded (Green for success, Yellow for warnings, and Red for syntax errors) to evoke emotional connections and guide learning actively. At the core is an RPG progression framework: users accumulate experience points (XP) to level up their programmer profile, unlocking rarity-tiered achievements and insígnias (badges) like 'Algorithm Master' or 'Mestre do Loop'.

Closing Thoughts

The CodX platform successfully demonstrates how combining gamification, real-time code sandboxes, and generative AI can significantly improve student engagement in computer science. The project was defended successfully at IFBA in February 2025.