Upgrade to Nextra v4

[feynon]

Summary

• upgrade Nextra and the docs theme to v4 and switch to the new Next.js configuration format
• migrate documentation content into the app router with a root layout and updated edit links
• add MDX component hooks and adjust TypeScript settings for the new toolchain

Testing

• pnpm run build

---

Codex Task

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
tilekit-docs	Ready	Preview	Comment	Nov 28, 2025 7:44am

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Configure Nextra plugin with theme

The new ESM next.config.mjs calls nextra({}) and exports withNextra({}), leaving both theme and themeConfig undefined. Nextra’s plugin throws Error: No Nextra theme found! when these options are missing (node_modules/nextra/dist/index.js), so next dev or next build will fail before the site can start. Please pass the docs theme and config (as the previous next.config.js did) to keep the app bootable.

Useful? React with 👍 / 👎.