DevQuest is a gamified open-source learning platform that transforms your journey into open source from daunting to legendary. Complete challenges, earn ranks, unlock achievements, and join a community of passionate developers — all through the power of GitHub.
🚀 Start Your Quest · 🏆 View Leaderboard · 📚 Browse Challenges · 🤝 Contribute
____ ___ _
| _ \ _____ _ / _ \ _ _ ___ ___| |_
| | | |/ _ \ \ / / | | | | | | |/ _ \/ __| __|
| |_| | __/\ V / | |_| | |_| | __/\__ \ |_
|____/ \___| \_/ \__\_\\__,_|\___||___/\__|
Your open source adventure begins here.
- ✨ Features
- 🎮 Challenge System
- 🏅 Ranking System
- 🚀 Getting Started
- 📚 Resources
- 🗺️ Roadmap
- 🏆 Hall of Fame
- 🤝 Contributing
- ❓ FAQ
- 📊 Stats
Five progressive levels plus bonus challenges guide you from your first fork to becoming a community pillar. Earn ranks from Rookie to Legend as you complete challenges and contribute to the community. Unlock GitHub achievements like Pull Shark, Galaxy Brain, and Pair Extraordinaire with our guided paths. | Your contributions are tracked in our community leaderboard — see where you stand among fellow questers. Comprehensive guides on Git, GitHub, Markdown, Pull Requests, and Open Source best practices. Beginner-friendly environment with mentors, reviewers, and helpers at every step. |
DevQuest features 5 progressive levels and bonus challenges to keep you growing.
| Level | Challenge | XP | Difficulty |
|---|---|---|---|
| ⚔️ Level 1 | First Fork | 50 XP | 🟢 Beginner |
| 🛡️ Level 2 | First Pull Request | 150 XP | 🟢 Beginner |
| 🔥 Level 3 | First Merged PR | 300 XP | 🟡 Intermediate |
| 🌟 Level 4 | Open Source Explorer | 500 XP | 🟡 Intermediate |
| 👑 Level 5 | Community Contributor | 1000 XP | 🔴 Advanced |
| 💎 Bonus | Bonus Challenges | Variable | 🔴 Advanced |
Fork Repo → Complete Challenge → Open PR → Get Reviewed → Earn XP → Level Up!
🍴 📝 🔀 👀 ⭐ 🎉
Each challenge includes:
- 🎯 Clear Objective — exactly what you need to do
- 📋 Requirements — step-by-step instructions
- 🎁 Rewards — XP, badges, and rank progress
- 💡 Tips — hints to make it easier
- 🔗 Resources — learning materials
Progress through the DevQuest ranks by earning XP and completing challenges.
| Rank | Badge | XP Required | Unlocks |
|---|---|---|---|
| Rookie | 🔰 | 0 XP | Access to Level 1 & 2 challenges |
| Contributor | 🥉 | 200 XP | Access to Level 3, Profile badge |
| Collaborator | 🥈 | 600 XP | Access to Level 4, Reviewer role |
| Open Source Hero | 🥇 | 1200 XP | Access to Level 5, Mentor badge |
| Legend | 👑 | 2500 XP | Hall of Fame, Special flair |
🔰 Rookie ──► 🥉 Contributor ──► 🥈 Collaborator ──► 🥇 Open Source Hero ──► 👑 Legend
0 XP 200 XP 600 XP 1200 XP 2500 XP
Follow these steps to begin your DevQuest:
# After forking, clone your fork
git clone https://github.com/rohanbyale/devquest.git
cd devquestOpen CONTRIBUTORS.md and add your entry using the template provided in that file.
git checkout -b add/your-username
# Edit CONTRIBUTORS.md
git add CONTRIBUTORS.md
git commit -m "feat: add YOUR_USERNAME to contributors"
git push origin add/your-usernameThen open a Pull Request — that's Level 2 unlocked! 🎉
Head to the CHALLENGES folder and work your way up. Each level builds on the last.
| Resource | Description |
|---|---|
| 🔧 Git Guide | Everything from init to rebase |
| 🐙 GitHub Guide | PRs, Issues, Actions, and more |
| 🌍 Open Source Guide | How open source works |
| 📝 Markdown Guide | Write beautiful docs |
| 🔀 Pull Requests Guide | Master the art of PRs |
| 🏆 GitHub Achievements | Unlock every achievement |
See the full roadmap in docs/roadmap.md.
| Quarter | Feature |
|---|---|
| Q3 2025 | ✅ Core challenge system |
| Q3 2025 | ✅ Ranking & leaderboard |
| Q4 2025 | 🔄 GitHub Actions automation |
| Q4 2025 | 🔄 Discord bot integration |
| Q1 2026 | 🔜 Interactive web dashboard |
| Q1 2026 | 🔜 Automated XP tracking |
| Q2 2026 | 🔜 Mentor matching system |
| Q2 2026 | 🔜 Team challenges |
Our Legends — developers who reached the top rank:
Be the first to join the Hall of Fame! Complete all challenges and reach 2500 XP.
| Rank | Username | XP | Joined |
|---|---|---|---|
| 👑 #1 | Your name here | — | — |
| Position | Username | Contributions |
|---|---|---|
| 🥇 #1 | Your name here | — |
| 🥈 #2 | Your name here | — |
| 🥉 #3 | Your name here | — |
We love contributions! DevQuest is built by the community for the community.
- 🍴 Fork this repository
- 🌿 Create a branch:
git checkout -b your-feature - ✏️ Make your changes
- ✅ Commit:
git commit -m "feat: your feature" - 🚀 Push:
git push origin your-feature - 🔀 Open a Pull Request
Read the full guide in CONTRIBUTING.md.
- 🐛 Fix typos or broken links
- 📝 Improve documentation
- 💡 Suggest new challenges
- 🎨 Improve formatting
- 🌐 Translate resources
- ⭐ Star the repo!
Q: I'm a complete beginner. Can I participate?
Absolutely! DevQuest is designed for beginners. Level 1 & 2 require no coding skills at all — just enthusiasm.
Q: How is XP tracked?
Currently XP is tracked manually via our LEADERBOARD.md. Automated tracking is on the roadmap!
Q: How long does each challenge take?
Level 1–2: 15–30 minutes. Level 3–4: a few hours. Level 5 and Bonus: ongoing.
Q: Can I skip levels?
Levels should be completed in order, but you can attempt Bonus Challenges at any time.
See the full FAQ in docs/faq.md.
This project is licensed under the MIT License — see the LICENSE file for details.
Made with ❤️ by the DevQuest Community
If DevQuest helped you, please ⭐ star the repo and share it with a friend!
