Nextra is a Next.js plugin that renders your MDX files with custom themes.

The Nextra repository uses PNPM Workspaces and Lerna. To install dependencies, just simply run pnpm in the project root directory.

cd packages/nextra
pnpm build

Watch mode: yarn dev

cd packages/nextra-theme-docs
pnpm build

Watch mode: pnpm dev Watch mode (layout only): pnpm dev:layout Watch mode (style only): pnpm dev:tailwind

You can also debug them together with a website locally. For instance, to start examples/docs locally, run

cd examples/docs
pnpm dev

Any change to example/docs will be re-rendered instantly.

If you update the core or theme packages, a rebuild is required. Or you can use the watch mode for both nextra and the theme in separated terminals.