From f96a5358ddfcd742aab97abd56c244391b0be21d Mon Sep 17 00:00:00 2001
From: Robert Wagner <rwwagner90@gmail.com>
Date: Sat, 27 Dec 2025 11:22:06 -0500
Subject: [PATCH 1/4] Redirect to root when starting demo

---
 docs-src/src/content/docs/guides/install.mdx |  4 +--
 landing/src/components/Header.astro          | 31 ++++++++++++++++++++
 landing/src/pages/index.astro                | 17 ++++++++---
 shepherd.js/dummy/index.html                 |  2 +-
 shepherd.js/package.json                     |  2 +-
 5 files changed, 48 insertions(+), 8 deletions(-)

diff --git a/docs-src/src/content/docs/guides/install.mdx b/docs-src/src/content/docs/guides/install.mdx
index 5d53aa106..82b2835f9 100644
--- a/docs-src/src/content/docs/guides/install.mdx
+++ b/docs-src/src/content/docs/guides/install.mdx
@@ -50,11 +50,11 @@ with:
 ```html
 <script
   type="module"
-  src="https://cdn.jsdelivr.net/npm/shepherd.js@15.0.0/dist/js/shepherd.mjs"
+  src="https://cdn.jsdelivr.net/npm/shepherd.js@17.0.0/dist/js/shepherd.mjs"
 ></script>
 <link
   rel="stylesheet"
-  href="https://cdn.jsdelivr.net/npm/shepherd.js@15.0.0/dist/css/shepherd.css"
+  href="https://cdn.jsdelivr.net/npm/shepherd.js@17.0.0/dist/css/shepherd.css"
 />
 ```
 
diff --git a/landing/src/components/Header.astro b/landing/src/components/Header.astro
index 13f06feba..6cf3c343a 100644
--- a/landing/src/components/Header.astro
+++ b/landing/src/components/Header.astro
@@ -162,3 +162,34 @@ const { isHome } = Astro.props;
     }
   </div>
 </header>
+
+<script>
+  // Handle demo button click - redirect to home if not already there
+  function setupDemoButton() {
+    const showTourBtn = document.querySelector('#showTour');
+    
+    if (!showTourBtn) return;
+    
+    // Remove any existing listeners
+    const newBtn = showTourBtn.cloneNode(true) as HTMLElement;
+    showTourBtn.parentNode?.replaceChild(newBtn, showTourBtn);
+    
+    newBtn.addEventListener('click', () => {
+      // Check if we're on the home page
+      if (window.location.pathname !== '/') {
+        // Store flag to start tour after navigation
+        sessionStorage.setItem('startTourOnLoad', 'true');
+        window.location.href = '/';
+      } else {
+        // We're already on home page, dispatch event to start tour
+        window.dispatchEvent(new CustomEvent('startTour'));
+      }
+    });
+  }
+  
+  // Run on initial load
+  document.addEventListener('DOMContentLoaded', setupDemoButton);
+  
+  // Run on Astro page transitions
+  document.addEventListener('astro:page-load', setupDemoButton);
+</script>
diff --git a/landing/src/pages/index.astro b/landing/src/pages/index.astro
index efeb468e9..c3eb21188 100644
--- a/landing/src/pages/index.astro
+++ b/landing/src/pages/index.astro
@@ -24,7 +24,7 @@ import MainPage from '@layouts/MainPage.astro';
         <Code
           code={`
 	<link rel="stylesheet" href="shepherd.js/dist/css/shepherd.css"/>
-	<script type="module" src="shepherd.js/dist/shepherd.mjs"></script>
+	<script type="module" src="shepherd.js/dist/js/shepherd.mjs"></script>
   
 `}
           lang="js"
@@ -94,9 +94,16 @@ import MainPage from '@layouts/MainPage.astro';
       // wait for shepherd to be ready
       setTimeout(function () {
         const shepherd = setupShepherd();
-        const startBtn = document.querySelector('#showTour');
-
-        startBtn?.addEventListener('click', () => shepherd.start());
+        
+        // Check if we should auto-start the tour (after redirect from another page)
+        const shouldStartTour = sessionStorage.getItem('startTourOnLoad');
+        if (shouldStartTour) {
+          sessionStorage.removeItem('startTourOnLoad');
+          shepherd.start();
+        }
+        
+        // Listen for custom event from Demo button when already on home page
+        window.addEventListener('startTour', () => shepherd.start());
       }, 400);
     }
 
