Sokoban

My from-scratch Sokoban game, built with Svelte 5 and Vite. The engine, UI, level parser, and progression system are all my own implementation. The puzzle layouts themselves come from David W. Skinner's freely distributable Microban set — I'm not reusing any of his code, only his level designs.

Play: https://tiennm99.github.io/sokoban/

Features

• All 155 puzzles from the Microban set, from beginner teasers up to the giant "Take the long way home" maze and "The Dungeon" finale.
• Paginated level select with progress tracking and best-move record per level.
• Controls: arrow keys or WASD. U / Z to undo, R to restart, Esc for menu.
• Undo history, live move counter, animated moves.
• Progress saved locally in localStorage.
• Responsive tile sizing so small and large levels both look right.

Development

npm install
npm run dev          # dev server on http://localhost:8080
npm run build        # production build

Project layout

See docs/codebase-summary.md.

Documentation

• docs/project-overview-pdr.md — product scope.
• docs/system-architecture.md — how the pieces fit together.
• docs/code-standards.md — conventions.
• docs/development-roadmap.md — past and planned phases.
• docs/project-changelog.md — release notes.

Credits

• Puzzle layouts: Microban level set by David W. Skinner (April 2000). Freely distributable with credit. Original site: http://users.bentonrea.com/~sasquatch/sokoban/
• Game code: tiennm99 (with AI pair-programming from Claude).
• Framework: Svelte 5 on top of Vite.

License

• Source code: see LICENSE.
• Puzzle layouts (Microban): see LICENSE-LEVELS.md — Skinner's free-distribution-with-credit terms, not the main project license.