Polar Games
Black FridayGame templates at Black Friday pricesEnds in See the deals

Puzzle · HTML5

Shoalmates

HTML5 Sorting Puzzle Game With 60 Levels

by Polar GamesVersion 1.0.0Updated Nov 10, 2026

  • Source code
  • Live demo
  • Documented
Live previewDocumentation
Perpetual licence$59 $50.15 -15%Buy now
ShoalmatesPlay the demo of this edition
A level in Coral Garden: two top bubbles to fill, the tray with 5 spots and the three helpers at the bottom.Title screen: the logo, the Bubble Fish Sort ribbon and Tap to start, which also turns on the sound.My Reef, the home screen: rescued fish swim around the decorations, with Play, Album, Journey and Daily below.Journey map in the Sunken Ship world: finished levels show their stars and the next ones are locked.Guided first level: a pointing hand and a caption show which fish to tap.Sunken Ship: more species to sort and three top bubbles at once.Ice Bay, the fifth world, with its own background.Shoal complete: three stars, pearls and a new friend for the album.Album: 12 sea creatures to find, each with its own name.Daily Shoal: a calendar with one level per day and a pearl reward.Settings: music, effects and voice volume, vibration, reduced motion and language.

Tap a fish. Three of a kind fill the bubble.

Shoalmates is a bubble sorting puzzle under the sea. The sea creatures are mixed up inside bubbles: the player taps one and it swims to the top bubble that shows its picture. Three of a kind fill that bubble, and filling every top bubble finishes the level. You get a finished game with menus, progress, music, sound effects and narration, plus the complete source code to reskin, translate and publish as your own.

Shoalmates, Bubble Fish Sort: bubbles with sea creatures of the same kind around a glowing trio of clownfish.

One rule, and a tray that keeps it tense

A creature with no top bubble yet waits in a tray with only 5 spots; when its bubble arrives, it leaves the tray by itself. If the tray fills up, the level is lost, with a second chance and an undo to recover. Each level gives up to three stars, and pearls to spend on helpers.

Match three of a kind: three pufferfish fill a bubble while clownfish swim to theirs.
Real gameplay in Coral Garden: top bubbles, the tray with 5 spots and the three helpers.

6 worlds, 60 levels and a daily level

Coral Garden, Kelp Forest, Sunken Ship, Glow Cave, Ice Bay and Deep Blue, ten levels each, on a journey map with stars. New pieces arrive along the way, such as kelp wraps, clam locks, free bubbles, the Golden Fish and pearl oysters, each one introduced by a one-sentence card. The Daily Shoal adds one level per day, made from the date.

6 worlds, 60 levels: Coral Garden, Kelp Forest, Sunken Ship, Glow Cave, Ice Bay and Deep Blue.

Three helpers

Scoop fills the fullest top bubble, Sweep clears the tray and Whirl stirs the water and groups the fish by kind.

3 helpers: Scoop, Sweep and Whirl.

An album and a reef to decorate

Finished levels bring new friends to an album of 12 sea creatures, each with a name and a card. The home screen is the player's own reef, where rescued fish swim around 6 decoration spots.

Collect 12 sea friends: the twelve creatures of the album and reef decorations.

A guided start, 14 languages and a voice

The first two levels are guided: a pointing hand and a caption show what to tap and what the tray is for. The interface comes in English, Portuguese, Spanish, French, German, Italian, Dutch, Polish, Turkish, Russian, Indonesian, Japanese, Korean and Chinese, with narration in English, Portuguese and Spanish. The settings have separate volumes for music, effects and voice, vibration and a reduced motion option.

14 languages: a pufferfish surrounded by greetings in the fourteen languages of the game.

Yours to customise

Plain HTML, CSS and JavaScript with no build step and no dependencies: upload the game folder to any static host and it runs. The full editable source comes with tests that play every level with a simulated player, a level generator, a local server script and an illustrated guide in 14 languages. No ads, no store, no ranking and no server.

Full source code included: 60 levels, 14 languages, voice in 3 languages, guided tutorial, daily challenge, no ads.

Screens from this edition

Captured from the edition sold here.

A level in Coral Garden: two top bubbles to fill, the tray with 5 spots and the three helpers at the bottom.
A level in Coral Garden: two top bubbles to fill, the tray with 5 spots and the three helpers at the bottom.
Title screen: the logo, the Bubble Fish Sort ribbon and Tap to start, which also turns on the sound.
Title screen: the logo, the Bubble Fish Sort ribbon and Tap to start, which also turns on the sound.
My Reef, the home screen: rescued fish swim around the decorations, with Play, Album, Journey and Daily below.
My Reef, the home screen: rescued fish swim around the decorations, with Play, Album, Journey and Daily below.
Journey map in the Sunken Ship world: finished levels show their stars and the next ones are locked.
Journey map in the Sunken Ship world: finished levels show their stars and the next ones are locked.
Guided first level: a pointing hand and a caption show which fish to tap.
Guided first level: a pointing hand and a caption show which fish to tap.
Sunken Ship: more species to sort and three top bubbles at once.
Sunken Ship: more species to sort and three top bubbles at once.
Ice Bay, the fifth world, with its own background.
Ice Bay, the fifth world, with its own background.
Shoal complete: three stars, pearls and a new friend for the album.
Shoal complete: three stars, pearls and a new friend for the album.
Album: 12 sea creatures to find, each with its own name.
Album: 12 sea creatures to find, each with its own name.
Daily Shoal: a calendar with one level per day and a pearl reward.
Daily Shoal: a calendar with one level per day and a pearl reward.
Settings: music, effects and voice volume, vibration, reduced motion and language.
Settings: music, effects and voice volume, vibration, reduced motion and language.

