mirror of https://github.com/tiennm99/sokoban.git synced 2026-05-23 08:25:45 +00:00

T

dependabot[bot] ce7ea8a159 build(deps): bump actions/setup-node from 4 to 6

Bumps [actions/setup-node](https://github.com/actions/setup-node) from 4 to 6.
- [Release notes](https://github.com/actions/setup-node/releases)
- [Commits](https://github.com/actions/setup-node/compare/v4...v6)

---
updated-dependencies:
- dependency-name: actions/setup-node
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>

2026-05-23 03:49:43 +00:00

.github

build(deps): bump actions/setup-node from 4 to 6

2026-05-23 03:49:43 +00:00

docs

docs: log mobile mistouch fix and add plan artifacts

2026-04-28 11:10:05 +07:00

plans

docs(plans): log portrait/landscape layout brainstorm

2026-04-29 00:05:01 +07:00

public

chore: drop orphan Phaser-era assets

2026-04-27 21:15:46 +07:00

src

fix(levels): keep paginator clear of the fixed site footer

2026-04-29 00:18:07 +07:00

vite

fix: address review-pass findings

2026-04-27 20:51:37 +07:00

.env.example

feat: add code-server dev profile

2026-04-20 16:01:04 +07:00

.gitignore

feat: init

2025-04-26 23:07:35 +07:00

index.html

feat(mobile): comfort overhaul - D-pad, gesture blocking, haptics

2026-04-27 20:37:27 +07:00

LICENSE

Initial commit

2025-04-26 22:44:57 +07:00

LICENSE-LEVELS.md

docs: add LICENSE-LEVELS for Microban layout attribution

2026-04-11 23:41:02 +07:00

package.json

chore: migrate from npm to pnpm

2026-05-13 10:19:34 +07:00

pnpm-lock.yaml

chore: migrate from npm to pnpm

2026-05-13 10:19:34 +07:00

pnpm-workspace.yaml

chore: migrate from npm to pnpm

2026-05-13 10:19:34 +07:00

README.md

chore: migrate from npm to pnpm

2026-05-13 10:19:34 +07:00

README.md

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 on desktop; on-screen D-pad on mobile (bottom-right, one-handed). U / Z to undo, R to restart, Esc for menu.
Mobile-optimized: Touch-safe controls, haptic feedback (vibrate on push & win), safe-area insets for notches/nav bars, browser gesture blocking.
Installable PWA: Add to home screen on iOS/Android, play offline, standalone fullscreen mode.
Undo history, live move counter, animated moves.
Progress saved locally in localStorage (per browser, per device).
Responsive tile sizing so small and large levels both look right on any screen.

Development

pnpm install
pnpm dev          # dev server on http://localhost:8080
pnpm 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.