installation

Install the doc-site-starter-kit from scratch or bootstrap it into an existing project. Choose your preferred package manager below.

System requirements

Tool	Minimum version	Recommended
Node.js	18.0.0	20 LTS or 22
pnpm	8.0.0	9.x
npm	9.0.0	10.x (alternative)
yarn	1.22	4.x (alternative)

Install with your package manager

All three major Node.js package managers are supported. We recommend pnpm for its superior speed and disk efficiency, especially in monorepo setups.

RECOMMENDED pnpm

pnpm install

npm

npm install

yarn

yarn install

Adding to an existing project

If you want to integrate the stack into an existing Vite project rather than cloning the starter kit, install the dependencies individually:

Runtime dependencies

pnpm add react react-dom vike vike-react

Dev dependencies

pnpm add -D @types/react @types/react-dom @vitejs/plugin-react typescript vite @tailwindcss/vite tailwindcss

Verify the installation

After installing, run the development server to confirm everything is working:

pnpm dev

You should see output similar to:

  VITE v6.x.x  ready in 312 ms

  ➜  Local:   http://localhost:3000/
  ➜  Network: use --host to expose
  ➜  press h + enter to show help

Troubleshooting

"Cannot find module 'vike/plugin'"

This usually means the vike package is not installed or your node_modules is corrupted.

rm -rf node_modules pnpm-lock.yaml && pnpm install

Tailwind styles not applying

Ensure the @tailwindcss/vite plugin is listed before @vitejs/plugin-react in your vite.config.ts plugins array. Also confirm your CSS entry file starts with @import "tailwindcss".

TypeScript errors on React 19 types

Make sure @types/react and @types/react-dom are both on version ^19.0.0. Run pnpm update @types/react @types/react-dom to upgrade.