diff --git a/README.md b/README.md
index 4898b65f..b1bf6937 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,25 @@
-# DECNET
+
-A honeypot deception network framework. Spin up a fleet of fake machines — called **deckies** — that appear as real, heterogeneous LAN hosts to anyone scanning the network. Each decky gets its own MAC address, IP, hostname, services, OS fingerprint, and log pipeline. Attackers probe the network, DECNET traps every interaction, and a full intelligence stack profiles, clusters, and attributes their behaviour.
+

+
+**A honeypot deception network framework.**
+
+Spin up a fleet of fake machines — **deckies** — that look like real, heterogeneous LAN hosts to anyone scanning the network. Each decky gets its own MAC, IP, hostname, services, OS fingerprint, and log pipeline. Attackers probe; DECNET traps every interaction; a full intelligence stack profiles, clusters, and attributes their behaviour.
+
+
+
+[](https://pypi.org/project/decnet/)
+[](https://pypi.org/project/decnet/)
+[](LICENSE)
+[](https://github.com/astral-sh/ruff)
+[](#requirements)
+
+[Quick Start](#quick-start) · [Architecture](#architecture) · [REST API](#rest-api--web-dashboard) · [MazeNET](#mazenet-topology) · [Support](https://ko-fi.com/C0C31YDLB5)
[](https://ko-fi.com/C0C31YDLB5)
+
+
---
## Table of Contents
diff --git a/assets/decnet-logo.svg b/assets/decnet-logo.svg
new file mode 100644
index 00000000..b1befbd3
--- /dev/null
+++ b/assets/decnet-logo.svg
@@ -0,0 +1,6 @@
+