Installation
Set up the monorepo on a fresh machine.
Prerequisites
| Tool | Version | Why |
|---|---|---|
| Node.js | 26.x | Workspace constraint (engines.node: ^26.0.0) |
| pnpm | 12.18.0 | Workspace manager — pinned via packageManager field |
| Docker | latest | Local Postgres for Strapi (+ optional imgproxy) |
| Git | any | clone + hooks |
| nvm | optional | switch Node versions |
Optional but recommended: install VSCode extensions from .vscode/extensions.json.
Clone
git clone https://github.com/notum-cz/strapi-next-monorepo-starter
cd strapi-next-monorepo-starter
git checkout main
If you cloned this starter to build a new project, change origin before further development so pushes go to your project repository instead of the starter:
git remote set-url origin <your-repository-url>
git remote -v
Keep the original remote only when you intentionally work on the upstream starter.
Install dependencies
nvm use
npm install -g pnpm@12.18.0
pnpm install
Node.js 25 and later no longer bundle Corepack. Install pnpm once for each Node.js version you switch to with nvm. Without it, pnpm is missing or resolves to a copy installed under another Node.js version. Use the version in the root package.json packageManager field.
pnpm install triggers postinstall which:
- runs
setup:apps— copies every*.examplefile to its non-.examplesibling (creates.env,.env.localfrom templates) - runs
prepare— installs Lefthook git hooks
Environment files
After install, you'll have:
apps/strapi/.env— Strapi backendapps/ui/.env.local— Next.js UI
Both start from .env.example templates. Most values work out of the box; you'll need to fill at minimum a Strapi API token before the UI can fetch content — covered in Quick Start.