diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..e6461a7
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,18 @@
+
+
+[Wyndex Architecture](wyndex_architecture.pdf)
+
+
+```mermaid
+erDiagram
+    wyndex-multi-hop ||--|| wyndex-factory : configured-with
+    wyndex-multi-hop ||--|{ wyndex-pair : execute-swap
+    wyndex-pair ||--|| cw-20-A : configured-with
+    wyndex-pair ||--|| cw-20-B : configured-with
+    wyndex-pair ||--|| wyndex-factory : configured-with
+    wyndex-factory ||--o{ wyndex-pair  : instantiate
+    wyndex-pair ||--|| cw-20-LP : instantiates
+    wyndex-pair ||--o| wyndex-stake : configured-with
+    wyndex-pair ||--o| wyndex-stake : configured-with
+    owner ||--|| wyndex-factory : execute-create-pair
+```
\ No newline at end of file