diff --git a/docs/index.html b/docs/index.html
index 4827024bdc..264783e12f 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -128,6 +128,8 @@
   <script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
   <script src="//unpkg.com/docsify/lib/plugins/search.min.js"></script>
   <script src="//unpkg.com/docsify/lib/plugins/emoji.min.js"></script>
+  <script src="//unpkg.com/mermaid/dist/mermaid.js"></script>
+  <script src="//unpkg.com/docsify-mermaid@latest/dist/docsify-mermaid.js"></script>
   <script src="//unpkg.com/docsify-tabs@1"></script>
   <script src="//unpkg.com/docsify-copy-code@2"></script>
   <script src="//unpkg.com/docsify-toc@1.1.0/dist/toc.js"></script>
@@ -143,5 +145,6 @@
       navigator.serviceWorker.register('sw.js')
     }
   </script>
+  <script>mermaid.initialize({ startOnLoad: true });</script>
 </body>
 </html>
diff --git a/docs/xap.md b/docs/xap.md
index 340c42bca8..f83af10618 100644
--- a/docs/xap.md
+++ b/docs/xap.md
@@ -4,7 +4,13 @@ XAP (“extensible application protocol”) API intends to provide access to var
 
 ## Overview
 
-TODO
+```mermaid
+%%{init: {'themeVariables': { 'fontSize': '24px'}}}%%
+flowchart LR
+    dev[QMK Device] <-- XAP --> host[Host Computer]
+```
+
+The intention is to provide access to QMK subsystems through a versioned and documented protocol. 
 
 ## Protocol Reference