Pixels Go!

Pixels Go! is a retro 8-bit browser puzzle game for clearing shaped boards of directional tiles.

Run The Game

Build the browser game:

npm run build

Open:

itch-upload/index.html

This is the same shape itch.io needs: the upload folder has index.html at its top level. The build inlines the game code into itch-upload/index.html, so double-clicking that file works without running a local server.

Live Editing

Install dependencies:

npm install

Start the local development server:

npm run dev

Open the game at:

http://127.0.0.1:5173/

The live-editing server is only for faster development while changing code. The game itself does not require a custom server.

Tests

Run the automated test suite:

npm test

Build the static browser export:

npm run build

Itch.io Export

Build the game with:

npm run build

Upload the contents of itch-upload/ to itch.io as an HTML browser game.

On itch.io, the game starts from the base index.html in that uploaded folder. Do not upload the whole project folder; upload the generated itch-upload/ contents.

Audio Assets

Audio files are optional during development. Missing MP3s fail silently so the game can be tested without sound assets.

Current supported optional asset paths under public/audio/:

music/menu-once.mp3
music/game-loop-01.mp3
music/game-loop-02.mp3
music/game-loop-03.mp3
music/game-loop-04.mp3
music/chain-attack-loop.mp3

sfx/tile-slide-01.mp3
sfx/tile-slide-02.mp3
sfx/heart-break.mp3
sfx/lucky-reveal.mp3
sfx/shove-slide.mp3
sfx/powerup-collect.mp3
sfx/powerup-heart.mp3
sfx/charged-tile-appear.mp3
sfx/streak-fill.mp3
sfx/streak-complete.mp3
sfx/ui-tap.mp3
sfx/level-win.mp3
sfx/level-lose.mp3

hint and chainAttack currently reuse sfx/powerup-collect.mp3.