From e5a770d48e60b043e2b089378cda087d4f23b91b Mon Sep 17 00:00:00 2001
From: Colin Murphy <colinmurphy@users.noreply.github.com>
Date: Thu, 23 Oct 2025 15:07:11 +0100
Subject: [PATCH 1/3] Create index.md for docs. Fixes #458

---
 docs/index.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 docs/index.md

diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 00000000..c423d379
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,37 @@
+# Introduction
+
+## What is the Headless WordPress Toolkit?
+
+The Headless WordPress Toolkit is a modern, framework-agnostic toolkit for building headless WordPress applications. It provides a collection of plugins, packages, and examples to help developers make WordPress a better headless CMS.
+
+Our goal is to provide developers with the tools they need to build fast, scalable, and secure headless applications with WordPress, without being tied to a specific frontend framework.
+
+## Plugins
+
+The toolkit includes several WordPress plugins to enhance the headless experience.
+
+| Plugin | Description |
+|--------|-------------|
+| [`hwp-previews`](../plugins/hwp-previews/) | Headless Previews solution for WordPress: fully configurable preview URLs via the settings page which is framework agnostic. |
+| [`wpgraphql-webhooks`](../plugins/wpgraphql-webhooks/) | Extends WPGraphQL to support webhook subscriptions and dispatching for headless WordPress environments. |
+| [`wpgraphql-logging`](../plugins/wpgraphql-logging/) | Logging for WPGraphQL requests with granular lifecycle events and Monolog integration. |
+| [`wpgraphql-debug-extensions`](../plugins/wpgraphql-debug-extensions/) | Advanced debugging, performance analysis, and metric collection for WPGraphQL. |
+
+You can find more information about installation in the [plugins documentation](../plugins/README.md).
+
+## Packages
+
+We provide NPM packages that can be used in your frontend applications. All packages use vanilla ES Modules with no build step.
+
+- [`@wpengine/hwp-toolbar`](../packages/toolbar/) — in active development (not yet published)
+
+> [!NOTE]
+> No packages are published to npm yet. These are pre-release and subject to change.
+
+## Examples
+
+This project contains a wide variety of examples demonstrating how to use the Headless WordPress Toolkit with different frameworks like Next.js, Astro, SvelteKit, and Nuxt.
+
+Most examples include a `wp-env` setup, allowing you to fully configure a headless application with a single command.
+
+For a full list of examples and how to run them, please see the [examples documentation](../examples/README.md).

From b0872351b01a946f1e4fbc0a4952e0969644cd41 Mon Sep 17 00:00:00 2001
From: Colin Murphy <colinmurphy@users.noreply.github.com>
Date: Thu, 23 Oct 2025 15:32:09 +0100
Subject: [PATCH 2/3] Added missing markdown title and description.

---
 docs/index.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/index.md b/docs/index.md
index c423d379..8ea9b807 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,3 +1,9 @@
+---
+title: "Introduction"
+description: "Introduction to the Headless WordPress Toolkit, a modern, framework-agnostic collection of plugins and packages for building headless WordPress applications."
+---
+
+
 # Introduction
 
 ## What is the Headless WordPress Toolkit?

From ef13e813af0c377fb68b03c9cfa6913332a1d3fe Mon Sep 17 00:00:00 2001
From: Colin Murphy <colinmurphy@users.noreply.github.com>
Date: Thu, 23 Oct 2025 15:39:33 +0100
Subject: [PATCH 3/3] Added missing nav.json for the sidebar.

---
 docs/nav.json | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 docs/nav.json

diff --git a/docs/nav.json b/docs/nav.json
new file mode 100644
index 00000000..e6d0c2bd
--- /dev/null
+++ b/docs/nav.json
@@ -0,0 +1,50 @@
+[
+	{
+		"title": "Introduction",
+		"route": "/docs/"
+	},
+	{
+		"title": "Explanation",
+		"route": "/docs/explanation/",
+		"children": [
+			{
+				"title": "GET vs POST",
+				"route": "/docs/explanation/get-vs-post/"
+			},
+			{
+				"title": "GraphQL Endpoints",
+				"route": "/docs/explanation/graphql-endpoints/"
+			},
+			{
+				"title": "Headless Authentication",
+				"route": "/docs/explanation/headless-authentication/"
+			},
+			{
+				"title": "Rendering Options",
+				"route": "/docs/explanation/rendering-options/"
+			},
+			{
+				"title": "Routing",
+				"route": "/docs/explanation/routing/"
+			},
+			{
+				"title": "Sitemaps",
+				"route": "/docs/explanation/sitemaps/"
+			}
+		]
+	},
+	{
+		"title": "How-To Guides",
+		"route": "/docs/how-to/",
+		"children": [
+			{
+				"title": "Install Toolkit Plugins via Composer",
+				"route": "/docs/how-to/install-toolkit-plugins/"
+			},
+			{
+				"title": "Automatic Persisted Queries in Next.js",
+				"route": "/docs/how-to/nextjs-pages-router/enable-apq/"
+			}
+		]
+	}
+]
\ No newline at end of file