diff --git a/README.md b/README.md
index b131959..3e75a2a 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,8 @@ Atlas is a local architecture intelligence engine for NestJS projects, developed
 typed graph of the application, highlights architectural risks, and provides a
 browser viewer and MCP tools for exploring the result.
 
+![Atlas architecture explorer demo](https://raw.githubusercontent.com/Digital-Threads/atlas/main/docs/atlas-demo.gif)
+
 Atlas helps answer practical questions about an unfamiliar backend:
 
 - Which route calls which controller, service, and database table?
diff --git a/docs/atlas-demo.gif b/docs/atlas-demo.gif
new file mode 100644
index 0000000..97e5f7d
Binary files /dev/null and b/docs/atlas-demo.gif differ