0 Fork 0

mirror of https://github.com/tiennm99/sokoban.git synced 2026-10-11 03:13:52 +00:00

T

tiennm99 f1a60f973f fix(mobile): tighten board-to-dock spacing on touch devices

Short puzzles (e.g. Microban 1) showed ~300px of invisible dead space
between the board and the on-screen D-pad because <Board> is fixed-pixel
and rendered top-left inside a flex-grown wrapper. Anchor .board-wrap
contents to flex-end on coarse pointers so the gap collapses against
the dock instead of below the board. Also drop the redundant 24px #app
bottom padding (the dock already pads safe-area-inset-bottom) and
tighten the .game flex gap from 16px to 10px on coarse pointers.

All changes gated behind @media (pointer: coarse). Desktop layout is
untouched.

2026-04-28 22:33:06 +07:00

.github/workflows

refactor: use default format from vite web bundler

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

docs

docs: log mobile mistouch fix and add plan artifacts

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

plans

docs: log mobile mistouch fix and add plan artifacts

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

public

chore: drop orphan Phaser-era assets

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

src

fix(mobile): tighten board-to-dock spacing on touch devices

2026-04-28 22:33:06 +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.