Installation

Set up the monorepo on a fresh machine.

Prerequisites

Tool	Version	Why
Node.js	24.x	Workspace constraint (engines.node: ^24.0.0)
pnpm	11.1.1	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

New project remote

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
pnpm install

pnpm install triggers postinstall which:

• runs setup:apps — copies every *.example file to its non-.example sibling (creates .env, .env.local from templates)
• runs prepare — installs Lefthook git hooks

Environment files

After install, you'll have:

• apps/strapi/.env — Strapi backend
• apps/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.