Transform Your Learning Journey Into an Epic RPG Adventure
Turn the grind of deliberate practice into an addictive heroic progression loop
Features • Screenshots • Installation • Tech Stack • Contributing
Skill-Forge is a revolutionary mobile RPG that gamifies cognitive skill mastery in Coding, Mathematics, and Logic. Unlike generic habit trackers, Skill-Forge directly translates focused study time into character progression, turning monotonous academic practice into an engaging, rewarding experience.
STEM students and self-learners often struggle with:
- Invisible Progress: Traditional study methods lack immediate feedback
- Motivation Loss: The disconnect between effort and reward leads to burnout
- Dishonest Tracking: Generic to-do lists are easy to skip without accountability
Skill-Forge bridges the gap between study and gaming through:
- Real-World Stat Mapping: Level up specific skills like (Coding, Math, Problem Solving) by logging focused time
- Boss Battle Verification: AI-generated quizzes ensure honest progress tracking
- Visual Skill Trees: Node-based graphs showcasing intellectual growth
- Edu Coins Economy: Earn rewards redeemable for courses and Amazon coupons
- Robust Pomodoro-style timer for focused study sessions
- Automatic XP and Edu Coins calculation
- Do Not Disturb mode integration for distraction-free learning
- Fundamental Quiz: Tests basics of completed tasks (available for 24 hours)
- Advanced Quiz: Unlocks 3 days after Fundamental quiz with adaptive difficulty
- AI-powered quiz generation based on your task descriptions
- Must score 70%+ to conquer the boss and earn rewards
- Cyber-Fantasy aesthetic with glowing nodes
- Track your intellectual growth through an interactive graph
- Unlock new abilities and milestones as you progress
- Spend Edu Coins on cosmetic upgrades
- Unlock visual enhancements
- Future: Redeem for educational courses and Amazon vouchers
- Streak mechanics with daily challenges
- "Code for 30 mins today" style achievements
- Consistent rewards to build study habits
- Level-up animations and sound effects
- XP progress bars on every screen
- Satisfying visual feedback for every action
- Dark mode UI with neon RPG elements
- Unlimited Task Tracking: Free tier limited to 3 active tasks
- Advanced Analytics: Peak performance hours and skill decay charts
- Ad-Free Experience: Remove all advertisements
- Price: ₹149/month
- Framework: Jetpack Compose (Modern Android UI)
- Architecture: MVVM (Model-View-ViewModel)
- Language: Kotlin
- Backend: Firebase Studio
- Firestore: Cloud database for user data
- Firebase Auth: Secure authentication
- Cloud Functions: Anti-cheat logic and serverless operations
- AI Integration: Gemini API for quiz generation and task tracking
- Monetization: Google Mobile Ads SDK (AdMob)
- Jetpack Components: Navigation, ViewModel, LiveData
- Dependency Injection: Hilt/Dagger
- Networking: Retrofit, OkHttp
- Coroutines: Asynchronous programming
- Material Design 3: Modern UI components
- Android Studio Hedgehog (2023.1.1) or newer
- JDK 17 or higher
- Android SDK API 24+
- Active internet connection for Firebase
- Clone the Repository
git clone https://github.com/Arhanpg/Skill-Forge.git
cd Skill-Forge- Configure Firebase
- Create a Firebase project at Firebase Console
- Download
google-services.jsonand place it in theapp/directory - Enable Firestore, Authentication, and Cloud Functions
- Add Gemini API Key
Create a
local.propertiesfile in the root directory:
GEMINI_API_KEY=your_gemini_api_key_here- Add AdMob Configuration
Update
AndroidManifest.xmlwith your AdMob App ID:
<meta-data
android:name="com.google.android.gms.ads.APPLICATION_ID"
android:value="ca-app-pub-4021531566495189~XXXXXXXXXX"/>- Build and Run
./gradlew assembleDebugOr use Android Studio's "Run" button.
-
Create Your Hero
- Launch the app and create your avatar
- Choose your starting specialization
-
Start Your First Quest
- Tap "Start Quest" on the home screen
- Select a skill (Coding, Math, Problem Solving)
- Create a task with a detailed description
- Set your focus timer (recommended: 25-45 minutes)
-
Focus & Complete
- Study during the timer countdown
- Enable DND mode for best results
- Complete your task before time runs out
-
Conquer the Boss
- Take the Fundamental Quiz within 24 hours
- Score 70%+ to defeat the boss
- Earn XP, level up, and collect Edu Coins
- Advanced Quiz unlocks after 3 days
-
Grow Your Skills
- Watch your Skill Tree expand
- Purchase upgrades in the Shop
- Complete Daily Quests for bonuses
- Track your progress through Analytics
- Full access to core features
- Up to 3 active tasks
- Banner ads on passive screens
- Optional rewarded video ads for bonuses
- Focus Boost: 1.5x XP multiplier (watch before session)
- Second Wind: Retry failed boss without cooldown
- User-initiated, never intrusive
- Limited per session to maintain quality
- Unlimited task tracking
- Advanced analytics dashboard
- Ad-free experience
- Priority support
- Hero creation and stat system
- Focus timer with XP calculation
- AI-powered Boss Battle quizzes
- Basic Skill Tree visualization
- Inventory and cosmetic shop
- Daily Quest system
- Streak mechanics and rewards
- Enhanced animations and sound effects
- Social sharing for Boss victories
- Edu Coins redemption system
- Skill-Grid: Connect with users having complementary skills
- Project collaboration features
- Leaderboards and achievements
- Content marketplace for custom skill templates
- Additional skill categories
- Guilds and multiplayer features
- Advanced course integrations
- Web dashboard for desktop tracking
We welcome contributions from the community! Here's how you can help:
- Report Bugs: Open an issue with detailed reproduction steps
- Suggest Features: Share your ideas in the Discussions tab
- Submit Pull Requests: Fix bugs or add features
- Improve Documentation: Help make our docs clearer
- Share Feedback: Tell us about your experience
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Follow Kotlin coding conventions
- Write meaningful commit messages
- Add tests for new functionality
- Submit a Pull Request with detailed description
- Follow Kotlin Style Guide
- Use meaningful variable and function names
- Comment complex logic
- Keep functions small and focused
This project is licensed under the MIT License - see the LICENSE.md file for details.
- Arhan Ghosarwade - Primary Contact & Lead Developer
- Email: arhanghosarwade05@gmail.com
- AdMob Publisher ID: pub-4021531566495189
- Google AdMob for monetization support
- Firebase for backend infrastructure
- Gemini AI for intelligent quiz generation
- The Android developer community
- All our beta testers and early adopters
- Issues: GitHub Issues
- Email: arhanghosarwade05@gmail.com
- Documentation: Wiki
If Skill-Forge helps you master your skills, give it a ⭐️!
Level Up Your Learning. Forge Your Future.
Made with ❤️ by Team A³