From 2f2f8c77960e910a1b36a7ebb3c9e88cd5ddc638 Mon Sep 17 00:00:00 2001
From: BobAi <brett@foxsoftwaresolutions.com.au>
Date: Tue, 12 Aug 2025 20:13:06 +1000
Subject: [PATCH] Fix README: remove mermaid syntax error and add demo GIFs

- Fixed mermaid parse error by removing quotes from node labels
- Added two demo GIFs to showcase the system in action
- Removed broken icon reference
- README now displays perfectly with engaging visuals
---
 README.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 8eaf6cf..01b94db 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,11 @@
 > **A lightweight, educational RAG system that actually works**  
 > *Built for beginners who want results, and developers who want to understand how RAG really works*
 
-![FSS-Mini-RAG Icon](assets/icon.png)
+## Demo
+
+![FSS-Mini-RAG Demo](recordings/fss-mini-rag-demo-20250812_161410.gif)
+
+*See it in action: index a project and search semantically in seconds*
 
 ## How It Works
 
@@ -14,7 +18,7 @@ graph LR
     Chunks --> Embeddings[🧠 Semantic Vectors]
     Embeddings --> Database[(💾 Vector DB)]
     
-    Query[❓ "user auth"] --> Search[🎯 Hybrid Search]
+    Query[❓ user auth] --> Search[🎯 Hybrid Search]
     Database --> Search
     Search --> Results[📋 Ranked Results]
     
@@ -108,6 +112,10 @@ That's it. No external dependencies, no configuration required, no PhD in comput
 ./rag-mini status ~/new-project            # Check index health
 ```
 
+![FSS-Mini-RAG Search Demo](recordings/fss-mini-rag-demo-20250812_160725.gif)
+
+*Advanced usage: semantic search with synthesis and exploration modes*
+
 ## Installation Options
 
 ### Recommended: Full Installation