You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Engineerium is a comprehensive STEM education platform that combines:
5 Engineering Disciplines with 100+ lessons
AI-Powered Tutoring (EnGo - powered by Google Gemini 2.0 Flash)
Interactive 3D Models with JARVIS explode mode
Real-time Progress Tracking with XP and leveling
Community Features for collaborative learning
Career Projects for portfolio building
25+ Engineering Calculators and 200+ formulas
🎯 Project Vision & Impact
The "Why": The Reason for Creation
Engineerium was created to bridge the massive gap between dense theoretical math/physics and real-world engineering. Traditional textbooks are static; Engineerium was built to make engineering "alive," allowing students to interact with the same formulas (like the Tsiolkovsky Rocket Equation) used at NASA and SpaceX in a visual, low-risk environment.
📈 Evolution and Improvements
The project has evolved from a simple model viewer into a comprehensive career-ready curriculum:
Foundation Depth: Curriculum sections like Unit 0: Foundations include MIT-quality content covering Vectors, Newton’s Laws, and Thermodynamics.
Technical Fidelity: 3D models moved from simple shapes to high-fidelity components (like the Falcon 9 Octaweb and Merlin Engines) with dedicated "JARVIS" modes that analyze parts in real-time.
AI Integration: The tutoring system moved from simple chat to EnGo Tutor, which is context-aware—meaning it knows exactly which lesson you are on and can explain complex derivations step-by-step.
🎓 How It Transforms Student Learning
Visual Intuition: Instead of just reading "Thrust = Force," students see the vectors acting on a 3D car or rocket. The Explode View lets them see the "guts" of an engine, building spatial awareness.
Instant Feedback: Every lesson contains a 5-question quiz with immediate explanations. This "micro-learning" prevents knowledge gaps from forming.
Variable Complexity: It starts with "Beginner Units" (Foundations) and scales all the way to Capstone Projects, allowing a student to grow from a hobbyist to a career-ready engineer.
The EnGo Safety Net: If a student is stuck on a formula like F_net = √(F_net,x² + F_net,y²), they can ask the AI tutor to "Explain this like I'm 10" or "Show me the advanced derivation."
Explain Concept, Help with Math, Draw Diagram, Real Examples
Homework Solver
Step-by-step solutions for engineering problems
JARVIS Mode
AI-powered 3D model analysis
Project Insights
AI recommendations for career projects
🎮 Gamification
Feature
Description
XP System
Earn XP for completing lessons (100-150 XP based on quiz score)
Leveling
1000 XP = 1 Level
Achievements
20+ unlockable badges
Streak System
Daily learning streaks with fire counter
Daily Challenges
New engineering challenges every day
Weekly Challenges
Larger challenges with bigger rewards
Leaderboard
Global rankings by XP
Achievement Notifications
Real-time popup notifications
🔧 Engineering Toolbox
Feature
Description
25+ Calculators
Specialized engineering calculators
200+ Formulas
Comprehensive formula library across 9 categories
20 Project Templates
Ready-to-build engineering projects
Interactive Diagrams
Car and aircraft component diagrams
3D Model Viewer
Rotate, zoom, explode mode
Circuit Lab
Interactive circuit simulation
👥 Community
Feature
Description
Q&A Forum
Ask questions and get answers
Project Showcase
Share your engineering projects
Voting System
Upvote helpful content
Comments
Discuss and collaborate
Subject Filters
Filter by engineering discipline
Search
Find relevant discussions
� UUser Features
Feature
Description
Profile Page
Comprehensive user dashboard
Progress Tracking
Real-time across all modules
Certificates
Generate completion certificates
Onboarding Flow
Guided introduction for new users
Language Selector
6 languages supported
Global Search
Search across all content
📖 Learning Tracks (5 Disciplines)
🚀 Rockets (40+ Lessons)
Complete aerospace engineering curriculum
Section
Topics
Lessons
Section 0: Foundations
Basics, Newton's Laws, Thrust, ISP
8 lessons
Section 1: Propulsion
Staging, Mass Ratios, Nozzles, Fuel Types
8 lessons
Section 2: Structures
Materials, Stress Analysis, Heat Shields
6 lessons
Section 3: Avionics
Guidance, Navigation, Control Systems
6 lessons
Section 4: Design
Mission Planning, Trajectory Design
5 lessons
Section 5: Testing
Ground Tests, Flight Tests, Certification
4 lessons
Section 6: Operations
Launch Operations, Mission Control
4 lessons
Section 7: Capstone
Design Your Own Rocket
3 lessons
Interactive Features:
3D rocket models (Falcon 9, Saturn V, Space Shuttle, Falcon Heavy)
Rocket Equation Calculator (Tsiolkovsky)
Orbital Transfer Calculator (Hohmann transfers)
Delta-V calculations
Real-world mission examples
✈️ Planes (35+ Lessons)
Complete aeronautical engineering curriculum
Section
Topics
Lessons
Section 0: Foundations
Aerodynamics, Lift, Drag, Airfoils
7 lessons
Section 1: Structures
Wing Design, Fuselage, Materials
6 lessons
Section 2: Propulsion
Jet Engines, Propellers, Turbofans
6 lessons
Section 3: Controls
Flight Controls, Stability, Autopilot
6 lessons
Section 4: Maintenance
Inspection, Repair, Safety
5 lessons
Section 5: Simulation
Flight Simulation, Testing
5 lessons
Interactive Features:
3D aircraft models (F-22, F-16, MiG-29)
Lift Calculator
Drag coefficient calculations
Interactive aircraft diagrams
Real-world aircraft specs
🚗 Cars (35+ Lessons)
Complete automotive engineering curriculum
Section
Topics
Lessons
Section 0: Foundations
Basics, Forces, Friction, Braking
7 lessons
Section 1: Powertrain
Engines, Transmissions, Drivetrains
7 lessons
Section 2: Dynamics
Suspension, Steering, Handling
6 lessons
Section 3: Electronics
ECU, Sensors, CAN Bus
6 lessons
Section 4: Safety
Crash Testing, ADAS, Airbags
5 lessons
Interactive Features:
3D car models (Porsche 911, BMW M4, Ford F-150)
Interactive car component diagrams
Performance calculators
Gear ratio calculations
Real-world vehicle specs
⚡ Electronics (30+ Lessons)
Complete electronics and robotics curriculum
Section
Topics
Lessons
Section 0: Foundations
Circuits, Ohm's Law, Components
6 lessons
Section 1: Digital
Logic Gates, Digital Systems
6 lessons
Section 2: Microcontrollers
Arduino, Programming, I/O
6 lessons
Section 3: Sensors
Types, Interfacing, Applications
6 lessons
Section 4: Communication
Serial, I2C, SPI, Wireless
6 lessons
Interactive Features:
Circuit Lab simulation
Component diagrams
Code examples
Real-world project ideas
🏗️ Civil Engineering (25+ Lessons)
Complete civil engineering curriculum
Section
Topics
Lessons
Section 0: Foundations
Engineering Basics, Materials
5 lessons
Section 1: Surveying
Land Surveying, GPS, Mapping
5 lessons
Section 2: Materials
Concrete, Steel, Composites
5 lessons
Section 3: Structural
Beams, Columns, Load Analysis
5 lessons
Section 4: Water
Hydraulics, Water Systems
5 lessons
Interactive Features:
Structural calculators
Material property tables
Load analysis tools
Real-world case studies
🔐 Authentication & Security
Authentication Methods
Method
Description
Email/Password
Traditional signup with email verification
Google OAuth
One-click Google sign-in
Session Management
Secure JWT tokens via Supabase
Security Features
Feature
Description
Fingerprint Detection
Device fingerprinting for fraud prevention
Rate Limiting
API rate limiting to prevent abuse
Row Level Security
Supabase RLS for data protection
Secure Storage
Encrypted credential storage
HTTPS Only
All traffic encrypted
Auth Context Features
// Available in useAuth() hook-user(currentuserobject)-signIn(email,password)-signUp(email,password,username)-signInWithGoogle()-signOut()-loadingstate-errorhandling
🗄️ Database & Backend
Supabase Tables
Table
Purpose
profiles
User profiles, avatars, usernames
progress
Lesson completion, quiz scores
xp_transactions
XP earning history
achievements
Unlocked achievements
streaks
Daily streak tracking
community_posts
Forum posts
community_comments
Post comments
community_votes
Upvotes/downvotes
leaderboard
Cached rankings
Database Features
Real-time Subscriptions: Live updates for leaderboard, community
Row Level Security: Users can only access their own data
Automatic Timestamps: created_at, updated_at
Foreign Key Constraints: Data integrity
Indexes: Optimized queries
Progress Context
// Available in useProgress() hook-progress.completedLessons-progress.quizScores-progress.xp-progress.level-progress.streak-progress.achievements-completeLesson(lessonId,score)-addXP(amount,reason)-unlockAchievement(achievementId)
🤖 AI Features (EnGo Tutor)
Powered by Google Gemini 2.0 Flash
Floating AI Helper
Always Available: Floating button on every page
Context Aware: Knows current lesson, subject, user progress
Quick Actions:
💡 Explain Concept
🔢 Help with Math
📊 Draw Diagram
🌍 Real Examples
AI Capabilities
Feature
Description
Lesson Explanations
Detailed concept breakdowns
Math Help
Step-by-step problem solving
Diagram Generation
ASCII/text diagrams
Real Examples
Industry applications
Homework Solver
Complete problem solutions
Project Insights
Career project recommendations
JARVIS Mode (3D Analysis)
Model Identification: AI identifies uploaded 3D models
# Clone repository
git clone https://github.com/yousef469/Engineeruim.git
cd Engineeruim
# Install dependencies
npm install
# Setup environment
cp .env.example .env
# Edit .env with your API keys# Run development server
npm run dev
# Build for production
npm run build
