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.