How vadlamanoj/life-rpg works
LIFE RPG is a web app and Android companion that turns user goals into adaptive, game-like campaigns. The principal journey is goal entry and interpretation, campaign/quest progression, real-world action with evidence, evaluation, and rewards or adjusted difficulty; milestones and boss battles mark campaign progress. The README also documents player progression, social, analytics, journal, and integration capabilities. The sampled engines clarify goal parsing, evidence checks, grading, adaptation, and integrations; unsampled API wiring is represented only at the application boundary.
Main entry points: main.py Backend API · main.jsx Web interface · goal_engine.py Goal understanding · quiz_engine.py Quizzes and boss tests
Components 24
Player experience
- Web interface
frontend/src/main.jsx - Backend API
backend/app/main.py - Accounts and settings
backend/app/main.py - Player state
backend/app/main.py
Campaign creation
- Goal understanding
backend/app/goal_engine.py - Natural language parsing
backend/app/nlp_engine.py - Campaign and milestones
backend/app/goal_engine.py - Quest planning
backend/app/goal_engine.py
Quest and progression
- Quest experience
frontend/src/main.jsx - Quizzes and boss tests
backend/app/quiz_engine.py - Assessment grading
backend/app/evaluation_engine.py - Evidence review
backend/app/evidence_engine.py - Adaptive progression
backend/app/adaptive_engine.py - Quest recommendations
backend/app/recommendation_engine.py - Rewards and skills
backend/app/main.py - Analytics and journal
frontend/src/main.jsx - Community and achievements
frontend/src/main.jsx
External connections
- Integration controls
frontend/src/main.jsx - Provider sync
backend/app/integrations_engine.py - Health Connect reader
android-bridge/app/src/main/java/com/liferpg/bridge/HealthConnectManager.kt - Android sync client
android-bridge/app/src/main/java/com/liferpg/bridge/BridgeSyncClient.kt
Other components
- Player
- OpenAI
- External providers
Connections 26
- Player → Web interface: uses
- Web interface → Backend API: API requests
- Backend API → Accounts and settings: handles accounts
- Accounts and settings → Player state: reads and writes
- Backend API → Goal understanding: interprets goals
- Backend API → Natural language parsing: parses input
- Backend API → Campaign and milestones: creates campaigns
- Backend API → Quest planning: plans quests
- Web interface → Quest experience: presents quests
- Backend API → Quizzes and boss tests: provides assessments
- Backend API → Assessment grading: grades answers
- Backend API → Evidence review: reviews submissions
- Backend API → Adaptive progression: adjusts progression
- Backend API → Quest recommendations: builds guidance
- Backend API → Rewards and skills: updates progression
- Web interface → Analytics and journal: presents insights
- Web interface → Community and achievements: presents features
- Web interface → Integration controls: manages connections
- Backend API → Provider sync: handles sync
- Integration controls → Backend API: sends requests
- Health Connect reader → Android sync client: provides activity
- Android sync client → Backend API: posts activity
- Provider sync → External providers: syncs data
- Backend API → OpenAI: optional AI
- Goal understanding → OpenAI: optional inference
- Quizzes and boss tests → OpenAI: optional generation