vercel · nuta · Apr 24, 2026 · Apr 22, 2026
diff --git a/docs/app/[[...mdxPath]]/page.jsx b/docs/app/[[...mdxPath]]/page.jsx
@@ -0,0 +1,52 @@
+import { generateStaticParamsFor, importPage } from 'nextra/pages'
+import { useMDXComponents as getMDXComponents } from '../../mdx-components'
+
+export const generateStaticParams = generateStaticParamsFor('mdxPath')
+
+function pathnameFromParams(mdxPath) {
+  if (!mdxPath?.length) return '/'
+  return `/${mdxPath.join('/')}`
+}
+
+export async function generateMetadata(props) {
+  const params = await props.params
+  const { metadata } = await importPage(params.mdxPath)
+  const title = metadata.title
+  const description = metadata.description
+  const ogImage = metadata.ogImage ?? '/og-image.png'
+  const pathname = pathnameFromParams(params.mdxPath)
+  const pageTitle = title ? `${title} | Edge Runtime` : 'Edge Runtime'
+
+  return {
+    title: pageTitle,
+    description,
+    openGraph: {
+      title,
+      description,
+      url: `https://edge-runtime.vercel.app${pathname}`,
+      siteName: 'Edge Runtime',
+      images: [{ url: ogImage }],
+      type: 'website',
+    },
+    twitter: {
+      card: 'summary_large_image',
+    },
+  }
+}
+
+export default async function Page(props) {
+  const params = await props.params
+  const {
+    default: MDXContent,
+    toc,
+    metadata,
+    sourceCode,
+  } = await importPage(params.mdxPath)
+  const Wrapper = getMDXComponents().wrapper
+
+  return (
+    <Wrapper toc={toc} metadata={metadata} sourceCode={sourceCode}>
+      <MDXContent {...props} params={params} />
+    </Wrapper>
+  )
+}
diff --git a/docs/app/layout.jsx b/docs/app/layout.jsx
@@ -0,0 +1,65 @@
+import { Footer, Layout, Navbar } from 'nextra-theme-docs'
+import { Head } from 'nextra/components'
+import { getPageMap } from 'nextra/page-map'
+import { Inter } from 'next/font/google'
+import '../styles.css'
+
+const inter = Inter({ subsets: ['latin'], display: 'optional' })
+
+export const metadata = {
+  metadataBase: new URL('https://edge-runtime.vercel.app'),
+}
+
+export default async function RootLayout({ children }) {
+  const pageMap = await getPageMap()
+
+  return (
+    <html
+      lang='en'
+      dir='ltr'
+      suppressHydrationWarning
+      className={inter.className}
+    >
+      <Head>
+        <meta name='viewport' content='width=device-width, initial-scale=1.0' />
+        <link rel='icon' href='/logo.svg' type='image/svg+xml' />
+      </Head>
+      <body>
+        <Layout
+          navbar={
+            <Navbar
+              projectLink='https://github.com/vercel/edge-runtime'
+              logo={
+                <>
+                  <img
+                    width={24}
+                    height={24}
+                    src='/logo.svg'
+                    alt='Edge Runtime logo'
+                    className='dark:hidden'
+                  />
+                  <img
+                    width={24}
+                    height={24}
+                    src='/logo-dark.svg'
+                    alt=''
+                    className='hidden dark:block'
+                  />
+                  <span className='w-full font-bold pl-2'>Edge Runtime</span>
+                </>
+              }
+            />
+          }
+          pageMap={pageMap}
+          docsRepositoryBase='https://github.com/vercel/edge-runtime/blob/main/docs'
+          editLink='Edit this page on GitHub'
+          feedback={{ content: 'Question? Give us feedback →' }}
+          toc={{ float: true }}
+          footer={<Footer />}
+        >
+          {children}
+        </Layout>
+      </body>
+    </html>
+  )
+}
diff --git a/docs/content/_meta.js b/docs/content/_meta.js
@@ -0,0 +1,16 @@
+export default {
+  '*': {
+    theme: {
+      footer: false,
+    },
+  },
+  index: 'Introduction',
+  'getting-started': 'Getting Started',
+  cli: 'Command-line Interface',
+  features: 'Features',
+  packages: 'Packages',
+  changelog: {
+    title: 'Changelog',
+    href: 'https://github.com/vercel/edge-runtime/releases',
+  },
+}
diff --git a/docs/pages/cli.mdx → docs/content/cli.mdx b/docs/pages/cli.mdx → docs/content/cli.mdx
diff --git a/docs/content/features/_meta.js b/docs/content/features/_meta.js
@@ -0,0 +1,6 @@
+export default {
+  'available-apis': 'Edge Runtime APIs',
+  polyfills: 'Polyfills',
+  'typescript-support': 'TypeScript support',
+  'upgrading-nextjs': 'Upgrading Next.js',
+}
diff --git a/docs/pages/features/available-apis.mdx → docs/content/features/available-apis.mdx b/docs/pages/features/available-apis.mdx → docs/content/features/available-apis.mdx
diff --git a/docs/pages/features/polyfills.mdx → docs/content/features/polyfills.mdx b/docs/pages/features/polyfills.mdx → docs/content/features/polyfills.mdx
diff --git a/docs/pages/features/typescript-support.mdx → docs/content/features/typescript-support.mdx b/docs/pages/features/typescript-support.mdx → docs/content/features/typescript-support.mdx
diff --git a/docs/pages/features/upgrading-nextjs.mdx → docs/content/features/upgrading-nextjs.mdx b/docs/pages/features/upgrading-nextjs.mdx → docs/content/features/upgrading-nextjs.mdx
diff --git a/docs/pages/getting-started.mdx → docs/content/getting-started.mdx b/docs/pages/getting-started.mdx → docs/content/getting-started.mdx
diff --git a/docs/pages/index.mdx → docs/content/index.mdx b/docs/pages/index.mdx → docs/content/index.mdx
diff --git a/docs/content/packages/_meta.js b/docs/content/packages/_meta.js
@@ -0,0 +1,13 @@
+export default {
+  cookies: '@edge-runtime/cookies',
+  format: '@edge-runtime/format',
+  'jest-environment': '@edge-runtime/jest-environment',
+  'jest-expect': '@edge-runtime/jest-expect',
+  'node-utils': '@edge-runtime/node-utils',
+  ponyfill: '@edge-runtime/ponyfill',
+  primitives: '@edge-runtime/primitives',
+  runtime: 'edge-runtime',
+  types: '@edge-runtime/types',
+  'user-agent': '@edge-runtime/user-agent',
+  vm: '@edge-runtime/vm',
+}
diff --git a/docs/pages/packages/cookies.mdx → docs/content/packages/cookies.mdx b/docs/pages/packages/cookies.mdx → docs/content/packages/cookies.mdx
diff --git a/docs/pages/packages/format.mdx → docs/content/packages/format.mdx b/docs/pages/packages/format.mdx → docs/content/packages/format.mdx
diff --git a/docs/pages/packages/jest-environment.mdx → docs/content/packages/jest-environment.mdx b/docs/pages/packages/jest-environment.mdx → docs/content/packages/jest-environment.mdx
diff --git a/docs/pages/packages/jest-expect.mdx → docs/content/packages/jest-expect.mdx b/docs/pages/packages/jest-expect.mdx → docs/content/packages/jest-expect.mdx
diff --git a/docs/pages/packages/node-utils.mdx → docs/content/packages/node-utils.mdx b/docs/pages/packages/node-utils.mdx → docs/content/packages/node-utils.mdx
@@ -15,7 +15,7 @@ This package includes built-in TypeScript support.
 ## Usage
 
 ```ts
-import { once } = from 'node:events'
+import { once } from 'node:events'
 import { createServer } from 'node:http'
 import { buildToNodeHandler } from '@edge-runtime/node-utils'
 
@@ -27,7 +27,7 @@ const transformToNode = buildToNodeHandler(global, {
 const server = await createServer(
   // 2. takes an web compliant request handler, that uses Web globals like Request and Response,
   // and turn it into a Node.js compliant request handler.
-  transformToNode(async (req: Request) => new Response(req.body))
+  transformToNode(async (req: Request) => new Response(req.body)),
 )
 
 // 3. start the node.js server
@@ -37,7 +37,7 @@ await once(server, 'listening')
 // 4. invoke the request handler
 const response = await fetch(
   `http://localhost:${(server.address() as AddressInfo).port}`,
