Upgrade docs to Nextra 4 and Next.js 15 (#967)

* Migrate documentation to App Router and update dependencies

* Update GitHub Actions docs workflows to fetch full git history

Author: better-salmon

.github/workflows/deploy-docs.yml

@@ -25,6 +25,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - uses: pnpm/action-setup@v4
 

.github/workflows/test-docs.yml

@@ -20,6 +20,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - uses: pnpm/action-setup@v4
 

biome.json

@@ -21,7 +21,8 @@
           }
         },
         "noDefaultExport": "off",
-        "useNamingConvention": "off"
+        "useNamingConvention": "off",
+        "noImplicitBoolean": "off"
       },
       "correctness": {
         "noNodejsModules": "off",

docs/cache-handler-docs/next.config.js renamed to docs/cache-handler-docs/next.config.ts

@@ -1,21 +1,17 @@
+import type { NextConfig } from 'next';
 import nextra from 'nextra';
 
 const basePath = process.env.CI ? '/next-shared-cache' : '';
 
-const withNextra = nextra({
-  theme: 'nextra-theme-docs',
-  themeConfig: './theme.config.jsx',
-  staticImage: true,
-});
-
-export default withNextra({
+const nextConfig: NextConfig = {
   output: 'export',
   basePath,
   images: { unoptimized: true },
   env: {
     NEXT_PUBLIC_BASE_URL: basePath,
   },
-  eslint: {
-    ignoreDuringBuilds: true,
-  },
-});
+};
+
+const withNextra = nextra({});
+
+export default withNextra(nextConfig);

docs/cache-handler-docs/package.json

@@ -4,26 +4,27 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "build:docs": "next build",
-    "dev:docs": "next dev",
+    "build:docs": "next build && pagefind --site .next/server/app --output-path out/_pagefind",
+    "dev:docs": "next dev --turbo",
     "eslint:check": "next lint",
     "eslint:fix": "next lint --fix",
     "start:docs": "serve out"
   },
   "dependencies": {
-    "next": "14.2.15",
-    "nextra": "3.2.4",
-    "nextra-theme-docs": "3.2.4",
-    "react": "18.3.1",
-    "react-dom": "18.3.1"
+    "next": "15.1.6",
+    "nextra": "4.2.4",
+    "nextra-theme-docs": "4.2.4",
+    "react": "19.0.0",
+    "react-dom": "19.0.0"
   },
   "devDependencies": {
     "@repo/eslint-config": "workspace:*",
     "@repo/typescript-config": "workspace:*",
     "@types/node": "22.13.1",
-    "@types/react": "18.3.12",
-    "@types/react-dom": "18.3.1",
+    "@types/react": "19.0.8",
+    "@types/react-dom": "19.0.3",
     "eslint": "9.20.0",
+    "pagefind": "1.3.0",
     "serve": "14.2.4",
     "typescript": "5.7.3"
   }

docs/cache-handler-docs/public/favicon-16x16.png

@@ -1,4 +1,6 @@
-export default {
+import type { MetaRecord } from 'nextra';
+
+const meta: MetaRecord = {
   '-- Getting Started': {
     type: 'separator',
     title: 'Getting Started',
@@ -12,14 +14,12 @@ export default {
   },
   redis: 'Built-in Redis Handler',
   'cluster-example': {
-    title: 'Redis Cluster example ↗',
+    title: 'Redis Cluster example',
     href: 'https://github.com/mauroaccornero/cache-handler-redis-cluster-example',
-    newWindow: true,
   },
   'k8s-example': {
-    title: 'Kubernetes example ↗',
+    title: 'Kubernetes example',
     href: 'https://github.com/ezeparziale/nextjs-k8s',
-    newWindow: true,
   },
   '-- API Reference': {
     type: 'separator',
@@ -32,19 +32,19 @@ export default {
     type: 'separator',
     title: 'Troubleshooting',
   },
-  troubleshooting: '',
+  troubleshooting: 'Troubleshooting',
   '-- More': {
     type: 'separator',
     title: 'More',
   },
   'official-example': {
-    title: 'Official Next.js template ↗',
+    title: 'Official Next.js template',
     href: 'https://github.com/vercel/next.js/tree/canary/examples/cache-handler-redis',
-    newWindow: true,
   },
   'next.js-link': {
-    title: 'Next.js Configuring caching Docs ↗',
+    title: 'Next.js Configuring caching Docs',
     href: 'https://nextjs.org/docs/app/building-your-application/deploying#configuring-caching',
-    newWindow: true,
   },
 };
+
+export default meta;