From b61967f32f51854b1d316d71cadc74fcc55b62a3 Mon Sep 17 00:00:00 2001
From: Ryan Malloy <ryan@supported.systems>
Date: Mon, 9 Mar 2026 03:53:46 -0600
Subject: [PATCH] Add splash landing page for docs site

Scenario-driven homepage that introduces mckicad through what
engineers actually say when they sit down to work. Removes the
root redirect so / serves index.html directly.
---
 docs-site/Caddyfile                  |  2 -
 docs-site/src/content/docs/index.mdx | 74 ++++++++++++++++++++++++++++
 docs-site/src/styles/custom.css      | 25 ++++++++++
 3 files changed, 99 insertions(+), 2 deletions(-)
 create mode 100644 docs-site/src/content/docs/index.mdx

diff --git a/docs-site/Caddyfile b/docs-site/Caddyfile
index 875f179..e0f8ffe 100644
--- a/docs-site/Caddyfile
+++ b/docs-site/Caddyfile
@@ -1,6 +1,4 @@
 :80 {
-    redir / /getting-started/ 302
-
     root * /srv
     file_server
     try_files {path} {path}/index.html {path}/
diff --git a/docs-site/src/content/docs/index.mdx b/docs-site/src/content/docs/index.mdx
new file mode 100644
index 0000000..d3c5739
--- /dev/null
+++ b/docs-site/src/content/docs/index.mdx
@@ -0,0 +1,74 @@
+---
+title: "Describe what you need. Watch it happen."
+description: "mckicad connects natural conversation to KiCad's full toolchain. No plugins. No GUI macros. Just say what you're working on."
+template: splash
+hero:
+  title: "Describe what you need. Watch it happen."
+  tagline: "mckicad connects natural conversation to KiCad's full toolchain. No plugins. No GUI macros. Just say what you're working on."
+  actions:
+    - text: Get Started
+      link: /getting-started/installation/
+      icon: right-arrow
+      variant: primary
+    - text: Browse Tools
+      link: /reference/tools/
+      variant: minimal
+---
+
+import { Card, CardGrid, LinkCard } from "@astrojs/starlight/components";
+
+## Start from where you are
+
+<CardGrid>
+  <Card title="&quot;I have a reference design PDF and no KiCad files&quot;">
+    mckicad creates a new project, places components from KiCad's libraries,
+    wires them up, and runs ERC — from a description of what you need.
+  </Card>
+
+  <Card title="&quot;I've got KiCad files and need to make a change&quot;">
+    Open your project, describe the modification. Components get added, moved,
+    or rewired. DRC runs automatically so nothing slips through.
+  </Card>
+
+  <Card title="&quot;Make a BOM and check what I need to order&quot;">
+    BOM exported from your schematic, broken down by category with component
+    counts and value summaries. Ready for procurement or review.
+  </Card>
+
+  <Card title="&quot;I have a question about my design&quot;">
+    Net connectivity, pin assignments, component details, routing quality — ask
+    about your schematic or board and get answers from the actual files.
+  </Card>
+</CardGrid>
+
+## How it connects
+
+mckicad is an MCP server. It speaks to KiCad through its CLI for batch operations
+and its IPC API for live interaction. Your EDA tools stay exactly where they are —
+mckicad just gives them a voice.
+
+## What happens under the hood
+
+<CardGrid>
+  <Card title="Schematic creation & editing">
+    Components, wires, labels, power symbols, hierarchical sheets. Hundreds of
+    operations applied in a single atomic batch — one load-save cycle, no partial
+    states.
+  </Card>
+
+  <Card title="Verification & export">
+    DRC, ERC, BOM generation, Gerber/drill/PDF export. Manufacturing-ready output
+    from conversation. Rule sets for standard, HDI, RF, or automotive designs.
+  </Card>
+
+  <Card title="Live board interaction">
+    Real-time analysis while KiCad is open. Component inspection, connectivity
+    monitoring, zone management, and routing quality — all through the IPC API.
+  </Card>
+</CardGrid>
+
+<LinkCard
+  title="Get started in 5 minutes"
+  description="Install mckicad and connect it to your first KiCad project."
+  href="/getting-started/installation/"
+/>
diff --git a/docs-site/src/styles/custom.css b/docs-site/src/styles/custom.css
index 9c8ce0e..455d261 100644
--- a/docs-site/src/styles/custom.css
+++ b/docs-site/src/styles/custom.css
@@ -12,3 +12,28 @@
   --sl-color-accent: #1d7042;
   --sl-color-accent-high: #0e3d22;
 }
+
+/* ── Landing page ────────────────────────────── */
+
+/* Constrain hero tagline on wide screens */
+[data-has-hero] .hero .tagline {
+  max-width: 38rem;
+}
+
+/* Green left-border accent on scenario cards */
+[data-has-hero] .card {
+  border-left: 3px solid var(--sl-color-accent);
+}
+
+/* "How it connects" section — muted background */
+[data-has-hero] .sl-markdown-content > p {
+  background: var(--sl-color-accent-low);
+  padding: 1.25rem 1.5rem;
+  border-radius: 0.5rem;
+  line-height: 1.7;
+}
+
+/* Final CTA spacing */
+[data-has-hero] .sl-link-card {
+  margin-top: 2rem;
+}