-  { method: 'POST', body: 'hello world' }
+  { method: 'POST', body: 'hello world' },
 )
 
 console.log(await response.text()) // is 'hello world'

diff --git a/docs/pages/packages/ponyfill.mdx → docs/content/packages/ponyfill.mdx b/docs/pages/packages/ponyfill.mdx → docs/content/packages/ponyfill.mdx
diff --git a/docs/pages/packages/primitives.mdx → docs/content/packages/primitives.mdx b/docs/pages/packages/primitives.mdx → docs/content/packages/primitives.mdx
diff --git a/docs/pages/packages/runtime.mdx → docs/content/packages/runtime.mdx b/docs/pages/packages/runtime.mdx → docs/content/packages/runtime.mdx
diff --git a/docs/pages/packages/types.mdx → docs/content/packages/types.mdx b/docs/pages/packages/types.mdx → docs/content/packages/types.mdx
diff --git a/docs/pages/packages/user-agent.mdx → docs/content/packages/user-agent.mdx b/docs/pages/packages/user-agent.mdx → docs/content/packages/user-agent.mdx
diff --git a/docs/pages/packages/vm.mdx → docs/content/packages/vm.mdx b/docs/pages/packages/vm.mdx → docs/content/packages/vm.mdx
diff --git a/docs/mdx-components.jsx b/docs/mdx-components.jsx
@@ -0,0 +1,10 @@
+import { useMDXComponents as getThemeComponents } from 'nextra-theme-docs'
+
+const themeComponents = getThemeComponents()
+
+export function useMDXComponents(components) {
+  return {
+    ...themeComponents,
+    ...components,
+  }
+}
diff --git a/docs/next.config.js b/docs/next.config.js
diff --git a/docs/next.config.mjs b/docs/next.config.mjs
@@ -0,0 +1,9 @@
+import nextra from 'nextra'
+
+const withNextra = nextra({
+  defaultShowCopyCode: true,
+})
+
+export default withNextra({
+  reactStrictMode: true,
+})
diff --git a/docs/package.json b/docs/package.json
@@ -3,18 +3,17 @@
   "version": "0.0.0",
   "dependencies": {
     "@heroicons/react": "~2.2.0",
-    "next": "~15.2.6",
-    "next-themes": "~0.4.6",
-    "nextra": "2",
-    "nextra-theme-docs": "2",
+    "next": "~15.5.15",
+    "nextra": "~4.6.1",
+    "nextra-theme-docs": "~4.6.1",
     "react": "18",
     "react-dom": "18",
     "swr": "~2.3.3"
   },
   "devDependencies": {
-    "autoprefixer": "~10.4.21",
+    "@tailwindcss/postcss": "^4.1.4",
     "postcss": "~8.5.3",
-    "tailwindcss": "3"
+    "tailwindcss": "^4.1.4"
   },
   "engines": {
     "node": ">=18"

diff --git a/docs/pages/_app.mdx b/docs/pages/_app.mdx
diff --git a/docs/pages/_document.js b/docs/pages/_document.js
diff --git a/docs/pages/_meta.json b/docs/pages/_meta.json
diff --git a/docs/pages/features/_meta.json b/docs/pages/features/_meta.json
diff --git a/docs/pages/packages/_meta.json b/docs/pages/packages/_meta.json
diff --git a/docs/postcss.config.js b/docs/postcss.config.js
diff --git a/docs/postcss.config.mjs b/docs/postcss.config.mjs
@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+}