update readme

README.md

@@ -62,9 +62,31 @@ The demo highlights the system's ability to handle complex, multi-turn conversat
 
 ![](https://raw.githubusercontent.com/awslabs/multi-agent-orchestrator/main/img/demo-app.gif?raw=true)
 
-## 🚀 Getting Started
+To quickly get a feel for the Multi-Agent Orchestrator, check out our [Demo App](https://awslabs.github.io/multi-agent-orchestrator/cookbook/examples/chat-demo-app/). Additional code examples are available in both the documentation and the `examples` folder.
+
+## 🎯 Examples & Quick Start
+
+Get hands-on experience with the Multi-Agent Orchestrator through our diverse set of examples:
+
+- **Ready-to-run Scripts**: Start locally with our collection of standalone scripts in both Python and TypeScript.
+- **Demo Applications**: 
+  - [Chat Demo App](https://awslabs.github.io/multi-agent-orchestrator/cookbook/examples/chat-demo-app/): 
+    - Explore multiple specialized agents handling various domains like travel, weather, math, and health
+  - [E-commerce Support Simulator](https://awslabs.github.io/multi-agent-orchestrator/cookbook/examples/ecommerce-support-simulator/): Experience AI-powered customer support with:
+    - Automated response generation for common queries
+    - Intelligent routing of complex issues to human support
+    - Real-time chat and email-style communication
+    - Human-in-the-loop interactions for complex cases
+- **Sample Projects**: Explore our example implementations in the `examples` folder:
+  - [`chat-demo-app`](https://github.com/awslabs/multi-agent-orchestrator/tree/main/examples/chat-demo-app): Web-based chat interface with multiple specialized agents
+  - [`ecommerce-support-simulator`](https://github.com/awslabs/multi-agent-orchestrator/tree/main/examples/ecommerce-support-simulator): AI-powered customer support system
+  - [`chat-chainlit-app`](https://github.com/awslabs/multi-agent-orchestrator/tree/main/examples/chat-chainlit-app): Chat application built with Chainlit
+  - [`fast-api-streaming`](https://github.com/awslabs/multi-agent-orchestrator/tree/main/examples/fast-api-streaming): FastAPI implementation with streaming support
+
+All examples are available in both Python and TypeScript implementations. Check out our [documentation](https://awslabs.github.io/multi-agent-orchestrator/) for comprehensive guides on setting up and using the Multi-Agent Orchestrator!
+
+[Previous sections remain the same...]
 
-Check out our [documentation](https://awslabs.github.io/multi-agent-orchestrator/) for comprehensive guides on setting up and using the Multi-Agent Orchestrator!
 
 ## 🌟 Use cases and implementations
 

docs/src/content/docs/cookbook/examples/chat-demo-app.md

@@ -5,7 +5,10 @@ description: How to deploy the demo chat web application for the Multi-Agent Orc
 
 ## 📘 Overview
 
-The Multi-Agent Orchestrator System includes a demo chat web application that showcases the capabilities of the system. This application is built using AWS CDK (Cloud Development Kit) and can be easily deployed to your AWS account.
+
+The Multi-Agent Orchestrator Framework includes a demo chat web application that showcases the capabilities of the system. This application is built using AWS CDK (Cloud Development Kit) and can be easily deployed to your AWS account.
+
+<img src="/multi-agent-orchestrator/chat-demo-app.png">
 
 In the screen recording below, we demonstrate an extended version of the demo app that uses 6 specialized agents:
 - **Travel Agent**: Powered by an Amazon Lex Bot

docs/src/content/docs/cookbook/examples/ecommerce-support-simulator.md

@@ -75,7 +75,7 @@ A demonstration of how AI agents and human support can work together in an e-com
 - Production-ready AWS architecture
 - Mock data for realistic scenarios
 
-## 🏗️ System Architecture
+## 🏗️ Architecture
 
 ### Agent Architecture
 

examples/chat-demo-app/README.md

@@ -1,7 +1,7 @@
 ## 🎮 Demo Application
 
 ### Overview
-The demo showcases the versatility of the Multi-Agent Orchestrator System through an interactive chat interface. Watch how the system seamlessly handles diverse queries using specialized agents:
+The demo showcases the versatility of the Multi-Agent Orchestrator System through an interactive chat interface.
 
 ![Demo Application](./img/chat-demo-app.png)