Skip to content
MeowDev1011Public

About

A Chess game combined with UNO action cards, 100% free and ad-free

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

โ™Ÿ๏ธ UnoChess ๐Ÿƒ

The chess game that dared to mix with UNOโ€ฆ and turned out awesome.

Play Now GitHub Repo 100% Free Made with React TypeScript

UnoChess is not just chess. It is not just UNO. It is a strategic hybrid where every move matters, every card can change the fate of the game, and every match tells a different story. ๐ŸŽฒโœจ


๐Ÿ“– Table of Contents


๐Ÿค” What Is UnoChess?

UnoChess is a browser-based strategy game that blends the depth of classic chess with the unpredictability of UNO cards. ๐Ÿง ๐Ÿ’ฅ

Instead of simply moving pieces, you draw a card every turn. That card determines how many moves you can make, which special actions trigger, and how the board changes. Got a +2? Draw extra moves or recover a piece. Got a Reverse? The turn changes hands and the board flips. Got a Wild? Teleport a piece to any square. ๐Ÿ˜ฑ

The result is a game that feels familiar to chess players yet accessible to anyone who enjoys a mental challenge. You do not need to be a grandmaster to winโ€ฆ but it helps. ๐Ÿ˜‰

๐ŸŽฏ Goal: Checkmate the opposing king, or capture it, by using your cards and pieces intelligently.


๐ŸŒŸ Main Features

  • ๐Ÿƒ Unique card system: 4 colors, number cards (0โ€“9), action cards (+2, Skip, Reverse), and Wilds (Wild, Wild +4). Each card is tied to chess mechanics.
  • โ™Ÿ๏ธ Complete chess rules: Castling, en passant, promotion, check, checkmate, stalemate.
  • ๐Ÿค– AI with 10 difficulty levels: From ~400 Elo to ~2200 Elo. The AI uses cards strategically, chooses Wild colors, and decides when to teleport or attack.
  • ๐Ÿ‘ฅ Local multiplayer: Play on the same device in Tabletop (both see the board) or Pass & Play (screen hidden between turns).
  • ๐Ÿ” Account system & Lichess login: Create an account or sign in with your Lichess credentials to save your progress, stats, and online profile.
  • ๐ŸŒ Online multiplayer: Play against other players online or invite friends to a private match with a shareable link.
  • โฑ๏ธ Varied time controls: Unlimited, Bullet, Blitz, Rapid, and Classical presets.
  • ๐ŸŒ 25-language interface: Automatic browser detection and manual selector.
  • ๐ŸŽจ Modern responsive design: Tailwind CSS, Motion animations, Lucide icons. Works on desktop, tablet, and mobile.
  • ๐Ÿ”Š Immersive audio: Sound effects for moves, captures, cards, and victory, with mute.
  • ๐Ÿง  Built-in card guide: A modal explains every card and its effects.
  • ๐Ÿ’ฏ Free and ad-free: No monetization, no tracking. Just the game.

๐ŸŽฏ How to Play

  1. Choose mode: AI ๐Ÿค–, local multiplayer ๐Ÿ‘ฅ, or online ๐ŸŒ.
  2. Pick your side: White โ™” or Black โ™š.
  3. Set time control: From lightning-fast to classical.
  4. Play! Each turn:
    • ๐Ÿ“ค Draw a card from the deck.
    • ๐Ÿƒ The card is revealed and its effect activates.
    • โ™Ÿ๏ธ Move your pieces according to the card, or perform the special action.
    • ๐Ÿ”„ The turn passes (or reverses).
  5. Win by checkmate or by capturing the enemy king. ๐Ÿ‘‘

๐Ÿ’ก Pro tip: A 0 card may lose you a turn, but sometimes it is the strategic pause you need.


๐Ÿƒ Quick Card Guide

Card Color Main Effect Emoji
0 Any Lose turn, recover a captured piece. ๐Ÿšซ
1โ€“9 Any Move that many times (1โ€“9 moves). ๐Ÿ”ข
+2 Any Draw 2 cards or recover a piece; extra move possible. โž•
Skip Any Cancel opponentโ€™s turn. ๐Ÿ›‘
Reverse Any Flip the board 180ยฐ and change turn; can save from check. ๐Ÿ”„
Wild Special Choose a color and teleport a piece. ๐ŸŒˆ
Wild +4 Special Choose a color and attack an enemy piece. ๐Ÿ’ฅ

๐Ÿ“š Inside the game, a detailed Card Guide explains every card with examples.


๐ŸŽฎ Game Modes

๐Ÿค– Against the AI

