From bdb9d7b5064239f4f9412b4233a241c549640308 Mon Sep 17 00:00:00 2001
From: Darius Cepulis <dcepulis@mux.com>
Date: Thu, 12 Feb 2026 09:39:51 -0600
Subject: [PATCH] feat(site): basic 404 and 500 pages

progress against #508
---
 site/src/layouts/ErrorPage.astro | 32 ++++++++++++++++++++++++++++++++
 site/src/pages/404.astro         |  5 +++++
 site/src/pages/500.astro         |  5 +++++
 3 files changed, 42 insertions(+)
 create mode 100644 site/src/layouts/ErrorPage.astro
 create mode 100644 site/src/pages/404.astro
 create mode 100644 site/src/pages/500.astro

diff --git a/site/src/layouts/ErrorPage.astro b/site/src/layouts/ErrorPage.astro
new file mode 100644
index 00000000..16d648ff
--- /dev/null
+++ b/site/src/layouts/ErrorPage.astro
@@ -0,0 +1,32 @@
+---
+import Footer from '@/components/Footer.astro';
+import FooterEasterEgg from '@/components/FooterEasterEgg.astro';
+import GetStartedLink from '@/components/NavBar/GetStartedLink';
+import NavBar from '@/components/NavBar/NavBar.astro';
+import Base from '@/layouts/Base.astro';
+
+interface Props {
+  title: string;
+  description: string;
+  heading: string;
+}
+
+const { title, description, heading } = Astro.props;
+---
+
+<Base {title} {description}>
+  <div class="min-h-screen flex flex-col">
+    <NavBar />
+    <main class="flex-1 px-6 md:px-10 py-10 sm:py-14 flex items-center justify-center">
+      <div class="text-center flex flex-col items-center gap-4">
+        <h1 class="text-h2 md:text-h1">{heading}</h1>
+        <div class="text-lg flex flex-col items-center gap-2">
+          <a href="/" class="intent:underline">Go home</a>
+          <GetStartedLink client:idle className="intent:underline">Read the docs</GetStartedLink>
+        </div>
+      </div>
+    </main>
+    <Footer />
+  </div>
+  <FooterEasterEgg />
+</Base>
diff --git a/site/src/pages/404.astro b/site/src/pages/404.astro
new file mode 100644
index 00000000..c019f0b0
--- /dev/null
+++ b/site/src/pages/404.astro
@@ -0,0 +1,5 @@
+---
+import ErrorPage from '@/layouts/ErrorPage.astro';
+---
+
+<ErrorPage title="404" description="Page not found" heading="404 Not Found" />
diff --git a/site/src/pages/500.astro b/site/src/pages/500.astro
new file mode 100644
index 00000000..b55a58ab
--- /dev/null
+++ b/site/src/pages/500.astro
@@ -0,0 +1,5 @@
+---
+import ErrorPage from '@/layouts/ErrorPage.astro';
+---
+
+<ErrorPage title="500" description="Server error" heading="500 Server Error" />