From 409da2754a31ad387ebf55f95ab18cd49d7e2b45 Mon Sep 17 00:00:00 2001
From: almeida <hello@eualmeida.com.br>
Date: Mon, 18 May 2026 09:21:23 -0300
Subject: [PATCH] feat(docs): add custom docs 404 page

---
 apps/web/src/app/docs/not-found.tsx | 47 +++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 apps/web/src/app/docs/not-found.tsx

diff --git a/apps/web/src/app/docs/not-found.tsx b/apps/web/src/app/docs/not-found.tsx
new file mode 100644
index 00000000..679f54a1
--- /dev/null
+++ b/apps/web/src/app/docs/not-found.tsx
@@ -0,0 +1,47 @@
+import { ArrowLeft, BookOpenText, House } from "lucide-react";
+import Link from "next/link";
+
+import { Button } from "@/components/ui/button";
+import {
+  Empty,
+  EmptyContent,
+  EmptyDescription,
+  EmptyHeader,
+  EmptyMedia,
+  EmptyTitle,
+} from "@/components/ui/empty";
+
+export default function DocsNotFound() {
+  return (
+    <div className="flex min-h-[calc(100dvh-var(--fd-nav-height))] items-center justify-center px-6 py-16">
+      <Empty className="border-border/60 bg-card/40 mx-auto max-w-xl rounded-2xl border border-dashed">
+        <EmptyHeader>
+          <EmptyMedia variant="icon">
+            <BookOpenText className="size-4" />
+          </EmptyMedia>
+          <EmptyTitle className="text-base sm:text-lg">Documentation page not found</EmptyTitle>
+          <EmptyDescription>
+            The docs page you requested does not exist or may have moved. Start from the docs index
+            or head back to the homepage.
+          </EmptyDescription>
+        </EmptyHeader>
+
+        <EmptyContent className="sm:flex-row sm:justify-center">
+          <Button render={<Link href="/docs/get-started" />} nativeButton={false}>
+            <BookOpenText />
+            Open docs
+          </Button>
+          <Button render={<Link href="/" />} nativeButton={false} variant="ghost">
+            <House />
+            Go home
+          </Button>
+        </EmptyContent>
+
+        <div className="text-muted-foreground flex items-center gap-2 text-xs">
+          <ArrowLeft className="size-3.5" />
+          Try the sidebar or search to find another page.
+        </div>
+      </Empty>
+    </div>
+  );
+}