A motion-controlled adventure fitness game for elementary kids, built with ❤️ by MiniMax Agent
Fitness Quest is an engaging motion-controlled adventure game designed to get elementary school children (ages 5-11) moving and having fun! Players control their avatar through exciting jungle courses using physical movements detected by the device camera.
- Motion Detection: Uses tablet camera to detect body movements (jump, duck, run, lean, reach, freeze)
- Keyboard Fallback: Arrow keys, Space, and Shift for testing without camera
- 5 Adventure Levels: Progressive difficulty from "Practice Path" to "Jungle Treasure Challenge"
- Collectibles System: Gather coins and earn stars for completing quests
| Screen | Purpose |
|---|---|
| 🏠 Welcome | Animated landing with mascot Questy |
| 👤 Profile | Player selection and creation |
| 🎨 Avatar | Customizable character (skin, hair, outfit, hat) |
| 🗺️ Quest Map | Level selection with progress tracking |
| 📷 Camera Setup | Safety checklist before gameplay |
| 📚 Tutorial | Practice movements before quests |
| 🎯 Gameplay | Side-scrolling adventure with obstacles |
| 🏆 Rewards | Star/coin collection and achievement display |
| 📊 Dashboard | Parent/teacher view with weekly stats |
| ⚙️ Settings | Audio, accessibility, and difficulty options |
- 🦽 Seated Mode: For wheelchair users
- ✋ No Jump Mode: Alternative movements only
- 🧘 Low Stimulation Mode: Reduced visual complexity
- 🐢 Slow Reaction Mode: More time to respond
- 🎨 Reduced Motion: Minimize animations
- Node.js 18+
- npm 9+
# Clone the repository
git clone https://github.com/YOUR_USERNAME/fitness-quest.git
cd fitness-quest
# Install dependencies
npm install
# Start development server
npm run dev
# Build for production
npm run build| Movement | Keyboard |
|---|---|
| Jump | ⬆️ Arrow Up |
| Duck | ⬇️ Arrow Down |
| Run in Place | Space |
| Lean Left | ← Left Arrow |
| Lean Right | → Right Arrow |
| Reach Up | ↑↑ Double Arrow Up |
| Freeze | Shift |
- React 18.2.0 - UI framework
- Vite 5.0.0 - Build tool
- Framer Motion 10.16.4 - Animations
- Lucide React - Icons
fitness-quest/
├── src/
│ ├── App.jsx # Main application (all components)
│ ├── main.jsx # Entry point
│ └── index.css # Custom CSS utilities
├── index.html # HTML entry point
├── package.json # Dependencies
└── vite.config.js # Vite configuration
The app features a vibrant jungle theme with:
- Custom Google Fonts (Fredoka One, Nunito)
- Animated backgrounds with floating elements
- Child-friendly color palette (greens, oranges, blues)
- Large touch targets for young users
fitness-game adventure-game kids-game react framer-motion vite
elementary-school motion-control health fitness children
MIT License - Feel free to use and modify!
Built with ❤️ by MiniMax Agent
Making fitness fun, one adventure at a time!