From 87592cb55452cca6b8ecf852d35525d45139f2e2 Mon Sep 17 00:00:00 2001
From: Tiago Rangel <tr@tiagorangel.com>
Date: Tue, 14 Jan 2025 16:07:02 +0000
Subject: [PATCH] Switch demo URL to hosted, docs improvements

---
 docs/.vitepress/config.mjs |  4 ++--
 docs/guide/demo.md         | 21 ---------------------
 docs/guide/index.md        |  5 +++--
 docs/index.md              |  2 +-
 4 files changed, 6 insertions(+), 26 deletions(-)
 delete mode 100644 docs/guide/demo.md

diff --git a/docs/.vitepress/config.mjs b/docs/.vitepress/config.mjs
index f01add9..356ae83 100644
--- a/docs/.vitepress/config.mjs
+++ b/docs/.vitepress/config.mjs
@@ -27,14 +27,14 @@ export default defineConfig({
     nav: [
       { text: "Home", link: "/" },
       { text: "Docs", link: "/guide" },
-      { text: "Demo", link: "/guide/demo.md" },
+      { text: "Demo", link: "https://cap-starter.glitch.me/" },
     ],
 
     sidebar: [
       { text: "Quickstart", link: "/guide/index.md" },
       { text: "Effectiveness", link: "/guide/effectiveness.md" },
       { text: "Floating mode", link: "/guide/floating.md" },
-      { text: "Demo", link: "/guide/demo.md" },
+      { text: "Demo", link: "https://cap-starter.glitch.me/" },
     ],
 
     socialLinks: [
diff --git a/docs/guide/demo.md b/docs/guide/demo.md
deleted file mode 100644
index 5f4c419..0000000
--- a/docs/guide/demo.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# Demo
-
-**Note:** The docs demo might not work. Please download and use the code from the [demo folder in the repo](https://github.com/tiagorangel1/cap/tree/main/demo) instead — it includes all of the setup needed with an Express.js server.
-
-### Normal button:
-
-<Demo />
-
-```html
-<cap-widget onsolve="alert(`Verification token: ${event.detail.token}`)"></cap-widget>
-```
-
-### Floating button:
-
-<Demo-floating />
-
-```html
-<cap-widget id="floating" onsolve="alert(`Verification token: ${event.detail.token}`)"></cap-widget>
-
-<button data-cap-floating="#floating" data-cap-floating-offset="8" data-cap-floating-position="bottom" class="demo-button">Trigger Floating</button>
-```
\ No newline at end of file
diff --git a/docs/guide/index.md b/docs/guide/index.md
index 36fc14f..9bef5bc 100644
--- a/docs/guide/index.md
+++ b/docs/guide/index.md
@@ -46,8 +46,6 @@ widget.addEventListener("solve", function (e) {
 
 Alternatively, you can use `onsolve=""` directly within the widget or wrap the widget in a `<form></form>` (where Cap will automatically submit the token alongside other form data).
 
-
-
 ## Server-side
 Cap is fully self-hosted, so you'll need to start a server with the Cap API running at the same URL as specified in the `data-cap-api-endpoint` attribute. This is easy since we've already pre-made a library to help you generate and validate challenges for you.
 
@@ -57,6 +55,9 @@ Start by installing it using npm or bun:
 npm i @cap.js/server
 ```
 
+> [!NOTE]
+> It is recommended to use at least Node.js 14 or Bun 1.0.0. You might experience multiple issues on older versions of these runtimes.
+
 Now, you'll need to change your server code to add the routes that Cap needs to work. Here's an example with Express.js:
 
 ```js
diff --git a/docs/index.md b/docs/index.md
index 31248a9..817abe6 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -12,7 +12,7 @@ hero:
       link: /guide
     - theme: alt
       text: Demo
-      link: /guide/demo.md
+      link: https://cap-starter.glitch.me/
 
 features:
   - icon: ⚡️