diff --git a/docs/api.md b/docs/api.md
index 51728722..f90c626e 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -6,7 +6,7 @@ The `InteractiveMap` object represents an instance of an InteractiveMap on your
You create an instance of a InteractiveMap by specifying a `container` and `options` in the `constructor`. An InteractiveMap is then initialized on the page and returns an instance of an InteractiveMap object.
-## Getting started
+## Getting started
For installation and setup instructions, see the [Getting started](./getting-started.md) guide.
diff --git a/docs/architecture.md b/docs/architecture.md
index 78d50ece..4dcb9254 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -7,7 +7,9 @@ At its core, it provides:
* A plugin system for extending functionality
* An abstraction layer over multiple mapping engines
-The system is designed so that **the core controls rendering and layout**, while **plugins declaratively contribute behaviour and UI.** ---
+The system is designed so that **the core controls rendering and layout**, while **plugins declaratively contribute behaviour and UI.**
+
+---
## High-level Structure
diff --git a/docs/demo.mdx b/docs/examples.mdx
similarity index 99%
rename from docs/demo.mdx
rename to docs/examples.mdx
index ff8ef2d7..c8816fae 100644
--- a/docs/demo.mdx
+++ b/docs/examples.mdx
@@ -1,7 +1,7 @@
import DemoMapInline from '../demo/DemoMapInline.js'
import DemoMapButton from '../demo/DemoMapButton.js'
-# Demo
+# Examples
See [Getting started](getting-started) for installation and full configuration options.
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 397ed981..6d7b4447 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -111,6 +111,4 @@ Each plugin distributes its own CSS. Import or copy only the CSS for the plugins
Following installation the InteractiveMap plugin will be added to your prototype. You can now create pages with a map, and configure for specific use cases.
-See [Install and use plugins](https://prototype-kit.service.gov.uk/docs/install-and-use-plugins).
-
-See [Configuring InteractiveMap in a GOVUK Prototype](./govuk-prototype.md).
+See [GOV.UK Prototype Kit - Install and use plugins](https://prototype-kit.service.gov.uk/docs/install-and-use-plugins).
diff --git a/docs/govuk-prototype.md b/docs/govuk-prototype.md
deleted file mode 100644
index cf4351a4..00000000
--- a/docs/govuk-prototype.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# GOV.UK Prototype Kit
-
-This guide explains how to use the Interactive Map component in a GOV.UK Prototype Kit project.
-
-## Installation
-
-Install the package in your prototype kit project:
-
-```shell
-npm install @defra/interactive-map
-```
-
-The InteractiveMap plugin will be automatically added to your prototype.
-
-## Usage
-
-For detailed usage instructions, see the [GOV.UK Prototype Kit documentation](https://prototype-kit.service.gov.uk/docs/install-and-use-plugins).
-
-## Next Steps
-
-- [Getting Started](./getting-started.md) - Learn the basics
-- [API Reference](./api.md) - Explore the full API
-- [Plugins](./plugins.md) - Extend functionality
diff --git a/docs/index.md b/docs/index.md
deleted file mode 100644
index adcb46a3..00000000
--- a/docs/index.md
+++ /dev/null
@@ -1,19 +0,0 @@
-## What's Inside
-
-- **[Getting Started](getting-started)** - Installation and basic usage
-- **[API Reference](api)** - Complete API documentation
-- **[Plugins](plugins)** - Extend functionality with plugins
-- **[Architecture](architecture)** - Learn about the design and structure
-- **[GOV.UK Prototype](govuk-prototype)** - Use with GOV.UK Prototype Kit
-
-## Features
-
-- β Accessible and keyboard navigable
-- πΊοΈ Multiple map provider support (MapLibre, ESRI)
-- π Extensible plugin system
-- π¨ Customizable styling and behaviors
-- π± Responsive design
-
-## Support
-
-For issues and feature requests, visit our [GitHub repository](https://github.com/DEFRA/interactive-map).
diff --git a/docs/index.mdx b/docs/index.mdx
new file mode 100644
index 00000000..29888e28
--- /dev/null
+++ b/docs/index.mdx
@@ -0,0 +1,42 @@
+import Link from '@docusaurus/Link';
+
+
+
+
+
+
Inclusive and accessible
+
Designed for everyone, including people using touch, keyboard navigation and assistive technologies. Compliant with WCAG standards for public-facing services.
+
+
+
Consistent with GOV.UK
+
Built with the GOV.UK Design System, providing a predictable mapping interface and ensuring a consistent experience across all government services.
+
+
+
Open source and flexible
+
Open source and free from proprietary dependencies. Configurable and extensible, with plugin support and compatibility with multiple mapping libraries.
+
+
+
+
+
+
+
+
+
Documentation
+
Getting Started
+
How to install and configure the component. Covers setup, initialisation options, and integration with common build tools.
+
Examples
+
Live interactive demos showing the component in action, including inline maps, button-triggered maps, and various configuration options.
+
API Reference
+
Full reference for all configuration options, events, methods, and plugin interfaces exposed by the component.
+
Plugins
+
Extend the component with built-in plugins for search, map styles, drawing tools, and more. Includes a guide to building your own.
+
Architecture
+
Technical overview of how the component is structured, including the plugin system, rendering pipeline, and integration patterns.