From 5314d73a8b76d9aea0712e21b355f8b9fee668c2 Mon Sep 17 00:00:00 2001
From: Leszek Grzanka <leszek.grzanka@gmail.com>
Date: Thu, 1 Oct 2026 20:55:15 +0200
Subject: [PATCH] Add custom YAPTIDE 404 page

Replace Starlight's default 404 with a YAPTIDE-branded splash page that
links back to the docs home, popular pages, the user docs, and the issue
tracker for reporting broken links.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/content/docs/404.mdx | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 src/content/docs/404.mdx

diff --git a/src/content/docs/404.mdx b/src/content/docs/404.mdx
new file mode 100644
index 0000000..07d2b5d
--- /dev/null
+++ b/src/content/docs/404.mdx
@@ -0,0 +1,31 @@
+---
+title: Page not found
+template: splash
+editUrl: false
+pagefind: false
+hero:
+  title: "404: Page not found"
+  tagline: This page doesn't exist or was moved. Try the search bar, or start from one of the links below.
+  image:
+    file: ../../assets/yaptide-logo.svg
+  actions:
+    - text: Back to developer docs
+      link: /for_developers/
+      icon: left-arrow
+    - text: Report a broken link
+      link: https://github.com/yaptide/for_developers/issues/new
+      icon: github
+      variant: minimal
+---
+
+import { CardGrid, LinkCard } from "@astrojs/starlight/components";
+
+## Popular pages
+
+<CardGrid>
+  <LinkCard title="Frontend Demo setup" href="/for_developers/local-setup/local-frontend-demo/" description="Run the editor in your browser with no backend." />
+  <LinkCard title="System Overview" href="/for_developers/architecture/overview/" description="How the frontend, backend, and workers fit together." />
+  <LinkCard title="API Reference" href="/for_developers/backend/api-reference/" description="Interactive OpenAPI docs for the backend." />
+</CardGrid>
+
+Looking for help using YAPTIDE rather than developing it? See the [user documentation](https://yaptide.github.io/docs/).