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
+
+
+
+ mckicad creates a new project, places components from KiCad's libraries,
+ wires them up, and runs ERC — from a description of what you need.
+
+
+
+ Open your project, describe the modification. Components get added, moved,
+ or rewired. DRC runs automatically so nothing slips through.
+
+
+
+ BOM exported from your schematic, broken down by category with component
+ counts and value summaries. Ready for procurement or review.
+
+
+
+ Net connectivity, pin assignments, component details, routing quality — ask
+ about your schematic or board and get answers from the actual files.
+
+
+
+## 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
+
+
+
+ Components, wires, labels, power symbols, hierarchical sheets. Hundreds of
+ operations applied in a single atomic batch — one load-save cycle, no partial
+ states.
+
+
+
+ DRC, ERC, BOM generation, Gerber/drill/PDF export. Manufacturing-ready output
+ from conversation. Rule sets for standard, HDI, RF, or automotive designs.
+
+
+
+ Real-time analysis while KiCad is open. Component inspection, connectivity
+ monitoring, zone management, and routing quality — all through the IPC API.
+
+
+
+
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;
+}