From 5aebd5124ca10d2f8a40f29930dcdc7aeb3b6ab9 Mon Sep 17 00:00:00 2001
From: "Aryan Singh K." <70511529+aryansk@users.noreply.github.com>
Date: Fri, 7 Aug 2026 09:10:28 +0530
Subject: [PATCH] docs: add a helpful not-found page

Signed-off-by: Aryan Singh K. <70511529+aryansk@users.noreply.github.com>
---
 src/app/not-found.tsx | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 src/app/not-found.tsx

diff --git a/src/app/not-found.tsx b/src/app/not-found.tsx
new file mode 100644
index 000000000..3f4b77f0a
--- /dev/null
+++ b/src/app/not-found.tsx
@@ -0,0 +1,33 @@
+import { Button, Center, Stack, Text, Title } from "@mantine/core";
+import Link from "next/link";
+import { getPageMetadata } from "@/page-metadata";
+
+export const metadata = getPageMetadata({
+  pageTitle: "Page not found",
+  pageDescription: "The page you requested could not be found.",
+  pagePath: "/404",
+});
+
+export default function NotFound() {
+  return (
+    <Center mih="50vh">
+      <Stack align="center" gap="md" maw={600}>
+        <Title order={1} ta="center">
+          Page not found
+        </Title>
+        <Text c="dimmed" ta="center">
+          The page you requested does not exist or may have moved. Try the
+          latest Prometheus documentation or return to the home page.
+        </Text>
+        <Stack gap="xs" align="center">
+          <Button component={Link} href="/docs/introduction/overview">
+            Go to the latest documentation
+          </Button>
+          <Button component={Link} href="/" variant="subtle">
+            Return to Prometheus
+          </Button>
+        </Stack>
+      </Stack>
+    </Center>
+  );
+}