IronForge RPG is an AI-augmented strength training platform that transforms your fitness journey into a grand strategy RPG. Train, battle raid bosses, and ascend through the ranks.
- 🧠 The Oracle AI: Adaptive training intelligence (Gemini 2.5 Flash) that analyzes recovery, sleep, and performance to generate tailored programs.
- ⚔️ Boss Battles & PvP: Join factions, battle raid bosses, and compete in PvP seasons where physical effort deals real digital damage.
- 📊 Cross-Domain Integration: Unified fitness data from Hevy (Strength) and Intervals.icu (Physiology/Cardio).
- 🏆 RPG Progression: Deep skill trees, equipment armory, and ranks that reflect your real-world progress.
- 🌌 Titan Vision: Computer vision-based rep counting and form detection (MediaPipe).
- Framework: Next.js 15 (App Router)
- Database: PostgreSQL via Prisma & Supabase
- AI: Google Gemini 2.5 Flash
- Styling: Tailwind CSS & shadcn/ui
- Verification: Vitest (Unit/Integration) & Playwright (E2E)
- Deployment: Vercel & GitHub Actions
-
Clone & Install:
npm install
-
Environment Setup: Create a
.envfile based on .env.example:DATABASE_URL="your-postgres-url" DIRECT_URL="your-direct-url" INTERVALS_API_KEY="your-key" INTERVALS_ATHLETE_ID="your-id" HEVY_API_KEY="your-token"
-
Database Migration:
npx prisma migrate dev
-
Launch:
npm run dev
This repo is configured to enforce quality via Pull Requests.
- Go to Settings > Branches.
- Add rule for
main:- Require a pull request before merging
- Require status checks to pass before merging
- Search and select:
verify(Lint/Test/Build) - Search and select:
e2e(optional but recommended)
- Search and select:
- Do not allow bypassing the above settings
IronForge RPG is optimized for Vercel. Every push to main is automatically verified and deployed.
- Production: ironforge-rpg.vercel.app
- CI/CD: Managed via GitHub Actions (
agent-verify.ymlanddeploy.yml).
Private Repo - © 2025 IronForge RPG.