10 difficulty levels. The AI uses cards strategically, picks Wild colors, and decides when to teleport or attack. Each level adjusts aggression, search depth, and card management.

๐Ÿ‘ฅ Local Multiplayer

  • Tabletop: Both players see the board.
  • Pass & Play: Screen hidden between turns.

๐ŸŒ Online Multiplayer

Play against other players online or invite a friend with a shareable link. No signup required to join a match via link โ€” just click and play. ๐Ÿš€


๐Ÿค– AI Difficulty Levels

Level Name Approx. Elo Behavior
1โ€“3 Basic ๐ŸŒฑ 400โ€“800 Simple play, makes mistakes.
4โ€“6 Normal ๐ŸŒฟ 1000โ€“1400 Balanced strategy.
7โ€“8 Tactical ๐ŸŒณ 1600โ€“1800 Punishes mistakes, manages resources.
9โ€“10 Master ๐Ÿ† 2000โ€“2200 Near-perfect, uses combos and teleports.

๐Ÿงช Elo is approximate. The AI also considers board state and available cards.


โฑ๏ธ Time Controls

Category Presets Description
โˆž Unlimited โˆž No clock. Perfect for learning.
Bullet โšก 1+0, 1+1, 2+1 Ultra-fast.
Blitz ๐Ÿ’จ 3+0, 3+2, 5+0, 5+3 Speed + strategy.
Rapid โณ 10+0, 10+5, 15+10 More time to plan.
Classical ๐Ÿ•ฐ๏ธ 30+0, 30+20 Slow, deep games.

โฒ๏ธ Increment = extra seconds per turn.


๐Ÿ” Account System & Lichess Login

  • Create an account to save your game history, stats, and online profile.
  • Sign in with Lichess: Use your existing Lichess credentials via OAuth to log in instantly. No new password to remember. ๐Ÿ”‘
  • Your Lichess username and rating can be displayed on your profile, bridging the two communities.

๐Ÿ“ Note: This feature set is described based on the author's information. Verify implementation details in the source code or the live app.


๐ŸŒ Online Multiplayer

  • Play with other players online in real-time matches.
  • Invite friends with a link: Generate a shareable URL and send it to a friend. They click, join, and play โ€” no signup required to accept the invite. ๐Ÿ”—
  • Private rooms: Create a match and control who joins.
  • Matchmaking: Find opponents of similar skill level (planned as the player base grows).

๐Ÿš€ This is a core feature of UnoChess. The invite-link system is designed to make sharing and playing with friends frictionless.


๐ŸŒ Available Languages

25 languages, including: ๐Ÿ‡ช๐Ÿ‡ธ Spanish ยท ๐Ÿ‡ฌ๐Ÿ‡ง English ยท ๐Ÿ‡ซ๐Ÿ‡ท French ยท ๐Ÿ‡ฉ๐Ÿ‡ช German ยท ๐Ÿ‡ฎ๐Ÿ‡น Italian ยท ๐Ÿ‡ต๐Ÿ‡น Portuguese ยท ๐Ÿ‡ท๐Ÿ‡บ Russian ยท ๐Ÿ‡ฏ๐Ÿ‡ต Japanese ยท ๐Ÿ‡จ๐Ÿ‡ณ Chinese ยท ๐Ÿ‡ฐ๐Ÿ‡ท Korean ยท ๐Ÿ‡ธ๐Ÿ‡ฆ Arabic ยท ๐Ÿ‡ฎ๐Ÿ‡ณ Hindi ยท ๐Ÿ‡น๐Ÿ‡ท Turkish ยท ๐Ÿ‡ณ๐Ÿ‡ฑ Dutch ยท ๐Ÿ‡ต๐Ÿ‡ฑ Polish ยท ๐Ÿ‡ธ๐Ÿ‡ช Swedish ยท ๐Ÿ‡ณ๐Ÿ‡ด Norwegian ยท ๐Ÿ‡ฉ๐Ÿ‡ฐ Danish ยท ๐Ÿ‡ซ๐Ÿ‡ฎ Finnish ยท ๐Ÿ‡จ๐Ÿ‡ฟ Czech ยท ๐Ÿ‡ฌ๐Ÿ‡ท Greek ยท ๐Ÿ‡ฎ๐Ÿ‡ฑ Hebrew ยท ๐Ÿ‡น๐Ÿ‡ญ Thai ยท ๐Ÿ‡ป๐Ÿ‡ณ Vietnamese ยท ๐Ÿ‡ฎ๐Ÿ‡ฉ Indonesian

๐ŸŒ Auto-detected; change anytime from the start screen.


๐Ÿ› ๏ธ Technologies Used

