Tenguin · Buyer Guide

1 Overview and package contents

Tenguin Number Match is a standalone HTML5 puzzle game. Players tap pairs of equal numbers, or numbers that add up to ten, to clear the board. Progress moves across an island map, with daily challenges, missions, Relax mode and outfits for the penguin.

This edition has no ads, no accounts, no payments and no online ranking. Records are kept on the device that plays.

This manual describes version 1.0.0. Open documentation/index.html by double-clicking it. This guide works without internet and without a server.

2 Quick installation by FTP

Installing takes a few minutes if you have FTP access or a file manager in your hosting panel.

1. Extract tenguin-static-1.0.0.zip on your computer.
2. Connect to your hosting by FTP or its file manager, and open the folder where the game should live, for example public_html/puzzles/tenguin/.
3. Upload only the contents of the game/ folder, so that index.html sits directly inside the target folder.
4. Keep assets/, voice/, licenses/ and tenguin.config.js beside index.html. Keep names and letter case exactly as extracted.
5. Open https://your-domain.example/puzzles/tenguin/ in a modern browser.

public_html/puzzles/tenguin/
├── index.html
├── tenguin.config.js
├── assets/
├── voice/
└── licenses/

3 Requirements and subfolder hosting

• A current version of Chrome, Edge, Firefox or Safari on a computer, tablet or phone.
• Any static hosting over HTTP or HTTPS. HTTPS is recommended for audio and browser features.
• Any subfolder of any domain. The game uses relative paths, so the same files work wherever you upload them.
• Nothing else on the server: no database, PHP or Node.js service is needed to play.

