hengband-web

Play Hengband in the browser via WebAssembly.

Game progress is persisted across sessions using IndexedDB. Both Japanese and English builds are supported.

Requirements

• Docker - required to build the WebAssembly binaries
• pnpm - JavaScript package manager

Build

pnpm install
pnpm build:wasm && pnpm build

Output lands in dist/.

Local Development

Install dependencies once:

pnpm install

Start the dev server (WASM binaries must already be in public/ to play):

pnpm serve

Other commands:

Command	Description
pnpm build	Production build → dist/
pnpm serve	Dev server at localhost:5173
pnpm lint	Check code with Oxlint and Oxfmt
pnpm lintfix	Auto-fix lint/format issues
pnpm typecheck	Generate CSS Module types and check TypeScript
pnpm test	Run unit tests (Vitest)
pnpm test:e2e	Build and run browser tests against Vite preview