mirror of https://github.com/tiennm99/sokoban.git synced 2026-06-05 12:14:05 +00:00

T

tiennm99 68a808ec7e chore: drop orphan Phaser-era assets

bg.png (295 KB) and logo.png (24 KB) had zero references in src,
index.html, or any CSS, but matched the workbox precache glob and
shipped to every install. Removing them drops the precache from
555 KB to 235 KB (-58%). Update the docs note.

Also add the review-fixes plan to plans/.

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

.github/workflows

refactor: use default format from vite web bundler

2025-04-27 11:46:30 +07:00

docs

chore: drop orphan Phaser-era assets

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

plans

chore: drop orphan Phaser-era assets

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

public

chore: drop orphan Phaser-era assets

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

src

refactor: dedup dialog CSS and tighten focus management

2026-04-27 21:03:22 +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-lock.json

chore(deps): pin serialize-javascript via npm overrides

2026-04-27 21:03:25 +07:00

package.json

chore(deps): pin serialize-javascript via npm overrides

2026-04-27 21:03:25 +07:00

README.md

docs: housekeeping after whole-project review

2026-04-27 20:51:40 +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

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.