The game must be opened through a web address. Opening its index.html directly from your computer (file://) is not supported. This guide is the exception: it opens by double-clicking, with no internet connection.

4 Controls and how the game works

Tap or click a number, then tap another one. The pair clears when the numbers are equal or add up to ten. Pairs follow the board's connection rules: they can be above or below each other, diagonal, separated by empty spaces, or joined across the end of a row.

• Pairs: equal numbers, or numbers that add up to ten.
• Avalanche: clearing a whole row makes it slide away.
• Snowfall: copies every number left on the board to the bottom, for when you run out of pairs.
• Stars: each level awards up to three stars. Snowfalls you save earn more stars.

Boosters

Prices are the defaults set in tenguin.config.js (see Customizing). The emergency Snowfall described in the problems section is always free.

Progress and rewards

• Win a level: 80 coins for one star, 100 for two and 120 for three (defaults).
• Replay: a level you have already completed pays half the normal reward.
• Relax mode: no stars and no rush. Each board you clear pays 30 coins by default.

5 Screens and controls explained

The captures below come from the 1.0.0 build in English. Numbered marks point to the controls. The legend under each capture explains them.

1 2 3 4 5 6 7 8

Marks on the screenshot

1. 1 Coin balance and the daily missions counter.
2. 2 Settings: sound, accessibility, language, how to play, stats and deleting progress.
3. 3 Play: continues the next unfinished level on the island map.
4. 4 Daily challenge for today's date.
5. 5 Relax mode: no stars, no rush, unlimited Snowfall.
6. 6 Gift: rewards you can claim. A red mark means one is ready.
7. 7 Customize: scarves, hats, colours and effects, bought with coins.
8. 8 Records: your personal results on this device.

1 2 3 4 5 6

Marks on the screenshot

1. 1 Back to the home screen.
2. 2 Coins and total stars collected.
3. 3 Island name, and the stars collected on this island out of the total.
4. 4 Level stops along the island. The penguin marks your current level.
5. 5 Message that shows what you need to reach the next part of the map.
6. 6 Play the selected level.

1 2 3 4 5 6 7 8 9 10 11 12

Marks on the screenshot

1. 1 Pause the game.
2. 2 Current level and the stars for this level.
3. 3 Score for the current level.
4. 4 Streak meter: consecutive clears raise the multiplier shown at the right (×1 here).
5. 5 Coin balance.
6. 6 Number tiles. Tap two that are equal, or that add up to ten.
7. 7 Empty places left by cleared pairs. Pairs can connect across them.
8. 8 Hint: shows a possible pair. The number is how many you have left.
9. 9 Undo: takes back your last move. Unlocks at level 3.
10. 10 Snowfall: copies the remaining numbers to the bottom. The number is your supply, and ∞ means unlimited.
11. 11 Peck: removes a tile you choose. Unlocks at level 8.
12. 12 Wild: turns a tile into a wild flake. Unlocks at level 12.

1 2 3 4 5

Marks on the screenshot

1. 1 Your coin balance.
2. 2 Categories: Scarves, Hats, Colors and Effects.
3. 3 Item card: its name, its price, or whether you own it or have it equipped.
4. 4 Preview of the penguin with the selected look.
5. 5 Equip the selected item when you own it.

1 2 3 4 5 6

Marks on the screenshot

1. 1 Stars earned on this level.
2. 2 New outfit, when the level unlocks one.
3. 3 Coins earned for this completion.
4. 4 Score for the level. A New best label appears when you beat your record.
5. 5 Next level.
6. 6 Home screen.

1 2 3 4 5 6 7 8 9 10 11

Marks on the screenshot

1. 1 Sound effects on or off.
2. 2 Background music on or off.
3. 3 Vibration, on phones that support it.
4. 4 Calm mode: fewer visual effects and gentler mascot motion.
5. 5 Big tiles: larger tiles for easier tapping.
6. 6 High contrast: stronger contrast for tiles and text.
7. 7 Classic colours: the original colour set.
8. 8 Interface language: 14 choices.
9. 9 How to play: shows the tutorial again.
10. 10 Stats: totals kept on this device.
11. 11 Delete progress: erases everything saved on this device. This cannot be undone.

1 2 3 4

Marks on the screenshot

1. 1 Relax mode: no stars, no rush.
2. 2 The board. Clear it at your own pace.
3. 3 Snowfall is unlimited here (∞).
4. 4 Hint price in coins (35 by default).

6 Map of the files

This table shows what the ZIP contains and what you upload. Upload the contents of game/ to your host, and keep the other items on your computer.

7 Settings available

Open the gear icon on the home screen. Settings are saved on this device.

• Sound effects, Music and Vibration: audio and tactile feedback. Audio starts after your first tap.
• Calm mode: reduces particle effects to about 30% and calms the mascot's animations.
• Big tiles and High contrast: easier tapping and reading.
• Classic colours: returns to the original colour set.
• Language: the 14 interface languages. Your choice is saved on this device.
• How to play, Stats and Delete progress: the tutorial, your totals, and erasing the local save.

8 Customizing texts, images and content

Most settings are in tenguin.config.js, next to index.html. Open it with any text editor, change a value, save it, upload the file and reload the game. No build is needed.

window.TENGUIN_CONFIG = {
  title: "Tenguin — Number Match Puzzle",
  defaultLanguage: "auto",
  saveKey: "tenguin.template.save.v1",
  logo: "",
  accent: "#ffb632",
  startingCoins: 400,
  winCoins: 80,
  starCoins: 20,
  relaxCoins: 30,
  rescueSnowfalls: 1,
  hintPrice: 35,
  cosmeticPricePercent: 100,
};

To change the logo, put your image in the folder, write its relative path in logo, and reload. Changes to level layouts, dialogue, artwork inside the game or new voice clips need the optional source edition (see Development).

9 Languages and audio

The game interface is available in 14 languages: English, Português (Brasil), Español, Français, Deutsch, Italiano, Nederlands, Polski, Türkçe, Русский, Bahasa Indonesia, 日本語, 한국어 and 简体中文. The game follows the browser language when it can. Players can choose another language in Settings.

Recorded voices exist in English, Português (Brasil) and Español, with 58 clips each. Other languages show translated speech bubbles without narration.

Browsers allow sound only after a first tap or click. If sound stops when you switch apps, return to the game and tap once more. Sound and music can be turned off in Settings.

10 Saves and taking care of progress

Progress, the current attempt, coins, outfits, records, settings and claimed rewards are stored in this browser's local storage, under the save key in tenguin.config.js (default tenguin.template.save.v1). The standalone edition uses its own key, separate from the Polar Games website.

• Saves belong to one browser on one device. They do not synchronise between devices or browsers.
• Private browsing or blocked storage may prevent saving. The game keeps running for the current session.
• Clearing site data for the game's address deletes the save. Clearing cached images and files does not (see Updating and clearing the cache).
• Delete progress in Settings removes everything on this device. The game has no cloud backup.

11 Optional development

This section is only for changing the code. The game/ folder already contains the built game, so installing it needs no Node.js.

To rebuild, install Node.js 22.13 or newer (tested with 22.23) and use npm.

cd source
npm ci
npm test
npm run build

The build output is source/dist-static/. Upload its contents to replace the hosted game, and keep your edited tenguin.config.js.

• npm run dev starts a development server.
• npm run preview serves the built copy locally, and npm run typecheck checks the TypeScript code.
• npm test runs 49 automated tests. The delivered scripts are readable and not obfuscated.

12 Updating the game

1. Back up your current game/ folder and your edited tenguin.config.js.
2. Upload the new contents of game/ over the old files, keeping the same names.
3. Keep tenguin.config.js and its saveKey unless the update notes say otherwise.
4. Reload the game. If the old version still appears, clear the cache as described below.

Clearing the cache without losing progress

Progress is stored in this browser, not on the server. Clearing cached images and files, or doing a hard reload, keeps your progress.

Computer: press Ctrl+F5 on Windows and Linux, or Cmd+Shift+R on macOS. Phone: in the browser settings, choose the option to clear cached images and files.

Do not choose cookies and site data, or clear site data, for the game's address. That deletes the local save.

13 Dependencies and licenses

• Fonts: Nunito, Fredoka and Baloo 2, from @fontsource, under the SIL Open Font License.
• Source edition only: Vite (MIT license) and TypeScript (Apache License 2.0).
• Full notices: the licenses/ folder inside game/, and THIRD-PARTY-LICENSES/ in the ZIP.

The game makes no analytics, ranking, payment or advertising calls. It contains no ad SDK and no billing code.

The original artwork and audio supplied with this item remain under the license terms of the purchased item.

14 Common problems

• Blank page: make sure you uploaded the contents of game/ (not source/, and not the folder itself), and that you opened the web address rather than a file on your computer.
• Missing images or sounds: check the complete upload, the spelling and letter case of file names, and any 404 errors in the browser's console.
• The files download or do not run: your host must serve .js, .webp, .woff2 and .mp3 files with normal types. Ask the host to check its MIME rules.
• No sound at first: tap the game once, turn on Sound effects and Music in Settings, and check the device's mute switch and volume.
• Changes do not appear: reload the game after uploading the config or images. Follow the cache section if the old version remains.
• Stuck with no pairs and no Snowfall: you are offered one free emergency Snowfall per attempt. You can also restart the level for free, replay earlier levels or play Relax mode.

15 Frequently asked questions

16 Support and version history

Support and customization: willian@polargames.com.br. Include your purchase reference when you have it. This guide does not promise response times or a schedule of future updates.

Support request

When you write to support, include the browser and device, the game version, the page address, the steps that caused the problem, a screenshot and the first error shown in the browser console. Never send passwords, payment details or secret keys.