mahjong.io is a browser-based Mahjong platform built for NUS Orbital 2025 that adapts to any group size — whether you’re playing solo or with friends. The platform makes Mahjong accessible, customizable, and fun for both beginners and seasoned players.
Play casually, sharpen your skills through quizzes and tutorials, or enjoy competitive matches with bots that seamlessly fill in when seats are empty.
🌐 Live site: mahjong-io.onrender.com
-
Flexible Gameplay
- Supports solo, duo, trio, or full 4-player Mahjong sessions.
- Bots fill empty seats automatically, ensuring fast and uninterrupted games.
-
Customization & Rewards
- Earn in-game currency through matches.
- Unlock and apply custom tile skins and board themes in our Shop for a personalized experience.
-
Learning Tools
- Tutorial Mode: Step-by-step guide for beginners to learn the rules.
- Quiz Mode: Practice identifying valid hands and test your Mahjong knowledge.
-
Accessibility
- 100% browser-based, no installation required.
- Play anywhere, anytime — on desktop or mobile.
- Frontend: React + Vite, TailwindCSS
- Backend: Python (FastAPI) + WebSockets
- Database & Auth: Supabase
- Deployment: Render