Open Source 2D Gaming Platform - Play, Compete, and Create Together!
Welcome to 2D Champion - a community-driven platform where gamers play, compete on global leaderboards, and developers collaborate to build amazing 2D games!
🌐 Live Platform: 2d-champion.vercel.app
- 🎯 Play Free Games - Enjoy a growing collection of 2D games, all free and open source
- 🏆 Global Leaderboards - Compete with players worldwide and climb the ranks
- 👥 User Profiles - Track your scores, achievements, and contributions
- 🔧 Open Source - All game code is public and available for contribution
- 📱 Responsive Design - Play on desktop, tablet, or mobile
- 🔐 Secure Authentication - Powered by Supabase with row-level security
| Game | Description | Play Count |
|---|---|---|
| Highway Hero | Dodge traffic and survive as long as you can! | 🚗 |
| Pixel Python | Classic snake game with a modern twist | 🐍 |
More games coming soon! Contribute yours
- Visit the platform (or run locally)
- Browse available games
- Click "Play" and start gaming!
- Sign up to save your high scores
# Clone the repository
git clone https://github.com/bytestrix/2DChampion.git
cd 2DChampion
# Install dependencies for the web platform
cd web
npm install
# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your Supabase credentials
# Run the development server
npm run dev
# Open http://localhost:3000- Create a Supabase project
- Run the SQL schema in the Supabase SQL Editor:
# The schema file is located at: supabase/schema.sql - Copy your Supabase credentials to
.env.local
2DChampion/
├── web/ # Next.js web application
│ ├── src/
│ │ ├── app/ # App router pages
│ │ ├── components/ # Reusable components
│ │ ├── lib/ # Supabase client & utilities
│ │ └── types/ # TypeScript types
│ └── public/ # Static assets
├── games/ # Game source files
│ ├── highway-hero/ # Highway Hero game
│ ├── pixel-python/ # Pixel Python game
│ └── [your-game]/ # Add your game here!
├── docs/ # Documentation site (coming soon)
└── supabase/ # Database schemas & migrations
└── schema.sql # Database schema
- Framework: Next.js 16 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS + Custom CSS
- Icons: Lucide React
- Hosting: Vercel (recommended)
- Database: Supabase (PostgreSQL)
- Authentication: Supabase Auth
- Storage: Supabase Storage (for game assets)
- Real-time: Supabase Realtime (for leaderboards)
- Technologies: Next.js (React), Tailwind CSS, TypeScript, Supabase
- Canvas API for game rendering
- No heavy game frameworks - keep games lightweight!
We welcome contributions from developers of all skill levels! Here's how you can help:
Important: Contributors don't need database access! Follow this simple workflow:
- Propose Your Idea - Create a GitHub Issue describing your game
- Fork the Repository - Clone and create your game component
- Build Your Game - Develop in a new subfolder:
games/your-game-name/YourGame.tsx- Use the existing game components as templates
- Implement scoring, controls, and game logic
- Test locally (game works without database connection)
- Create a PR - Submit with:
- Game component code
- Thumbnail image (512x512 PNG)
- Instructions on how to play
- Any special dependencies
- Maintainers Handle Backend - We'll register your game in the database and deploy
You DON'T need:
- ❌ Supabase credentials
- ❌ Database access
- ❌ Deployment permissions
Maintainers will:
- ✅ Review and test your game
- ✅ Register it in the platform
- ✅ Handle database setup
- ✅ Deploy to production
See SECURITY.md for more details on the separation between contributors and maintainers.
- 🐛 Report bugs
- 💡 Suggest features
- 🎨 Improve UI/UX
- 📖 Write documentation
- 🧪 Add tests
- Getting Started - Set up your development environment
- Game Development Guide - Learn how to create games
- API Reference - Supabase database schema & functions
- Deployment Guide - Deploy your own instance
- All sensitive credentials are kept in environment variables (never committed)
- Row Level Security (RLS) protects user data
- Supabase's anon key is safe for frontend use
- Authentication handled securely by Supabase Auth
- ⭐ Star this repo if you like the project!
- 🐛 Report bugs via GitHub Issues
- 💬 Discussions on GitHub Discussions
- 📢 Follow updates on Twitter (coming soon!)
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
- ✅ You can use this code for free
- ✅ You can modify and distribute it
- ✅ You can use it commercially
⚠️ You must open source any modifications⚠️ You must use the same GPL-3.0 license
- Built with ❤️ by the open source community
- Powered by Supabase
- Deployed on Vercel
- Styled with Tailwind CSS
- Core platform with authentication
- Game listing and playing
- Leaderboard system
- User profiles with stats
- Game rating and reviews`
- Achievements and badges
- Multi-player support
- Game tournaments
- Mobile app (React Native)
Have questions or suggestions? Reach out!
- GitHub: @bytestrix
- Email: bytestrix@gmail.com
Made with 💜 by the 2D Champion community
Play games. Break records. Build together. 🎮✨