Boba Club Solitaire: your club, your cards.
Boba Club Solitaire is a cozy HTML5 Klondike solitaire template with full source code. Players stack cards in a café full of plants and bubble tea, hosted by Mochi, a cat in a mint hoodie. Cards move with a tap or a drag, land with soft animation and gentle sound, and the game runs on phone, tablet and desktop from any static web hosting.
Classic Klondike, three ways to play
Quick games use Draw 1 or Draw 3 with unlimited passes through the stock. The campaign has 12 deals in three chapters, from the Boba Café to City Lights, and every first win earns a sticker. The daily challenge picks one deal per day from a bank of 120. Every campaign and daily deal was solved by the included solver, and the tests replay each solution in the game's own rules.
Players never stay stuck
Hints show the next useful move, undo takes any move back and the game finishes automatically once every card is visible. If a game reaches a dead end, Mochi notices it and offers to go back to the last position that can still be won.
Learn with Mochi
A guided tutorial teaches the rules on a prepared deal, one move at a time. It is narrated in English, Brazilian Portuguese and Spanish; players in the other languages hear the English voice while the speech bubbles show their own language.
Collect and personalise
Wins unlock 12 stickers, 6 card backs and 3 table scenes, and the statistics keep games, wins, streaks, best time and fewest moves for Draw 1 and Draw 3.
Your game, your hosting
Upload the contents of the game folder to static HTTP(S) hosting. No PHP, database, account or Node.js is needed on the server, and the game makes no requests to ranking, advertising, tracking or payment services. Artwork, audio and fonts are all local. The interface comes in 14 languages and follows the player's browser language.
What this edition does not include
Native apps, hosting and custom development are not included, nor are cloud saves, an online ranking, real-money purchases or an advertising SDK.
Who this template is for
Site and portal owners who want a calm card game for every age, freelancers and studios building a branded solitaire for a client, and developers who want to learn from readable TypeScript with a solver and unit tests.
Customise it
The settings file boba.config.js sets the browser title, the saved-progress name and the starting language with no rebuild. The source is readable, unminified TypeScript with 152 unit tests and a deal-bank generator; rebuild with npm ci, npm test and npm run build after editing it.
Technical details at a glance
- Stack: HTML5, JavaScript and TypeScript with Phaser 4.2 (MIT, included unminified), built with Vite.
- Files: HTML, CSS, JavaScript, TypeScript, JSON, WebP, PNG, MP3 and WOFF2.
- Languages: 14 interface languages, a narrated tutorial in three, and a guide in 14.
- Requirements: a current browser with JavaScript and audio, and static HTTP(S) hosting.
- Saves: the browser's local storage, with no account or cloud sync.
- Node.js 22.12 or newer is needed only to rebuild the source.
Licence and support in short
One purchase gives you a perpetual, non-exclusive licence to use this edition in one end product, yours or one client's. Players can access it free of charge or through advertising monetisation. You can change the code, art and audio inside your product, but you cannot resell or redistribute the template on its own. Six months of support are included (12 with the extension at checkout) and cover installing and using the files and fixing reproducible defects.
