Prerequisites

The tools a theme needs and how to check them with salla theme doctor.

Start here before your first salla theme create.

What you need

ToolVersionWhy
Node.js20.19 or newerRuns the dev server.
pnpm10 or newerThemes are pnpm-only. Other package managers install duplicate copies of shared libraries and the theme fails at render time.
gitanyThe CLI starts a git history for the new theme.
Salla CLI3.xCreates and runs the theme.

No Salla account, partner account or GitHub account is needed to create and run a theme.

Install the CLI

npm install -g @salla.sa/cli
salla --version

Check your machine

salla theme doctor

It checks Node, pnpm and git. When all is well it prints:

Toolchain: node 22.4.0 · pnpm 10.4.1 · git
Everything a Salla React theme needs is installed.

Otherwise it stops with the fix:

ProblemWhat the CLI tells you
Node too oldInstall a newer one, for example nvm install 20 && nvm use 20.
pnpm missingIt offers to run corepack enable pnpm. Say yes.
pnpm too oldcorepack prepare pnpm@latest --activate
git missingInstall it from git-scm.com.

create, dev and preview run the same check first, so you only need doctor to check without starting anything.

Next: Create a theme

On this page