Technology Role
โš›๏ธ React 19 UI library.
๐Ÿ“˜ TypeScript 7 Static typing.
โšก Vite 8 Bundler & dev server.
๐ŸŽจ Tailwind CSS 4 Utility-first styling.
๐ŸŒ i18next 25-language i18n.
๐ŸŽž๏ธ Motion Animations.
๐Ÿ–ผ๏ธ Lucide React Icons.
๐Ÿง  @google/genai Optional Gemini API (future).
๐Ÿ” OAuth / Lichess API Login with Lichess.
๐ŸŒ Realtime backend Online multiplayer (implementation details in code).
โ˜๏ธ Cloudflare Pages Deployment.
๐Ÿ› ๏ธ Wrangler CLI for Cloudflare.

๐Ÿงฉ Modular architecture: engine (pure logic), components (UI), types, i18n, utils.


๐Ÿ“ Project Structure

UnoChess/
โ”œโ”€โ”€ .github/workflows/deploy.yml
โ”œโ”€โ”€ public/assets/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/          # StartScreen, ChessBoard, modalsโ€ฆ
โ”‚   โ”œโ”€โ”€ engine/
โ”‚   โ”‚   โ”œโ”€โ”€ chess.ts         # Chess rules, AI, legal moves
โ”‚   โ”‚   โ””โ”€โ”€ deck.ts          # Deck creation & shuffling
โ”‚   โ”œโ”€โ”€ i18n/
โ”‚   โ”‚   โ”œโ”€โ”€ index.ts
โ”‚   โ”‚   โ”œโ”€โ”€ languages.ts
โ”‚   โ”‚   โ””โ”€โ”€ translations.ts
โ”‚   โ”œโ”€โ”€ types/game.ts
โ”‚   โ”œโ”€โ”€ utils/audio.ts
โ”‚   โ”œโ”€โ”€ App.tsx
โ”‚   โ”œโ”€โ”€ main.tsx
โ”‚   โ””โ”€โ”€ index.css
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ tsconfig.json
โ”œโ”€โ”€ vite.config.ts
โ””โ”€โ”€ .env.example

๐Ÿ’ป Local Installation and Development

  1. Clone:

    git clone https://github.com/MeowDev1011/UnoChess.git
    cd UnoChess
  2. Install (npm or bun):

    npm install
    # or
    bun install
  3. Optional env (only if using Gemini API or OAuth):

    cp .env.example .env
    # Add GEMINI_API_KEY and any OAuth/Lichess credentials if needed
  4. Dev server:

    npm run dev

    โ†’ http://localhost:3000

  5. Production build:

    npm run build
  6. Preview:

    npm run preview

๐Ÿงน npm run clean removes dist and server.js.


๐Ÿš€ Deployment

Automated via GitHub Actions + Cloudflare Pages. On push to main, the workflow:

  1. Installs dependencies.
  2. Runs npm run build.
  3. Deploys dist/ to Cloudflare Pages via Wrangler.

Requirements for your own deploy:

  • Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID secrets.
  • Have a Cloudflare Pages project named unochess (or change the name in the workflow).

๐ŸŒ Live demo: https://unochess.pages.dev/


๐Ÿ”ฎ Future Roadmap

  • ๐Ÿ† Ranked matches & leaderboards: Climb the ranks.
  • ๐Ÿƒ More cards & house rules: New actions, custom decks.
  • ๐Ÿ“ฑ Native mobile apps: iOS & Android.
  • ๐Ÿค Tournaments and community events.

๐Ÿš€ None of this is possible without you. Share the game, star the repo, and help make UnoChess famous!


๐Ÿ’Ž Project Philosophy

  • 100% free and ad-free. No monetization, no tracking.
  • Open source. Learn, modify, improve.
  • Accessible to everyone. Multi-language, touch controls, responsive.
  • Strategic depth. Cards add randomness, but tactics still matter.

โค๏ธ Made with care by MeowDev1011 and the community.


๐Ÿค Contributing

  1. Open an issue with your idea.
  2. Fork the repo.
  3. Create a branch (git checkout -b feature/new-card).
  4. Submit a pull request.

Please follow the existing code style and ensure npm run lint passes.

๐Ÿงช Tip: Test locally before submitting a PR.


๐Ÿ“„ License

MIT License. See the LICENSE file for details.


๐Ÿ”— Useful Links


๐ŸŒŸ Thanks for checking out UnoChess!

If you like the project, give it a star โญ on GitHub and share it with your friends. Let the game begin! ๐ŸŽ‰

โ™Ÿ๏ธ + ๐Ÿƒ = โค๏ธ

About

A Chess game combined with UNO action cards, 100% free and ad-free

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages