Prerequisites

Before creating your first experiment, make sure your environment meets the following requirements.

Node version

Node 20 is the minimum. Node 24 is recommended.

The generated project's .nvmrc is set to 24. Running an older Node version will cause compatibility issues with pnpm 10.

Install and manage Node versions with nvm:

nvm install 24
nvm use 24
node --version   # v24.x.x

Every generated project ships with a .nvmrc file. Running nvm use inside the project root will switch to the correct version automatically.

Windows users

Use nvm-windows instead of nvm.

Node 16 is incompatible

The system default Node on some machines is 16. pnpm 10.30.1 requires Node 18 at minimum. Always run nvm use 24 before any pnpm or node commands.

pnpm

Exact version required

The generated project's packageManager field is set to pnpm@10.30.1. Using a different version will produce lockfile format mismatches.

Install via Corepack (recommended):

corepack enable
corepack prepare pnpm@10.30.1 --activate
pnpm --version   # 10.30.1

Install via npm (alternative):

npm install -g pnpm@10.30.1
pnpm --version   # 10.30.1

Why exact? The pnpm lockfile format changes between minor versions. Projects checked in with a pnpm-lock.yaml from 10.30.1 will fail --frozen-lockfile installs on any other version.

Playwright

Playwright is only needed if you enable E2E testing during scaffolding (the CLI prompts you).

If you answered Yes to E2E at scaffold time, the CLI installs browsers automatically after generating your project. You do not need to do anything extra.

To install browsers manually (e.g. after cloning an existing E2E-enabled project):

cd my-experiment
pnpm playwright install

This downloads Chromium, Firefox, and WebKit to ~/.cache/ms-playwright. Plan for approximately 300 MB of disk space.

Default browser

The generated playwright.config.js uses Desktop Chrome only. You do not need all three browsers for smoke testing.

Verification

Run these commands to confirm your environment is ready:

node --version   # v20.x.x or v24.x.x
pnpm --version   # 10.30.1

Once both pass, continue to Installation.