The open-source playground for junior developers
Submit games · Earn XP · Collect badges · Build your portfolio
🌐 Live Site • Quick Start • Contribute • Gamification • Guidelines
Platform is a GitHub-based community where junior developers can make their first open-source contributions by:
- 🎮 Submitting simple games — CLI, web, or algorithm games
- 🌍 Contributing translations — Help us reach a global audience
- 🏆 Competing on leaderboards — Community votes rank the best games weekly
- 📊 Building GitHub history — Every merged PR appears on your profile
- 🎓 Learning real workflows — PRs, code review, CI/CD, and automation
Every expert was once a beginner. This is where your open-source journey starts.
Platform/
├── games/
│ ├── cli/ # Terminal-based games
│ ├── web/ # Browser-based games
│ └── algorithm/ # Algorithm puzzles & challenges
├── translations/
│ ├── README/ # README translations
│ ├── CONTRIBUTING/ # Contributing guide translations
│ └── guides/ # Guide translations
├── data/ # Generated data + schema.ts
├── scripts/ # Build & validation scripts
├── web/ # Astro web platform
│ ├── src/pages/ # Pages (games, leaderboard, profiles)
│ └── src/components/ # Reusable UI components
├── docs/ # Documentation & guides
├── .github/
│ └── workflows/ # CI/CD automation (4 workflows)
├── CONTRIBUTING.md # Contribution guidelines
├── CODE_OF_CONDUCT.md # Code of conduct
└── README.md # You are here!
- Fork this repository
- Create a branch:
git checkout -b game/your-game-name - Add your game in
games/<category>/your-game-name/ - Include these files:
README.md— How to play + what you learnedmetadata.json— Game info (template)- Your source code (max 5 files, max 500 lines)
- Open a PR using the Game Submission template
- Wait for review — our bots will validate automatically!
- Fork this repository
- Create a branch:
git checkout -b translation/lang-code - Add your translation in
translations/with formatFILENAME.LANG_CODE.md - Open a PR using the Translation template
- Auto-merge — if all checks pass, translations merge automatically!
|------|--------|----------|------------| | Number Guessing | @platform-bot | Python | Beginner |
| Game | Author | Language | Difficulty |
|---|---|---|---|
| Rock Paper Scissors | @platform-bot | HTML/CSS/JS | Beginner |
| ➡️ Want to see your game here? Submit one now! |
No game submissions this week. Be the first!
| Rank | Contributor | Contributions |
|---|---|---|
| 🥇 | @AbdullahOztoprak | 8 |
Last updated: Sun, 08 Mar 2026 12:06:01 GMT
💡 How voting works: React with 👍 on game PRs to vote! Top 3 games are featured weekly.
Special recognition for outstanding contributors:
| Badge | Criteria | Recipients |
|---|---|---|
| 🥇 First Contributor | First merged PR | — |
| 🎮 Game Master | 5+ games submitted | — |
| 🌍 Translation Champion | 3+ translations | — |
| ⭐ Weekly Champion | #1 on weekly leaderboard | — |
| 🔥 Streak Hero | 4 consecutive weekly contributions | — |
| 🐛 Bug Hunter | Found & reported a significant bug | — |
This project is fully automated with 4 consolidated GitHub Actions:
| Workflow | Trigger | What it Does |
|---|---|---|
| CI Pipeline | PR opened/updated | Detects type, validates, lints, security scan |
| Deploy | Push to main | Builds data index, deploys web site |
| Community | PR/Issue | Welcome bot, anti-spam, stale management |
| Leaderboard | Weekly (Sunday) | Calculates XP-weighted rankings |
Generated data files
The canonical generated data files (data/games.json, data/contributors.json, data/leaderboard.json) are produced from the source-of-truth content and are updated automatically on the main branch by automation. Contributors should not commit changes to these files in feature branches — pull requests that touch these files will be blocked by automation checks. If you need to preview generated data locally, run npm run build:data and do not commit the results.
| Action | XP Earned |
|---|---|
| First contribution | +50 |
| Game merged | +100 |
| Translation merged | +30 |
| Reviewed a PR | +20 |
| Received 👍 vote | +5 |
| Weekly #1 | +200 |
| Weekly #2 | +100 |
| Weekly #3 | +50 |
- 🟢 Beginner games: 1.0x points
- 🟡 Intermediate games: 1.5x points
- 🔴 Advanced games: 2.0x points
| Level | XP Required | Title |
|---|---|---|
| 1 | 0 | Newcomer |
| 2 | 100 | Contributor |
| 3 | 300 | Regular |
| 4 | 600 | Expert |
| 5 | 1000+ | Master |
🎮 Game Master (5+ games) • 🌍 Translator (3+ translations) • ⭐ Champion (Weekly #1) • 🔥 Streak Hero (4-week streak) • 👀 Reviewer (10+ reviews) • 💎 OG (First 10 contributors)
| Language | README | Contributing | Beginner's Guide |
|---|---|---|---|
| 🇬🇧 English | ✅ | ✅ | ✅ |
| 🇹🇷 Turkish | ❌ Help wanted! | ❌ | ❌ |
| 🇪🇸 Spanish | ❌ Help wanted! | ❌ | ❌ |
| 🇫🇷 French | ❌ Help wanted! | ❌ | ❌ |
| 🇩🇪 German | ❌ Help wanted! | ❌ | ❌ |
| 🇯🇵 Japanese | ❌ Help wanted! | ❌ | ❌ |
| 🇧🇷 Portuguese | ❌ Help wanted! | ❌ | ❌ |
➡️ Pick a language and start translating!
- 📋 Contributing Guide — Rules, templates, and process
- 📖 Beginner's Guide — Step-by-step for first-timers
- 🔒 Security Policy — How we keep submissions safe
- 📜 Code of Conduct — Community standards
- 🗺️ Roadmap — Future plans for the platform
We take security seriously. Game submissions are:
- ✅ Scanned for dangerous functions (
eval,exec,subprocess, etc.) - ✅ Checked for network access attempts
- ✅ Validated for allowed file types only
- ✅ Limited to 5 files and 500 lines per submission
- ✅ Reviewed by maintainers before merging
See our full Security Policy for details.
- Core repository structure
- GitHub Actions automation
- Gamification & leaderboard system
- Anti-spam & security protection
- Web frontend for browsing games
- Contributor profiles & badges (partial)
- API for game metadata
- Hosted game playground (try games in browser)
- Monthly community challenges
- Integration with Discord/Slack
See the full Roadmap for details.
If you find this project useful, please give it a ⭐ star! It helps others discover the platform.
This project is licensed under the MIT License.
Built with ❤️ for the open-source community
Every contribution matters. Start your journey today.