Included

  • Ready-to-upload HTML5 game (game/ folder) with 60 levels in 6 worlds and a daily level
  • Full editable source in plain HTML, CSS and JavaScript, with no build step and no dependencies
  • Tests that play every level with a simulated player, a level generator and a local server script
  • Album of 12 creatures, a reef with 6 decoration spots, three helpers and a guided tutorial
  • 14 interface languages, narration in English, Portuguese and Spanish, music and sound effects
  • Offline illustrated guide in 14 languages with installation, customisation, cache and FAQ
  • Third-party licence notices

Not included in this edition

  • Online multiplayer or rankings
  • Advertising SDKs, store, payments, analytics or accounts
  • Native apps, hosting or hosted services

What is in the ZIP

The real folder structure of the package you download, with names and sizes read from it.

DocumentationLive preview
shoalmates-1.0.0-complete.zip588 files · 32.7 MB
  • shoalmates-static-1.0.0/587 files · 32.7 MB
    • documentation/HTML guide, open it before you buy1 file · 1.8 MB
      • index.html1.8 MB
    • game/Ready to host: upload this folder286 files · 15.4 MB
      • assets/Art, audio and fontsMP3 · TXT · WEBP · WOFF2 · 259 files · 15 MB
      • src/Source modulesJS · 21 files · 238 KB
      • DOCUMENTATION.txt1 KB
      • favicon.ico15 KB
      • index.html7 KB
      • style-1-base.css48 KB
      • style-2-glass-panels.css51 KB
      • style-3-polish.css46 KB
    • source/Readable source code295 files · 15.5 MB
      • assets/Art, audio and fontsMP3 · TXT · WEBP · WOFF2 · 259 files · 15 MB
      • src/Source modulesJS · 21 files · 238 KB
      • test/Automated testsMJS · 3 files · 10 KB
      • tools/Build and check scriptsMJS · 3 files · 8 KB
      • favicon.ico15 KB
      • index.html7 KB
      • LEVELS.md5 KB
      • package-lock.json1 KB
      • package.json1 KB
      • README.md5 KB
      • style-1-base.css48 KB
      • style-2-glass-panels.css51 KB
      • style-3-polish.css46 KB
    • THIRD-PARTY-LICENSES/Licence notices to keep with your game2 files · 5 KB
      • fredoka-OFL.txt4 KB
      • README.txt1 KB
    • CHANGELOG.txtVersion history1 KB
    • DOCUMENTATION.htmlOpens the guide1 KB
    • START-HERE.txtQuick start1 KB
  • POLAR-MARKETPLACE-START-HERE.txtStart here: licence, support and first steps1 KB

Item details

Edition
Complete Browser Edition
Version
1.0.0
Released
Nov 10, 2026
Updated
Nov 10, 2026
Category
Puzzle
Languages
English, Brazilian Portuguese, Spanish, French, German, Italian, Dutch, Polish, Turkish, Russian, Indonesian, Japanese, Korean, Simplified Chinese
Files included
HTML, CSS, JavaScript
Built with
Canvas 2D, Web Audio, ES modules
Browsers
Modern browsers with WebGL2
Documentation
Documentation

Author

Polar Games

Brazilian studio making browser games. Every template here is a game we built and published.

See our games

Requirements

  • A modern browser with JavaScript and ES modules
  • Any HTTP(S) web host that serves static files
  • No PHP, database, account or Node.js server to play
  • Node.js 26.13 or newer only for the optional tools: tests, build, local server and level generator

Support covers technical questions and reproducible defects in the supplied game. Installation and customisation are separate services.

Changelog

  1. 1.0.0Nov 10, 2026

Questions

Do I need a server or database?

No. Upload the contents of the game/ folder to any static HTTP(S) host. Progress is saved in the player's browser.

Can I replace the art and the sounds?

Yes. Replace the files in assets/ keeping the same names. Music, effects and narration can also be removed: the game stays silent where a file is missing. The guide explains it step by step.

Can I change the levels?

Yes. One function sets the fish, species, bubbles and blockers of each level. After a change, one command writes new level seeds and the tests check that every level can still be won.

Can I edit the texts and translations?

Yes. The texts of the 14 languages live in two files, and the tests check that every language has the same keys.

Does it work on phones?

The game is a portrait column made for touch that also runs on wide screens with a mouse. A tap-to-start screen turns on the sound, as mobile browsers require.

Read the full licence, support, refund and privacy terms

Before you buy: guides and reviews

From Brazil to the world

Buyers in 25 countries

License a ready HTML5 game, with source code, for your website, app or brand.

  • 900+sales
  • 25countries
  • 2016selling since
Browse the storeFor business
Countries where we have sold: Brazil, United States, United Kingdom, Germany, Canada, Australia, France, India, Netherlands, Spain, Italy, Japan, South Korea, Poland, Mexico, Sweden, Switzerland, Singapore, United Arab Emirates, Saudi Arabia, Indonesia, Türkiye, Portugal, Philippines, Vietnam.

More from Polar Games

Shoalmates$59 $50.15 -15%
Buy now