dwootton · ryanyen2 · Feb 1, 2026 · Feb 1, 2026 · Feb 1, 2026
diff --git a/.gitignore b/.gitignore
@@ -59,6 +59,7 @@ pip-wheel-metadata/
 # Generated widgets
 *.html
 !doc/index.html
+!doc/public/404.html
 output/
 
 # Doc build output

diff --git a/doc/index.html b/doc/index.html
@@ -5,6 +5,34 @@
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>Vibe Widgets Docs</title>
+
+  <!-- Single Page Apps for GitHub Pages -->
+  <!-- https://github.com/rafrex/spa-github-pages -->
+  <script type="text/javascript">
+    // This script checks to see if a redirect is present in the query string
+    // and converts it back into the correct url and adds it to the
+    // browser's history using window.history.replaceState(...),
+    // which won't cause the browser to attempt to load the new url.
+    // When the single page app is loaded further down in this file,
+    // the correct url will be waiting in the browser's history for
+    // the single page app to route accordingly.
+    (function (l) {
+      if (l.search) {
+        var q = {};
+        l.search.slice(1).split('&').forEach(function (v) {
+          var a = v.split('=');
+          q[a[0]] = a.slice(1).join('=').replace(/~and~/g, '&');
+        });
+        if (q.p !== undefined) {
+          window.history.replaceState(null, null,
+            l.pathname.slice(0, -1) + (q.p || '') +
+            (q.q ? ('?' + q.q) : '') +
+            l.hash
+          );
+        }
+      }
+    }(window.location))
+  </script>
 </head>
 
 <body>

diff --git a/doc/public/404.html b/doc/public/404.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <meta charset="utf-8">
+    <title>Vibe Widgets - Redirecting...</title>
+    <script type="text/javascript">
+        // Single Page Apps for GitHub Pages
+        // https://github.com/rafrex/spa-github-pages
+        // Copyright (c) 2016 Rafael Pedicini, licensed under the MIT License
+        // ----------------------------------------------------------------------
+        // This script takes the current url and converts the path and query
+        // string into just a query string, and then redirects the browser
+        // to the new url with only a query string and hash fragment,
+        // e.g. http://www.foo.tld/one/two?a=b&c=d#qwe, becomes
+        // http://www.foo.tld/?p=/one/two&q=a=b~and~c=d#qwe
+        // Note: this 404.html file must be at least 512 bytes for it to work
+        // with Internet Explorer (it is currently > 512 bytes)
+
+        // If you're creating a Project Pages site and NOT using a custom domain,
+        // then set segmentCount to 1 (enterprise users may need to set it to > 1).
+        // This way the code will only replace the route part of the path, and not
+        // the real directory in which the app resides, for example:
+        // https://username.github.io/repo-name/one/two?a=b&c=d#qwe becomes
+        // https://username.github.io/repo-name/?p=/one/two&q=a=b~and~c=d#qwe
+        // Otherwise, leave segmentCount as 0.
+        var segmentCount = 0;
+
+        var l = window.location;
+        l.replace(
+            l.protocol + '//' + l.hostname + (l.port ? ':' + l.port : '') +
+            l.pathname.split('/').slice(0, 1 + segmentCount).join('/') + '/?p=/' +
+            l.pathname.slice(1).split('/').slice(segmentCount).join('/').replace(/&/g, '~and~') +
+            (l.search ? '&q=' + l.search.slice(1).replace(/&/g, '~and~') : '') +
+            l.hash
+        );
+    </script>
+</head>
+
+<body>
+    <p>Redirecting...</p>
+</body>
+
+</html>
diff --git a/doc/public/docs-export.json b/doc/public/docs-export.json
diff --git a/doc/public/docs.txt b/doc/public/docs.txt
diff --git a/doc/public/llms-full.txt b/doc/public/llms-full.txt
@@ -14,13 +14,8 @@ Pages:
 - /docs/edit: Edit - Iterate on generated widgets using code or the UI.
 - /docs/audit: Audit - Review widget code and behavior for risks, usability issues, and design gaps.
 - /docs/reactivity: Reactivity - Connect widgets with reactive inputs and outputs.
-- /docs/data-sources: Data Sources - Supported inputs and loaders.
-- /docs/composability: Composability - Compose widgets using components and outputs.
+- /docs/composability: Load & Save - Persist widgets to disk and reload them later.
 - /docs/theming: Theming - Style widgets with natural-language design specs.
-- /docs/examples/cross-widget: Cross-Widget Interactions - Interactive notebook example for cross-widget state sharing.
-- /docs/examples/tictactoe: Tic-Tac-Toe AI - Interactive notebook example for game logic and UI.
-- /docs/examples/pdf-web: PDF & Web Data Extraction - Interactive notebook example for scraping and parsing.
-- /docs/examples/edit: Widget Editing - Interactive notebook example for editing workflows.
 - /docs/widgetarium: Widgetarium - The ecosystem of widgets and templates.
 
 Docs export:

diff --git a/doc/public/llms.txt b/doc/public/llms.txt
@@ -15,10 +15,7 @@ Security model:
 - Widgets execute LLM-generated JavaScript in the notebook frontend. Treat outputs as untrusted and verify results with audits and your own checks.
 
 Examples:
-- /docs/examples/cross-widget
-- /docs/examples/tictactoe
-- /docs/examples/pdf-web
-- /docs/examples/edit
+- /gallery
 
 Docs export:
 - /docs.txt

diff --git a/doc/public/sitemap.xml b/doc/public/sitemap.xml
@@ -1,2 +1,2 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://vibewidget.dev/</loc></url><url><loc>https://vibewidget.dev/docs</loc></url><url><loc>https://vibewidget.dev/gallery</loc></url><url><loc>https://vibewidget.dev/docs/config</loc></url><url><loc>https://vibewidget.dev/docs/create</loc></url><url><loc>https://vibewidget.dev/docs/edit</loc></url><url><loc>https://vibewidget.dev/docs/audit</loc></url><url><loc>https://vibewidget.dev/docs/reactivity</loc></url><url><loc>https://vibewidget.dev/docs/data-sources</loc></url><url><loc>https://vibewidget.dev/docs/composability</loc></url><url><loc>https://vibewidget.dev/docs/theming</loc></url><url><loc>https://vibewidget.dev/docs/examples/cross-widget</loc></url><url><loc>https://vibewidget.dev/docs/examples/tictactoe</loc></url><url><loc>https://vibewidget.dev/docs/examples/pdf-web</loc></url><url><loc>https://vibewidget.dev/docs/examples/edit</loc></url><url><loc>https://vibewidget.dev/docs/widgetarium</loc></url></urlset>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://vibewidget.dev/</loc></url><url><loc>https://vibewidget.dev/docs</loc></url><url><loc>https://vibewidget.dev/gallery</loc></url><url><loc>https://vibewidget.dev/docs/config</loc></url><url><loc>https://vibewidget.dev/docs/create</loc></url><url><loc>https://vibewidget.dev/docs/edit</loc></url><url><loc>https://vibewidget.dev/docs/audit</loc></url><url><loc>https://vibewidget.dev/docs/reactivity</loc></url><url><loc>https://vibewidget.dev/docs/composability</loc></url><url><loc>https://vibewidget.dev/docs/theming</loc></url><url><loc>https://vibewidget.dev/docs/widgetarium</loc></url></urlset>