@@ -297,6 +304,8 @@ import MainPage from '@layouts/MainPage.astro';
 
     function ready() {
       document.addEventListener('DOMContentLoaded', init);
+      // Also listen for Astro page transitions
+      document.addEventListener('astro:page-load', init);
     }
 
     ready();
diff --git a/shepherd.js/dummy/index.html b/shepherd.js/dummy/index.html
index 3a28c2235..ce3ac30a0 100644
--- a/shepherd.js/dummy/index.html
+++ b/shepherd.js/dummy/index.html
@@ -122,7 +122,7 @@ <h3>Example</h3>
 
     <!-- Shepherd -->
     <script type="module">
-      import Shepherd from '../dist/esm/shepherd.mjs';
+      import Shepherd from '../dist/js/shepherd.mjs';
 
       window.Shepherd = Shepherd;
 
diff --git a/shepherd.js/package.json b/shepherd.js/package.json
index 072c8d999..3fb2b2526 100644
--- a/shepherd.js/package.json
+++ b/shepherd.js/package.json
@@ -18,7 +18,7 @@
     "Robbie Wagner <rwwagner90@gmail.com>",
     "Chuck Carpenter <chuck@shipshape.io>"
   ],
-  "main": "./dist/cjs/shepherd.cjs",
+  "main": "./dist/cjs/shepherd.mjs",
   "module": "./dist/js/shepherd.mjs",
   "exports": {
     ".": {

From d3041fd91a96209efc7879dcfcad0b1700f8cca2 Mon Sep 17 00:00:00 2001
From: Robert Wagner <rwwagner90@gmail.com>
Date: Sat, 27 Dec 2025 11:27:07 -0500
Subject: [PATCH 2/4] Update package.json

---
 shepherd.js/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/shepherd.js/package.json b/shepherd.js/package.json
index 3fb2b2526..efa368995 100644
--- a/shepherd.js/package.json
+++ b/shepherd.js/package.json
@@ -18,7 +18,7 @@
     "Robbie Wagner <rwwagner90@gmail.com>",
     "Chuck Carpenter <chuck@shipshape.io>"
   ],
-  "main": "./dist/cjs/shepherd.mjs",
+  "main": "./dist/js/shepherd.mjs",
   "module": "./dist/js/shepherd.mjs",
   "exports": {
     ".": {

From 52778257b8a46395e7da1e308aa7fc553baae10e Mon Sep 17 00:00:00 2001
From: Robert Wagner <rwwagner90@gmail.com>
Date: Sat, 27 Dec 2025 11:34:20 -0500
Subject: [PATCH 3/4] Update index.astro

---
 landing/src/pages/index.astro | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/landing/src/pages/index.astro b/landing/src/pages/index.astro
index c3eb21188..5f4ff1842 100644
--- a/landing/src/pages/index.astro
+++ b/landing/src/pages/index.astro
@@ -102,8 +102,17 @@ import MainPage from '@layouts/MainPage.astro';
           shepherd.start();
         }
         
+        // Clean up previous listener if it exists
+        if ((window as any).__startTourAbortController) {
+          (window as any).__startTourAbortController.abort();
+        }
+        
+        // Create new AbortController for this listener
+        const controller = new AbortController();
+        (window as any).__startTourAbortController = controller;
+        
         // Listen for custom event from Demo button when already on home page
-        window.addEventListener('startTour', () => shepherd.start());
+        window.addEventListener('startTour', () => shepherd.start(), { signal: controller.signal });
       }, 400);
     }
 

From 5b0d5b833a540223b11ee2d079d0b7c9abd6ef57 Mon Sep 17 00:00:00 2001
From: Robert Wagner <rwwagner90@gmail.com>
Date: Sat, 27 Dec 2025 12:41:39 -0500
Subject: [PATCH 4/4] Update index.astro

---
 landing/src/pages/index.astro | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/landing/src/pages/index.astro b/landing/src/pages/index.astro
index 5f4ff1842..914d43e4c 100644
--- a/landing/src/pages/index.astro
+++ b/landing/src/pages/index.astro
@@ -312,8 +312,7 @@ import MainPage from '@layouts/MainPage.astro';
     }
 
     function ready() {
-      document.addEventListener('DOMContentLoaded', init);
-      // Also listen for Astro page transitions
+      // Only listen for astro:page-load which fires on both initial load and transitions
       document.addEventListener('astro:page-load', init);
     }