
Candymates is a cheerful HTML5 sorting puzzle game set in a toy candy shop. Little sweet treats are mixed up inside bubbles: the player taps one and it flies to the top bubble that shows its picture. Three of a kind fill that bubble, and filling every top bubble finishes the level. It is a finished game with menus, progress, music, sound effects and narration, plus the complete source code so you can reskin it, translate it and publish it as your own.

A treat 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 candies to spend on helpers.

Cupcake Bakery, Lollipop Meadow, Chocolate River, Candy Night, Ice Cream Peaks and Cocoa Depths, ten levels each, on a journey map with stars. New pieces arrive along the way, such as whipped cream wraps, locked cookie tins, free bubbles, the Golden Bonbon and candy tins, each one introduced by a one-sentence card. The Daily Treat adds one level per day, made from the date.

Scoop fills the fullest top bubble, Whisk clears the tray and Swirl groups the treats by kind.

Finished levels bring new friends to an album of 12 sweet treats, each with a name and a card. The home screen is the player’s own candy shop, where the collected treats float in bubbles around 6 decoration spots.

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 language is detected from the device and can be changed in the settings without reloading the game. The settings also have separate volumes for music, effects and voice, vibration and a reduced motion option.

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 in source/ is readable (the code comments are in Portuguese), with tests that play every level with a simulated player, a level generator and a local server script. Levels, art, sounds, music, voice, texts and colours live in separate files. No ad network, no store, no ranking, no tracking and no external services are included.
Play the live demo on a phone, tablet or computer.
An illustrated step-by-step guide in 14 languages (hosting, changing art, sounds, music, voice and texts, adding languages and levels, clearing the browser cache), a separate customization guide for people who do not program (recipes with numbered screenshots of the real game), the ready-to-upload game/ folder, the editable source/ folder, third-party licences and a changelog. The file tree is shown below.
candymates-static-1.0.0/ (4 files, 3 KB) candymates-static-1.0.0/THIRD-PARTY-LICENSES/ (2 files, 5 KB) candymates-static-1.0.0/documentation/ (2 files, 596 KB) candymates-static-1.0.0/documentation/img/ (20 files, 3210 KB) candymates-static-1.0.0/game/ (6 files, 166 KB) candymates-static-1.0.0/game/assets/ (255 files, 11674 KB) candymates-static-1.0.0/game/src/ (21 files, 236 KB) candymates-static-1.0.0/source/ (9 files, 177 KB) candymates-static-1.0.0/source/assets/ (255 files, 11674 KB) candymates-static-1.0.0/source/src/ (21 files, 236 KB) candymates-static-1.0.0/source/test/ (3 files, 9 KB) candymates-static-1.0.0/source/tools/ (3 files, 8 KB)
Questions and custom work: willian@polargames.com.br.