feat(docs): upgrade to nextra 4 (#301)

Author: mnahkies

integration-tests/typescript-fetch/src/generate-release-notes.ts

@@ -34,8 +34,9 @@ export async function generateReleaseNotes() {
 ${it.body
   ?.split("\n")
   .filter((it) => it.startsWith("#") === false)
+  .map((it) => it.trim())
   .join("\n")}
-    `,
+`,
     )
   }
 
@@ -46,7 +47,11 @@ ${it.body
 
 async function main() {
   const notes = await generateReleaseNotes()
-  const result = `import { Callout, Steps } from 'nextra/components'
+  const result = `---
+title: Release Notes
+---
+
+import { Callout, Steps } from 'nextra/components'
 
 # Release notes
 
@@ -63,7 +68,7 @@ ${notes.join("\n")}
   fs.writeFileSync(
     path.resolve(
       __dirname,
-      "../../../packages/documentation/src/pages/reference/release-notes.mdx",
+      "../../../packages/documentation/src/app/reference/release-notes/page.mdx",
     ),
     result.replace(/\r\n/g, "\n"),
     "utf-8",

packages/documentation/next.config.mjs

@@ -23,14 +23,8 @@ const nextConfig = {
 
     return config
   },
-  async redirects() {
-    return [{source: "/", destination: "/overview/about", permanent: false}]
-  },
 }
 
-const withNextra = nextra({
-  theme: "nextra-theme-docs",
-  themeConfig: "./src/theme.config.tsx",
-})
+const withNextra = nextra({})
 
 export default withNextra(nextConfig)

packages/documentation/package.json

@@ -32,8 +32,8 @@
     "monaco-editor": "^0.52.2",
     "monaco-editor-auto-typings": "^0.4.6",
     "next": "15.2.2",
-    "nextra": "^3.3.1",
-    "nextra-theme-docs": "^3.3.1",
+    "nextra": "^4.2.16",
+    "nextra-theme-docs": "^4.2.16",
     "node-polyfill-webpack-plugin": "^4.1.0",
     "react": "19.0.0",
     "react-dom": "19.0.0",

…ckages/documentation/src/pages/_meta.tsx packages/documentation/src/app/_meta.tsxpackages/documentation/src/pages/_meta.tsx renamed to packages/documentation/src/app/_meta.tsx packages/documentation/src/pages/_meta.tsx renamed to packages/documentation/src/app/_meta.tsx

@@ -3,10 +3,6 @@ export default {
   "getting-started": "Getting Started",
   guides: "Guides",
   reference: "Reference",
-  404: {
-    display: "hidden",
-    title: "",
-  },
   index: {
     display: "hidden",
     title: "",
@@ -19,6 +15,8 @@ export default {
   playground: {
     type: "page",
     theme: {
+      pagination: false,
+      toc: false,
       layout: "full",
     },
   },

…rc/pages/getting-started/quick-start.mdx …app/getting-started/quick-start/page.mdxpackages/documentation/src/pages/getting-started/quick-start.mdx renamed to packages/documentation/src/app/getting-started/quick-start/page.mdx packages/documentation/src/pages/getting-started/quick-start.mdx renamed to packages/documentation/src/app/getting-started/quick-start/page.mdx

@@ -1,3 +1,7 @@
+---
+title: Quick Start
+---
+
 import {Steps, Tabs} from "nextra/components"
 
 # Quick Start

…rted/tips-for-writing-specifications.mdx …tips-for-writing-specifications/page.mdxpackages/documentation/src/pages/getting-started/tips-for-writing-specifications.mdx renamed to packages/documentation/src/app/getting-started/tips-for-writing-specifications/page.mdx packages/documentation/src/pages/getting-started/tips-for-writing-specifications.mdx renamed to packages/documentation/src/app/getting-started/tips-for-writing-specifications/page.mdx

@@ -1,3 +1,7 @@
+---
+title: Tips for writing specifications
+---
+
 # Tips for writing a good specification
 
 Garbage in, garbage out applies especially to code generation tools. In short the more detailed, and accurate the

…documentation/src/pages/guides/_meta.tsx …s/documentation/src/app/guides/_meta.tsxpackages/documentation/src/pages/guides/_meta.tsx renamed to packages/documentation/src/app/guides/_meta.tsx packages/documentation/src/pages/guides/_meta.tsx renamed to packages/documentation/src/app/guides/_meta.tsx

@@ -1,3 +1,7 @@
+---
+title: typescript-angular
+---
+
 import {Callout, Tabs} from 'nextra/components'
 
 # Using the `typescript-angular` template

…/client-templates/typescript-angular.mdx …nt-templates/typescript-angular/page.mdxpackages/documentation/src/pages/guides/client-templates/typescript-angular.mdx renamed to packages/documentation/src/app/guides/client-templates/typescript-angular/page.mdx packages/documentation/src/pages/guides/client-templates/typescript-angular.mdx renamed to packages/documentation/src/app/guides/client-templates/typescript-angular/page.mdx

@@ -1,3 +1,7 @@
+---
+title: typescript-axios
+---
+
 import {Callout, Tabs} from 'nextra/components'
 
 # Using the `typescript-axios` template

…es/client-templates/typescript-axios.mdx …ient-templates/typescript-axios/page.mdxpackages/documentation/src/pages/guides/client-templates/typescript-axios.mdx renamed to packages/documentation/src/app/guides/client-templates/typescript-axios/page.mdx packages/documentation/src/pages/guides/client-templates/typescript-axios.mdx renamed to packages/documentation/src/app/guides/client-templates/typescript-axios/page.mdx

@@ -1,3 +1,7 @@
+---
+title: typescript-fetch
+---
+
 import {Callout, Tabs} from 'nextra/components'
 
 # Using the `typescript-fetch` template