Running locally

Run commands from frameworks/docusaurus. Bun 1.3.14 or newer is required; the repository mise.toml supplies the pinned version. Bun is both the package manager and the runtime for the Docusaurus CLI and project scripts.

Install

bun install

Development

Only one Docusaurus locale is served per development process:

bun run start       # English
bun run start:ja    # Japanese

Open the base-aware URL printed by Docusaurus. English uses /docfw-cmp/docusaurus/en/; Japanese uses /docfw-cmp/docusaurus/ja/.

Production build

bun run build

The wrapper builds each locale independently into build/en/ and build/ja/, then writes build/index.html as a browser-language selector. This layout is intentional: Docusaurus normally omits the default locale segment, while the comparison contract requires both segments explicitly.

Serve build/ below /docfw-cmp/docusaurus/ when testing links. A server at the filesystem root will not emulate the configured GitHub Pages base path.