feat: add interactive 5-Act real-time architecture story mode to landing page

Author: anshullakra007

README.md

@@ -5,7 +5,8 @@ A high-performance, distributed code execution engine that securely compiles and
 > **[Watch the 2-Minute Architecture & Performance Demo](https://loom.com/)**  
 > *(Achieving 130+ req/sec throughput with 0% CPU starvation using a Bounded Async Queue and Pre-warmed Container Pool).*
 
-🚀 **Live Server Address:** [https://code-engine-api-wicb.onrender.com](https://code-engine-api-wicb.onrender.com)
+🚀 **Live Server Address:** [https://code-engine-api-wicb.onrender.com](https://code-engine-api-wicb.onrender.com)  
+📖 **Interactive Story Mode:** Built-in interactive 5-Act real-time architecture walkthrough on the landing page!
 
 ![CodeEngine Demo](./demo.gif)
 

client/src/App.css

@@ -177,6 +177,47 @@ body {
   cursor: not-allowed;
 }
 
+.story-mode-btn {
+  background: linear-gradient(135deg, rgba(88, 166, 255, 0.15) 0%, rgba(163, 113, 247, 0.15) 100%);
+  border: 1px solid rgba(88, 166, 255, 0.35);
+  color: #58a6ff;
+  padding: 6px 14px;
+  border-radius: var(--btn-radius);
+  font-family: 'Inter', sans-serif;
+  font-weight: 600;
+  font-size: 0.85rem;
+  cursor: pointer;
+  transition: all 0.25s ease;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  box-shadow: 0 0 16px rgba(88, 166, 255, 0.12);
+}
+
+.story-mode-btn:hover {
+  background: linear-gradient(135deg, rgba(88, 166, 255, 0.25) 0%, rgba(163, 113, 247, 0.25) 100%);
+  border-color: #58a6ff;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 18px rgba(88, 166, 255, 0.25);
+}
+
+.story-badge-new {
+  background: linear-gradient(90deg, #58a6ff 0%, #a371f7 100%);
+  color: #ffffff;
+  font-size: 0.65rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  padding: 2px 6px;
+  border-radius: 4px;
+  letter-spacing: 0.05em;
+  animation: badgeGlow 2s infinite alternate;
+}
+
+@keyframes badgeGlow {
+  0% { box-shadow: 0 0 4px rgba(88, 166, 255, 0.4); }
+  100% { box-shadow: 0 0 10px rgba(163, 113, 247, 0.8); }
+}
+
 .run-btn .spinner {
   animation: spin 1s linear infinite;
 }

client/src/App.jsx

@@ -5,6 +5,7 @@ import remarkGfm from 'remark-gfm';
 import { Prism as SyntaxHighlighter } from 'react-syntax-highlighter';
 import { vscDarkPlus } from 'react-syntax-highlighter/dist/esm/styles/prism';
 import './App.css';
+import ArchitectureStory, { LandingStoryBanner } from './components/ArchitectureStory';
 
 const BOILERPLATES = {
   cpp: `#include <iostream>
@@ -90,6 +91,7 @@ function App() {
   const [isLoading, setIsLoading] = useState(false);
   const [fontSize, setFontSize] = useState(parseInt(localStorage.getItem('fontSize'), 10) || 14);
   const [cursor, setCursor] = useState({ line: 1, col: 1 });
+  const [isStoryOpen, setIsStoryOpen] = useState(false);
 
   // Chatbot State
   const [isChatOpen, setIsChatOpen] = useState(false);
@@ -266,11 +268,16 @@ function App() {
               <><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><polygon points="5 3 19 12 5 21 5 3"/></svg> Run</>
             )}
           </button>
-          
-
+          <button className="story-mode-btn" onClick={() => setIsStoryOpen(true)} title="Explore How CodeEngine Works in Real Time">
+            <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.2"><path d="M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2z"/><path d="M22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z"/></svg>
+            <span>How It Works</span>
+            <span className="story-badge-new">Story</span>
+          </button>
         </div>
       </header>
 
+      <LandingStoryBanner onOpenStory={() => setIsStoryOpen(true)} />
+
       <div className={`workspace ${isChatOpen ? 'chat-open' : ''}`}>
         <div className="editor-panel">
           <div className="panel-header-row">
@@ -455,6 +462,12 @@ function App() {
         <span>Spaces: 4</span>
         {stats && <span>Network: {formatMs(stats.clientRoundTripMs)}</span>}
       </footer>
+
+      <ArchitectureStory
+        isOpen={isStoryOpen}
+        onClose={() => setIsStoryOpen(false)}
+        selectedLanguage={language}
+      />
     </div>
   );
 }