Prerequisites

The repository uses a project-managed toolchain so that developers do not need to manually coordinate Node.js and pnpm versions.

Required software

Install the following system-level tools before cloning the repository:

Node.js and pnpm should not be installed manually specifically for this repository.

mise installs the project-required versions from mise.toml.

The current project baseline is:

Node.js 24.19.0 LTS
pnpm 11.21.0
mise >= 2026.8.5

The exact versions are controlled by the repository.

The target development environments are:

Linux x64 glibc
Linux ARM64 glibc
Linux x64 musl
Linux ARM64 musl
macOS ARM64
Windows x64
Windows ARM64

See the Cross-Platform Support documentation for details.

git --version

mise --version

Do not use a different Node.js or pnpm version simply because it is already installed globally.

After entering the repository, use:

mise install --locked

Then verify:

node --version
pnpm --version

The expected versions are:

v24.19.0
11.21.0

The UI package uses Playwright Chromium for Storybook browser tests.

The required browser can be installed through the UI workspace when needed.

pnpm --filter @repo/ui exec playwright install chromium

Some Linux environments may require the operating-system dependencies installed by Playwright.

Lefthook is installed as a repository development dependency.

After dependencies are installed, Git hooks enforce repository quality gates automatically.