chore: update to Next.js 16 (#1170)

Author: franky47

.github/workflows/ci-cd.yml

@@ -109,6 +109,7 @@ jobs:
       - name: Build docs
         run: pnpm run build --filter docs
         env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
           TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
       - uses: 47ng/actions-slack-notify@main

packages/docs/content/docs/community-adapters/inertia-adapter-source.tsx

@@ -2,6 +2,7 @@ import { CodeBlock } from '@/src/components/code-block'
 import { SiTypescript } from '@icons-pack/react-simple-icons'
 
 export async function InertiaAdapterSource() {
+  'use cache'
   const source = await fetch(
     'https://raw.githubusercontent.com/47ng/nuqs-inertia-pingcrm/refs/heads/with-nuqs/resources/js/lib/nuqs-inertia-adapter.ts'
   ).then(res => res.text())

packages/docs/content/docs/installation.mdx

@@ -22,7 +22,7 @@ npm install nuqs
 
 `nuqs@^2` supports the following frameworks and their respective versions:
 
-- <NextJS className='inline mr-1.5' role="presentation"/> [Next.js](/docs/adapters#nextjs): `next@^14.2.0 || ^15` <small className='text-muted-foreground'>(app & pages routers)</small>
+- <NextJS className='inline mr-1.5' role="presentation"/> [Next.js](/docs/adapters#nextjs): `next@>=14.2.0` <small className='text-muted-foreground'>(app & pages routers)</small>
 - <ReactSPA className='inline mr-1.5' role="presentation" /> [React SPA](/docs/adapters#react-spa): `react@^18.3 || ^19`
 - <Remix className='inline mr-1.5' role="presentation" /> [Remix](/docs/adapters#remix): `@remix-run/react@^2`
 - <ReactRouter className='inline mr-1.5' role="presentation" /> [React Router v6](/docs/adapters#react-router-v6): `react-router-dom@^6`

packages/docs/content/docs/parsers/community/zod-codecs.source.tsx

@@ -1,7 +1,10 @@
 import { CodeBlock } from '@/src/components/code-block'
+import { cacheLife } from 'next/cache'
 import { readFile } from 'node:fs/promises'
 
 export async function ZodCodecsSource() {
+  'use cache'
+  cacheLife('static')
   const filePath =
     process.cwd() + '/content/docs/parsers/community/zod-codecs.lib.ts'
   const source = await readFile(filePath, 'utf8')

packages/docs/content/docs/parsers/demos.tsx

@@ -228,7 +228,7 @@ export function IndexParserDemo() {
         </PaginationContent>
       </Pagination>
       <CodeBlock
-        className="-mx-1 my-0 -mb-1 flex-1 border-none"
+        className="my-0 h-10 flex-1 rounded-sm border-none [&>div]:py-2"
         code={`pageIndex: ${pageIndex} // internal state is zero-indexed`}
         allowCopy={false}
       />

packages/docs/next.config.mjs

@@ -5,17 +5,39 @@ import { createMDX } from 'fumadocs-mdx/next'
 
 const withFumadocsMDX = createMDX()
 
+const enableSentry =
+  Boolean(process.env.NEXT_PUBLIC_SENTRY_DSN) &&
+  Boolean(process.env.SENTRY_AUTH_TOKEN) &&
+  ['production', 'preview'].includes(process.env.VERCEL_ENV ?? '')
+
 /** @type {import('next').NextConfig} */
 const config = {
   outputFileTracingIncludes: {
     '/playground/pagination': [
-      './src/app/playground/(demos)/pagination/searchParams.ts',
+      './src/app/playground/(demos)/pagination/search-params.ts',
       './src/app/playground/(demos)/pagination/page.tsx',
       './src/app/playground/(demos)/pagination/pagination-controls.server.tsx',
       './src/app/playground/(demos)/pagination/pagination-controls.client.tsx'
     ]
   },
+  reactCompiler: true,
+  cacheComponents: true,
   reactStrictMode: true,
+  cacheLife: {
+    static: {
+      // Only changes on new deploys, assuming we at least deploy once a year
+      stale: 300, // 5 minutes for the client cache
+      revalidate: 365 * 24 * 60 * 60, // 1 year
+      expire: 366 * 24 * 60 * 60 // 1 year + 1 day (has to be greater than revalidate)
+    }
+  },
+  turbopack: {
+    debugIds: enableSentry
+  },
+  experimental: {
+    isolatedDevBuild: true
+  },
+  productionBrowserSourceMaps: enableSentry,
   redirects: async () => {
     return [
       {
@@ -65,45 +87,52 @@ const config = {
   }
 }
 
+/**
+ * @type {import('@sentry/nextjs').SentryBuildOptions}
+ */
 const sentryConfig = {
   // For all available options, see:
   // https://github.com/getsentry/sentry-webpack-plugin#options
 
-  // Suppresses source map uploading logs during build
   silent: true,
   org: process.env.SENTRY_ORG,
   project: process.env.SENTRY_PROJECT,
-  authToken: process.env.SENTRY_AUTH_TOKEN
-}
-
-const sentryOptions = {
-  // For all available options, see:
-  // https://docs.sentry.io/platforms/javascript/guides/nextjs/manual-setup/
+  authToken: process.env.SENTRY_AUTH_TOKEN,
 
   // Upload a larger set of source maps for prettier stack traces (increases build time)
-  widenClientFileUpload: false,
+  widenClientFileUpload: true,
 
-  // Transpiles SDK to be compatible with IE11 (increases bundle size)
-  transpileClientSDK: false,
+  release: {
+    setCommits: process.env.VERCEL_GIT_COMMIT_SHA
+      ? {
+          // https://github.com/getsentry/sentry-javascript-bundler-plugins/issues/443#issuecomment-1815988709
+          repo: '47ng/nuqs',
+          commit: process.env.VERCEL_GIT_COMMIT_SHA
+        }
+      : { auto: true }
+  },
 
   // Routes browser requests to Sentry through a Next.js rewrite to circumvent ad-blockers. (increases server load)
   // Note: Check that the configured route will not match with your Next.js middleware, otherwise reporting of client-
   // side errors will fail.
   // tunnelRoute: '/sentry',
 
-  hideSourceMaps: false,
-
   // Automatically tree-shake Sentry logger statements to reduce bundle size
-  disableLogger: true,
+  // disableLogger: true,
 
   // Enables automatic instrumentation of Vercel Cron Monitors.
   // See the following for more information:
   // https://docs.sentry.io/product/crons/
   // https://vercel.com/docs/cron-jobs
-  automaticVercelMonitors: true
+  automaticVercelMonitors: true,
+
+  debug: false
+}
+
+if (enableSentry) {
+  console.info('Sentry is enabled for this build.')
 }
 
-export default withSentryConfig(withFumadocsMDX(config), {
-  ...sentryConfig,
-  ...sentryOptions
-})
+export default enableSentry
+  ? withSentryConfig(withFumadocsMDX(config), sentryConfig)
+  : withFumadocsMDX(config)

packages/docs/package.json

@@ -14,7 +14,7 @@
     "directory": "packages/docs"
   },
   "scripts": {
-    "dev": "next dev --turbo",
+    "dev": "next dev",
     "build": "pnpm run build:registry && pnpm run build:next",
     "build:next": "next build",
     "build:registry": "shadcn build",
@@ -23,8 +23,8 @@
     "test": "tsc"
   },
   "dependencies": {
-    "@faker-js/faker": "^9.9.0",
-    "@headlessui/react": "2.2.7",
+    "@faker-js/faker": "^10.1.0",
+    "@headlessui/react": "2.2.9",
     "@headlessui/tailwindcss": "^0.2.2",
     "@icons-pack/react-simple-icons": "^13.7.0",
     "@number-flow/react": "^0.5.10",
@@ -40,18 +40,18 @@
     "@radix-ui/react-toggle": "^1.1.10",
     "@radix-ui/react-toggle-group": "^1.1.11",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "@sentry/nextjs": "^8.55.0",
+    "@sentry/nextjs": "^10.20.0",
     "@tailwindcss/container-queries": "^0.1.1",
     "@tailwindcss/postcss": "^4.1.12",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "dayjs": "^1.11.13",
     "effect": "^3.17.8",
-    "fumadocs-core": "^15.6.12",
-    "fumadocs-mdx": "^11.7.5",
-    "fumadocs-ui": "^15.6.12",
-    "lucide-react": "^0.540.0",
-    "next": "15.5.0",
+    "fumadocs-core": "^16.0.4",
+    "fumadocs-mdx": "^13.0.2",
+    "fumadocs-ui": "^16.0.4",
+    "lucide-react": "^0.548.0",
+    "next": "16.0.1",
     "nuqs": "workspace:*",
     "react": "catalog:react19",
     "react-dom": "catalog:react19",
@@ -71,10 +71,10 @@
     "@types/react": "catalog:react19",
     "@types/react-dom": "catalog:react19",
     "hast-util-to-jsx-runtime": "^2.3.6",
-    "import-in-the-middle": "^1.14.2",
+    "import-in-the-middle": "^2.0.0",
     "postcss": "^8.5.6",
-    "prettier-plugin-tailwindcss": "^0.6.14",
-    "require-in-the-middle": "^7.5.2",
+    "prettier-plugin-tailwindcss": "^0.7.1",
+    "require-in-the-middle": "^8.0.1",
     "shadcn": "^3.4.2",
     "shiki": "^3.11.0",
     "typescript": "^5.9.2"

packages/docs/sentry.edge.config.ts

@@ -0,0 +1,22 @@
+// This file configures the initialization of Sentry for edge features (middleware, edge routes, and so on).
+// The config you add here will be used whenever one of the edge features is loaded.
+// Note that this config is unrelated to the Vercel Edge Runtime and is also required when running locally.
+// https://docs.sentry.io/platforms/javascript/guides/nextjs/
+
+import * as Sentry from '@sentry/nextjs'
+
+const enabled =
+  Boolean(process.env.NEXT_PUBLIC_SENTRY_DSN) &&
+  Boolean(process.env.SENTRY_AUTH_TOKEN) &&
+  ['production', 'preview'].includes(process.env.VERCEL_ENV ?? '')
+
+Sentry.init({
+  dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
+  enabled,
+
+  // Define how likely traces are sampled. Adjust this value in production, or use tracesSampler for greater control.
+  tracesSampleRate: 1,
+
+  // Setting this option to true will print useful information to the console while you're setting up Sentry.
+  debug: false
+})

packages/docs/sentry.server.config.ts

@@ -0,0 +1,21 @@
+// This file configures the initialization of Sentry on the server.
+// The config you add here will be used whenever the server handles a request.
+// https://docs.sentry.io/platforms/javascript/guides/nextjs/
+
+import * as Sentry from '@sentry/nextjs'
+
+const enabled =
+  Boolean(process.env.NEXT_PUBLIC_SENTRY_DSN) &&
+  Boolean(process.env.SENTRY_AUTH_TOKEN) &&
+  ['production', 'preview'].includes(process.env.VERCEL_ENV ?? '')
+
+Sentry.init({
+  dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
+  enabled,
+
+  // Define how likely traces are sampled. Adjust this value in production, or use tracesSampler for greater control.
+  tracesSampleRate: 1,
+
+  // Setting this option to true will print useful information to the console while you're setting up Sentry.
+  debug: false
+})

packages/docs/src/app/(pages)/_landing/bundle-size.tsx

@@ -1,3 +1,4 @@
+import { cacheLife } from 'next/cache'
 import fs from 'node:fs/promises'
 import path from 'node:path'
 
@@ -13,6 +14,8 @@ function prettyBytes(size: number) {
 }
 
 export async function BundleSize() {
+  'use cache'
+  cacheLife('static') // Only changes on new deploys
   const filePath = path.resolve(process.cwd(), '../../packages/nuqs/size.json')
   try {
     const json = await fs.readFile(filePath, 'utf8')