STEMForge - A Gamified STEM Learning Platform

A comprehensive gamified STEM learning platform with AI-powered career guidance for students in grades 8-12.

🚀 Features

🎮 Gamified Learning

• Projectile Lab (Physics): Interactive canvas-based game to learn projectile motion
• Logic Grid (Math): Pattern recognition puzzles with progressive difficulty
• Element Match (Chemistry): Periodic table quiz with element properties

🏆 Gamification System

• XP Points & Levels
• Achievement Badges
• Learning Streaks
• Global Leaderboard

🤖 AI Career Guidance

Multi-agent AI system for personalized career recommendations:

• Skill Profiling Agent: Analyzes learning progress and identifies strengths
• Career Matching Agent: Maps students to suitable careers based on interests, skills, and grades
• Learning Path Agent: Suggests personalized study paths and courses
• Guidance Agent: Provides ongoing personalized recommendations

🗺️ Personalized Roadmaps

• Career-specific learning paths
• Recommended colleges and qualifications
• Growth opportunity insights

🛠️ Tech Stack

Frontend

• React 18 + Vite
• React Router DOM
• Vanilla CSS (Design System)
• Canvas API for games

Backend

• Python 3.11+
• FastAPI
• Pydantic
• Uvicorn

📦 Installation

Frontend Setup

cd frontend
npm install
npm run dev

Frontend runs on: http://localhost:5173

Backend Setup

cd backend
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload

Backend runs on: http://localhost:8000

📁 Project Structure

stemforge/
├── frontend/
│ ├── src/
│ │ ├── components/ # Layout, Navbar
│ │ ├── pages/ # Home, Dashboard, Games, CareerGuide
│ │ ├── games/ # ProjectileLab, LogicGrid, ElementMatch
│ │ ├── index.css # Design System
│ │ └── App.jsx # Routes
│ └── package.json
│
├── backend/
│ ├── services/
│ │ ├── career_engine.py # Career Matching Agent
│ │ ├── skill_profiler.py # Skill Profiling Agent
│ │ └── learning_path.py # Learning Path Agent
│ ├── main.py # FastAPI app
│ └── requirements.txt
│
└── README.md

🎨 Design System

The platform uses a clean, white-themed design with teal/cyan accents:

• Primary Background: #ffffff
• Accent Color: #0891b2 (Teal)
• No purple colors used
• Glassmorphism effects for cards
• Smooth micro-animations

🔌 API Endpoints

Method	Endpoint	Description
GET	/	API info
GET	/health	Health check
POST	/api/career-guidance	Get career recommendations
POST	/api/game-score	Submit game score
GET	/api/games	List available games
GET	/api/leaderboard	Get global leaderboard

👥 Team

Built for Hackathon 2026

---

STEMForge - Built for learning, powered by curiosity.