Files
f02488c3c6 fix(docs): add custom 404 page with proper theme support (#5779)
* fix(docs): add custom 404 page with proper theme support

The default Next.js error page renders with a hardcoded black
background and dark color scheme, causing broken styling in light
mode (black background, invisible banner text) and the 404 message
not being centered.

Add a custom not-found.tsx that uses Fumadocs DocsPage component
to properly inherit the active theme, centers the 404 message,
and sets a concise tab title.

Fixes #5778

* fix(docs): move not-found to root and override h1 padding

Place not-found.tsx at the app root so it catches unmatched URLs
across all route groups (e.g. /blog/*, /api/*) — a not-found inside
the (doc) group only catches 404s within that segment.

Add `py-0!` to the heading to defeat the global `h1 { @apply py-3 }`
rule from global.css; `border-none` already neutralizes the bottom
border. Wrap in DocsLayout so the 404 keeps the sidebar/nav chrome.

---------

Co-authored-by: Colin McDonnell <[email protected]>
2026-04-27 19:55:55 -07:00

75 lines
2.6 KiB
TypeScript

import { baseOptions } from "@/app/layout.config";
import { source } from "@/loaders/source";
import { DocsLayout, type DocsLayoutProps } from "fumadocs-ui/layouts/docs";
import type { ReactNode } from "react";
import { SidebarItem, SidebarSeparator } from "@/components/sidebar-item";
import { SidebarLogo } from "@/components/sidebar-logo";
export const dynamic = "force-static";
export const layoutProps: DocsLayoutProps = {
...baseOptions,
tree: source.pageTree,
sidebar: {
hideSearch: false,
collapsible: false,
prefetch: false, // Disable prefetching to prevent all pages from being fetched on every page load
components: {
Item: SidebarItem,
Separator: SidebarSeparator,
},
tabs: [
{
title: "Zod 4",
description: "The latest version of Zod",
url: "/",
icon: <SidebarLogo src="/logo/logo.png" alt="Zod 4" width={24} height={20} className="h-5" />,
},
{
title: "Zod 3",
description: "In maintenance mode",
url: "https://v3.zod.dev",
icon: (
<SidebarLogo
src="https://raw.githubusercontent.com/colinhacks/zod/3782fe29920c311984004c350b9fefaf0ae4c54a/logo.svg"
alt="Zod 3"
width={24}
height={24}
className="h-6"
/>
),
},
],
},
nav: {
...baseOptions.nav,
transparentMode: "top",
enabled: true,
enableSearch: true,
},
links: [
{
type: "icon",
url: "https://github.com/colinhacks/zod",
text: "GitHub",
icon: (
<svg role="img" viewBox="0 0 24 24" fill="currentColor">
<title>github logo</title>
<path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" />
</svg>
),
external: true,
},
],
};
export default function Layout({ children }: { children: ReactNode }) {
return (
<DocsLayout {...layoutProps} containerProps={{}}>
{children}
</DocsLayout>
);
}