From e497791e9ec0588c59ed5a98ba350b79970ee045 Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Tue, 14 Jul 2026 17:29:29 -0700
Subject: [PATCH 01/10] Updated mintlify pages

- Updated qawolf/quick-start.mdx
- Created snippets/try-for-free-form.mdx

Mintlify-Source: dashboard-editor
---
 qawolf/quick-start.mdx         |  8 ++---
 snippets/try-for-free-form.mdx | 65 ++++++++++++++++++++++++++++++++++
 2 files changed, 69 insertions(+), 4 deletions(-)
 create mode 100644 snippets/try-for-free-form.mdx

diff --git a/qawolf/quick-start.mdx b/qawolf/quick-start.mdx
index 2a55316..5840bae 100644
--- a/qawolf/quick-start.mdx
+++ b/qawolf/quick-start.mdx
@@ -11,12 +11,12 @@ description: "Connect your application, generate your first flow, and run your f
 <Check>
   Before getting started, make sure the following are set up:
 
-  - **You have access to a QA Wolf workspace.**\
-    Your team's QA Wolf administrator must invite you before you can log in and configure environments.
-  - **QA Wolf can access the application you want to test.**\
-    If your application is behind a firewall or private network, a **VPN or network allowlist** must be configured so QA Wolf infrastructure can reach it.
+  - **You have access to a QA Wolf workspace.**<br />Your team's QA Wolf administrator must invite you before you can log in and configure environments.
+  - **QA Wolf can access the application you want to test.**<br />If your application is behind a firewall or private network, a **VPN or network allowlist** must be configured so QA Wolf infrastructure can reach it.
 </Check>
 
+import TryForFreeForm from '/snippets/try-for-free-form.mdx';
+
 ## Step 1: Map your application
 
 Give the Mapping AI a target URL for your application (e.g., staging.wolfcorp.com) and tell it to map all the workflows.
diff --git a/snippets/try-for-free-form.mdx b/snippets/try-for-free-form.mdx
new file mode 100644
index 0000000..9f6dabc
--- /dev/null
+++ b/snippets/try-for-free-form.mdx
@@ -0,0 +1,65 @@
+{/*
+  Prototype: "Try for free" sign-up embed for Mintlify docs pages.
+  Mirrors the homepage component (Webflow form -> Zapier webhook -> redirect),
+  but adds a `source: "docs"` field so submissions can be told apart from
+  homepage submissions in whatever consumes the webhook downstream.
+
+  SETUP: this file goes in your Mintlify repo at /snippets/try-for-free-form.mdx
+  (Kirk wants this on 4 pages, so make it a snippet, not 4 copies).
+
+  Then on each target page (Welcome, Quick Start, Mapping AI, Automation AI),
+  add near the top:
+
+    import TryForFreeForm from '/snippets/try-for-free-form.mdx';
+
+  ...and drop <TryForFreeForm /> wherever the component should render
+  (e.g. right below the intro, per Kirk's ask).
+
+  Before merging anywhere real:
+  - Confirm with Amanda whether the Zap/CRM needs the `source` field mapped
+    on its end to actually split out docs vs. homepage in reporting.
+  - Confirm with Kirk whether /schedule-a-demo is the right place to send
+    someone converting from a docs page (currently hardcoded below).
+  - Test with a throwaway email first — this hits the *real* webhook.
+  */}
+
+<div style={{ maxWidth: 420, padding: '20px', border: '1px solid var(--gray-200, #e5e7eb)', borderRadius: '12px' }}>
+  <div id="try-for-free-form">
+    <p style={{ fontWeight: 600, marginBottom: '8px' }}>Try QA Wolf for free</p>
+
+    <form
+      onSubmit={(e) => {
+      e.preventDefault();
+      const email = e.target.elements['Email-2'].value;
+
+      fetch('https://hooks.zapier.com/hooks/catch/9281305/bzrnsj7', {
+        method: 'POST',
+        mode: 'no-cors',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({
+          'Email-2': email,
+          source: 'docs', // <- flag so this can be split from homepage submissions
+        }),
+      });
+
+      document.getElementById('try-for-free-form').style.display = 'none';
+      document.getElementById('try-for-free-success').style.display = 'block';
+
+      // Homepage version redirects to /schedule-a-demo on success.
+      // Uncomment once Kirk confirms that's the right destination from docs:
+      // window.location.href = 'https://www.qawolf.com/schedule-a-demo';
+    }}
+      style={{ display: 'flex', gap: '8px' }}
+    >
+      <input type="email" name="Email-2" required placeholder="you@company.com" style={{ flex: 1, padding: '10px 12px', borderRadius: '8px', border: '1px solid var(--gray-300, #d1d5db)' }} />
+
+      <button type="submit" style={{ padding: '10px 16px', borderRadius: '8px', border: 'none', background: 'var(--primary, #111827)', color: 'white', fontWeight: 600, cursor: 'pointer' }}>
+        Try for free
+      </button>
+    </form>
+  </div>
+
+  <div id="try-for-free-success" style={{ display: 'none' }}>
+    Thanks! We'll be in touch shortly.
+  </div>
+</div>
\ No newline at end of file

From 02f5cef9a471145f7797543c7c2bea0a88d3ff29 Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Tue, 14 Jul 2026 17:29:47 -0700
Subject: [PATCH 02/10] Updated mintlify pages

- Updated qawolf/quick-start.mdx

Mintlify-Source: dashboard-editor
---
 qawolf/quick-start.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/qawolf/quick-start.mdx b/qawolf/quick-start.mdx
index 5840bae..99df588 100644
--- a/qawolf/quick-start.mdx
+++ b/qawolf/quick-start.mdx
@@ -17,6 +17,8 @@ description: "Connect your application, generate your first flow, and run your f
 
 import TryForFreeForm from '/snippets/try-for-free-form.mdx';
 
+<TryForFreeForm />
+
 ## Step 1: Map your application
 
 Give the Mapping AI a target URL for your application (e.g., staging.wolfcorp.com) and tell it to map all the workflows.

From f8d1438488c644924ad600cfbc05ec96525f2edb Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Tue, 14 Jul 2026 17:38:22 -0700
Subject: [PATCH 03/10] Updated mintlify pages

- Updated snippets/try-for-free-form.mdx

Mintlify-Source: dashboard-editor
---
 snippets/try-for-free-form.mdx | 107 +++++++++++++++++++++++----------
 1 file changed, 74 insertions(+), 33 deletions(-)

diff --git a/snippets/try-for-free-form.mdx b/snippets/try-for-free-form.mdx
index 9f6dabc..dc5cee9 100644
--- a/snippets/try-for-free-form.mdx
+++ b/snippets/try-for-free-form.mdx
@@ -23,43 +23,84 @@
   - Test with a throwaway email first — this hits the *real* webhook.
   */}
 
-<div style={{ maxWidth: 420, padding: '20px', border: '1px solid var(--gray-200, #e5e7eb)', borderRadius: '12px' }}>
-  <div id="try-for-free-form">
-    <p style={{ fontWeight: 600, marginBottom: '8px' }}>Try QA Wolf for free</p>
+{/*
+  Layout below matches the actual site component: pill-shaped input + pill-shaped
+  button, side by side, same height, hard offset shadow. Colors/fonts below are
+  placeholders (per instruction to ignore those for now) — swap in real brand
+  tokens once the structural layout is confirmed to render correctly.
+
+  Fix from the first draft: the input had no `minWidth: 0`, so as a flex child
+  it refused to shrink and blew out to fill/overflow its container, which is
+  also what pushed the button out of view. Explicit height + box-sizing on both
+  elements keeps them from ballooning regardless of what CSS Mintlify applies
+  around them.
+  */}
 
-    <form
-      onSubmit={(e) => {
-      e.preventDefault();
-      const email = e.target.elements['Email-2'].value;
+<div id="try-for-free-form" style={{ display: 'flex', gap: '12px', maxWidth: 480 }}>
+  <form
+    onSubmit={(e) => {
+    e.preventDefault();
+    const email = e.currentTarget.querySelector('input[name="Email-2"]').value;
 
-      fetch('https://hooks.zapier.com/hooks/catch/9281305/bzrnsj7', {
-        method: 'POST',
-        mode: 'no-cors',
-        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-        body: new URLSearchParams({
-          'Email-2': email,
-          source: 'docs', // <- flag so this can be split from homepage submissions
-        }),
-      });
+    fetch('https://hooks.zapier.com/hooks/catch/9281305/bzrnsj7', {
+      method: 'POST',
+      mode: 'no-cors',
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+      body: new URLSearchParams({
+        'Email-2': email,
+        source: 'docs', // <- flag so this can be split from homepage submissions
+      }),
+    });
 
-      document.getElementById('try-for-free-form').style.display = 'none';
-      document.getElementById('try-for-free-success').style.display = 'block';
+    document.getElementById('try-for-free-form').style.display = 'none';
+    document.getElementById('try-for-free-success').style.display = 'block';
 
-      // Homepage version redirects to /schedule-a-demo on success.
-      // Uncomment once Kirk confirms that's the right destination from docs:
-      // window.location.href = 'https://www.qawolf.com/schedule-a-demo';
+    // Homepage version redirects to /schedule-a-demo on success.
+    // Uncomment once Kirk confirms that's the right destination from docs:
+    // window.location.href = 'https://www.qawolf.com/schedule-a-demo';
+  }}
+    style={{ display: 'flex', gap: '12px', flex: 1, boxSizing: 'border-box' }}
+  >
+    <input
+      type="email"
+      name="Email-2"
+      required
+      placeholder="your work email"
+      style={{
+      flex: '1 1 auto',
+      minWidth: 0,
+      height: '56px',
+      boxSizing: 'border-box',
+      padding: '0 20px',
+      borderRadius: '999px',
+      border: '2px solid #000',
+      boxShadow: '4px 4px 0 #000',
+      fontSize: '16px',
     }}
-      style={{ display: 'flex', gap: '8px' }}
-    >
-      <input type="email" name="Email-2" required placeholder="you@company.com" style={{ flex: 1, padding: '10px 12px', borderRadius: '8px', border: '1px solid var(--gray-300, #d1d5db)' }} />
+    />
 
-      <button type="submit" style={{ padding: '10px 16px', borderRadius: '8px', border: 'none', background: 'var(--primary, #111827)', color: 'white', fontWeight: 600, cursor: 'pointer' }}>
-        Try for free
-      </button>
-    </form>
-  </div>
+    <button
+      type="submit"
+      style={{
+      flex: '0 0 auto',
+      height: '56px',
+      boxSizing: 'border-box',
+      padding: '0 28px',
+      borderRadius: '999px',
+      border: '2px solid #000',
+      boxShadow: '4px 4px 0 #000',
+      background: '#6EE7C4',
+      fontWeight: 600,
+      fontSize: '16px',
+      whiteSpace: 'nowrap',
+      cursor: 'pointer',
+    }}
+    >
+      Try for free
+    </button>
+  </form>
+</div>
 
-  <div id="try-for-free-success" style={{ display: 'none' }}>
-    Thanks! We'll be in touch shortly.
-  </div>
-</div>
\ No newline at end of file
+<p id="try-for-free-success" style={{ display: 'none' }}>
+  Thanks! We'll be in touch shortly.
+</p>
\ No newline at end of file

From 8f48e1329849c112587885398dbdfcc1010bdd0c Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Tue, 14 Jul 2026 17:46:23 -0700
Subject: [PATCH 04/10] Updated mintlify pages

- Updated snippets/try-for-free-form.mdx

Mintlify-Source: dashboard-editor
---
 snippets/try-for-free-form.mdx | 144 ++++++++++++++++-----------------
 1 file changed, 72 insertions(+), 72 deletions(-)

diff --git a/snippets/try-for-free-form.mdx b/snippets/try-for-free-form.mdx
index dc5cee9..dfe2a58 100644
--- a/snippets/try-for-free-form.mdx
+++ b/snippets/try-for-free-form.mdx
@@ -5,7 +5,6 @@
   homepage submissions in whatever consumes the webhook downstream.
 
   SETUP: this file goes in your Mintlify repo at /snippets/try-for-free-form.mdx
-  (Kirk wants this on 4 pages, so make it a snippet, not 4 copies).
 
   Then on each target page (Welcome, Quick Start, Mapping AI, Automation AI),
   add near the top:
@@ -13,14 +12,8 @@
     import TryForFreeForm from '/snippets/try-for-free-form.mdx';
 
   ...and drop <TryForFreeForm /> wherever the component should render
-  (e.g. right below the intro, per Kirk's ask).
+  (e.g. right below the intro).
 
-  Before merging anywhere real:
-  - Confirm with Amanda whether the Zap/CRM needs the `source` field mapped
-    on its end to actually split out docs vs. homepage in reporting.
-  - Confirm with Kirk whether /schedule-a-demo is the right place to send
-    someone converting from a docs page (currently hardcoded below).
-  - Test with a throwaway email first — this hits the *real* webhook.
   */}
 
 {/*
@@ -29,78 +22,85 @@
   placeholders (per instruction to ignore those for now) — swap in real brand
   tokens once the structural layout is confirmed to render correctly.
 
-  Fix from the first draft: the input had no `minWidth: 0`, so as a flex child
-  it refused to shrink and blew out to fill/overflow its container, which is
-  also what pushed the button out of view. Explicit height + box-sizing on both
-  elements keeps them from ballooning regardless of what CSS Mintlify applies
-  around them.
-  */}
 
-<div id="try-for-free-form" style={{ display: 'flex', gap: '12px', maxWidth: 480 }}>
-  <form
-    onSubmit={(e) => {
-    e.preventDefault();
-    const email = e.currentTarget.querySelector('input[name="Email-2"]').value;
+  */}
 
-    fetch('https://hooks.zapier.com/hooks/catch/9281305/bzrnsj7', {
-      method: 'POST',
-      mode: 'no-cors',
-      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-      body: new URLSearchParams({
-        'Email-2': email,
-        source: 'docs', // <- flag so this can be split from homepage submissions
-      }),
-    });
+<div style={{ display: 'flex', justifyContent: 'center', padding: '4px 8px 8px 4px' }}>
+  <div id="try-for-free-form" style={{ display: 'flex', gap: '12px' }}>
+    <form
+      onSubmit={(e) => {
+      e.preventDefault();
+      const email = e.currentTarget.querySelector('input[name="Email-2"]').value;
 
-    document.getElementById('try-for-free-form').style.display = 'none';
-    document.getElementById('try-for-free-success').style.display = 'block';
+      fetch('https://hooks.zapier.com/hooks/catch/9281305/bzrnsj7', {
+        method: 'POST',
+        mode: 'no-cors',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({
+          'Email-2': email,
+          source: 'docs', // <- flag so this can be split from homepage submissions
+        }),
+      });
 
-    // Homepage version redirects to /schedule-a-demo on success.
-    // Uncomment once Kirk confirms that's the right destination from docs:
-    // window.location.href = 'https://www.qawolf.com/schedule-a-demo';
-  }}
-    style={{ display: 'flex', gap: '12px', flex: 1, boxSizing: 'border-box' }}
-  >
-    <input
-      type="email"
-      name="Email-2"
-      required
-      placeholder="your work email"
-      style={{
-      flex: '1 1 auto',
-      minWidth: 0,
-      height: '56px',
-      boxSizing: 'border-box',
-      padding: '0 20px',
-      borderRadius: '999px',
-      border: '2px solid #000',
-      boxShadow: '4px 4px 0 #000',
-      fontSize: '16px',
-    }}
-    />
+      document.getElementById('try-for-free-form').style.display = 'none';
+      document.getElementById('try-for-free-success').style.display = 'block';
 
-    <button
-      type="submit"
-      style={{
-      flex: '0 0 auto',
-      height: '56px',
-      boxSizing: 'border-box',
-      padding: '0 28px',
-      borderRadius: '999px',
-      border: '2px solid #000',
-      boxShadow: '4px 4px 0 #000',
-      background: '#6EE7C4',
-      fontWeight: 600,
-      fontSize: '16px',
-      whiteSpace: 'nowrap',
-      cursor: 'pointer',
+      // Homepage version redirects to /schedule-a-demo on success.
+      // Uncomment once Kirk confirms that's the right destination from docs:
+      // window.location.href = 'https://www.qawolf.com/schedule-a-demo';
     }}
+      style={{ display: 'flex', gap: '12px', boxSizing: 'border-box' }}
     >
-      Try for free
-    </button>
-  </form>
+      <input
+        type="email"
+        name="Email-2"
+        required
+        placeholder="your work email"
+        style={{
+        flex: '0 0 auto',
+        minWidth: 0,
+        width: '320px',
+        height: '56px',
+        boxSizing: 'border-box',
+        padding: '0 20px',
+        borderRadius: '999px',
+        border: '2px solid #000',
+        boxShadow: '4px 4px 0 #000',
+        fontSize: '16px',
+        background: '#fff',
+        color: '#000',
+        colorScheme: 'light', // stop the browser auto-dark-styling this input in dark mode
+      }}
+      />
+
+      <button
+        type="submit"
+        style={{
+        flex: '0 0 auto',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        height: '56px',
+        boxSizing: 'border-box',
+        padding: '0 28px',
+        borderRadius: '999px',
+        border: '2px solid #000',
+        boxShadow: '4px 4px 0 #000',
+        background: '#6EE7C4',
+        color: '#000',
+        fontWeight: 600,
+        fontSize: '16px',
+        lineHeight: 1,
+        whiteSpace: 'nowrap',
+        cursor: 'pointer',
+      }}
+      >
+        Try for free
+      </button>
+    </form>
+  </div>
 </div>
 
-<p id="try-for-free-success" style={{ display: 'none' }}>
+<p id="try-for-free-success" style={{ display: 'none', textAlign: 'center' }}>
   Thanks! We'll be in touch shortly.
 </p>
\ No newline at end of file

From 93e6a138c468136a769e373ebc390d900583150d Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Tue, 14 Jul 2026 18:01:48 -0700
Subject: [PATCH 05/10] Updated mintlify pages

- Updated qawolf/quick-start.mdx

Mintlify-Source: dashboard-editor
---
 qawolf/quick-start.mdx | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/qawolf/quick-start.mdx b/qawolf/quick-start.mdx
index 99df588..bedee52 100644
--- a/qawolf/quick-start.mdx
+++ b/qawolf/quick-start.mdx
@@ -8,16 +8,17 @@ description: "Connect your application, generate your first flow, and run your f
 
 ## Before you begin
 
+import TryForFreeForm from '/snippets/try-for-free-form.mdx';
+
 <Check>
   Before getting started, make sure the following are set up:
 
-  - **You have access to a QA Wolf workspace.**<br />Your team's QA Wolf administrator must invite you before you can log in and configure environments.
-  - **QA Wolf can access the application you want to test.**<br />If your application is behind a firewall or private network, a **VPN or network allowlist** must be configured so QA Wolf infrastructure can reach it.
-</Check>
+  - **You have access to a QA Wolf workspace.**<br />Create a new account below or [Sign in](https://app.qawolf.com/sign-in) to your existing account.
 
-import TryForFreeForm from '/snippets/try-for-free-form.mdx';
+  <TryForFreeForm />
 
-<TryForFreeForm />
+  - **QA Wolf can access the application you want to test.**<br />If your application is behind a firewall or private network, a [**VPN or network allowlist** must be configured](/qawolf/QA-Wolf-s-static-IPv4-29c5b2a994fb81bf8487d085abf9dc4d) so QA Wolf infrastructure can reach it.
+</Check>
 
 ## Step 1: Map your application
 

From d4c58c93ddfc69e392570499e619907dd61ff0f8 Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Wed, 15 Jul 2026 07:14:01 -0700
Subject: [PATCH 06/10] Updated mintlify pages

- Updated qawolf/quick-start.mdx
- Created qawolf-signup-handler.js
- Created snippets/try-for-free-embed.mdx
- Deleted snippets/try-for-free-form.mdx

Mintlify-Source: dashboard-editor
---
 qawolf-signup-handler.js        | 248 ++++++++++++++++++++++++++++++++
 qawolf/quick-start.mdx          |   2 +-
 snippets/try-for-free-embed.mdx | 116 +++++++++++++++
 snippets/try-for-free-form.mdx  | 106 --------------
 4 files changed, 365 insertions(+), 107 deletions(-)
 create mode 100644 qawolf-signup-handler.js
 create mode 100644 snippets/try-for-free-embed.mdx
 delete mode 100644 snippets/try-for-free-form.mdx

diff --git a/qawolf-signup-handler.js b/qawolf-signup-handler.js
new file mode 100644
index 0000000..b71b05f
--- /dev/null
+++ b/qawolf-signup-handler.js
@@ -0,0 +1,248 @@
+/*
+  Verbatim handler from the app team, unmodified. Drop this file at the root
+  of the Mintlify docs repo's content directory — Mintlify automatically
+  includes any .js file found there as a real <script> tag on every page.
+  (Pasting this as an inline <script> inside an MDX file will NOT work:
+  React-rendered script tags don't execute, only ones present in raw HTML
+  or ones explicitly created via document.createElement do.)
+
+  Uses the default platformUrl ('https://app.qawolf.com') since
+  document.currentScript.dataset won't be set when Mintlify includes this
+  as an external file rather than an inline tag with data-platform-url — the
+  fallback in the code already covers this, no changes needed here.
+
+  Do not merge/deploy this anywhere until both are confirmed:
+  1. CORS on app.qawolf.com's /api/trpc/* allows the docs origin.
+  2. window.qawAttribution is loaded (or safely stubbed) on the docs domain.
+  Until then every submission fails with the same generic "Failed to
+  connect to the server" message, which looks identical regardless of which
+  of the two is actually missing.
+*/
+
+function getPosthogIds() {
+  const posthog = window?.posthog;
+  if (!posthog) return {};
+  const posthogDistinctId = posthog.get_distinct_id();
+  const posthogSessionId = posthog.get_session_id();
+  return {
+    posthogDistinctId,
+    posthogSessionId,
+  };
+}
+
+const platformUrl = document.currentScript?.dataset.platformUrl || 'https://app.qawolf.com';
+const requestTimeoutMs = 5000;
+const genericError = 'Something went wrong. Please try again.';
+const invalidEmail = 'Please enter a valid email address.';
+
+const boundForms = new WeakSet();
+
+function renderFatalBanner(message) {
+  const banner = document.createElement('div');
+  banner.textContent = `Signup handler broken: ${message}`;
+  banner.style.cssText = 'position:fixed;top:0;left:0;right:0;z-index:2147483647;' + 'background:#b00020;color:#fff;padding:12px 16px;' + 'font:14px/1.4 system-ui,sans-serif;text-align:center;';
+  document.body.appendChild(banner);
+}
+
+async function postTrpc(procedure, payload, signal) {
+  const response = await fetch(`${platformUrl}/api/trpc/${procedure}`, {
+    body: JSON.stringify({ json: payload }),
+    headers: { 'Content-Type': 'application/json' },
+    method: 'POST',
+    signal,
+  });
+  if (!response.ok) {
+    const errorBody = await response.json().catch(() => undefined);
+    return {
+      type: 'http-error',
+      status: response.status,
+      body: errorBody,
+      message: errorBody?.error?.json?.message,
+    };
+  }
+  const body = await response.json();
+  const result = body?.result?.data?.json;
+  if (!result || !result.outcome) {
+    return { type: 'bad-shape', body };
+  }
+  return { type: 'ok', result };
+}
+
+function navigate(url) {
+  window.location.href = url;
+}
+
+// Navigates if maybeUrl is a valid same-origin URL; returns an error message otherwise.
+function navigateToSafeUrl(maybeUrl) {
+  if (typeof maybeUrl !== 'string' || !maybeUrl) return genericError;
+  let target;
+  try {
+    target = new URL(maybeUrl, platformUrl);
+  } catch (error) {
+    return genericError;
+  }
+  if (target.origin !== new URL(platformUrl).origin) return genericError;
+  navigate(target.href);
+  return undefined;
+}
+
+function handleSignUpOutcome(result) {
+  switch (result.outcome) {
+    case "code-sent":
+    case "sso-required":
+      return navigateToSafeUrl(result.redirectUrl);
+    case 'proceed-to-signin':
+      return navigateToSafeUrl(result.signInUrl);
+    case 'temporarily-disabled':
+      navigate('/book-a-demo');
+      return undefined;
+    case 'invalid-email':
+      switch (result.reason) {
+        case 'malformed':
+          return invalidEmail;
+        case 'public-domain':
+          return 'Please use your work email address.';
+        case 'blocked':
+          return 'Please use a different email address to sign up.';
+      }
+    default:
+      return genericError;
+  }
+}
+
+function handleBookADemoOutcome(result) {
+  switch (result.outcome) {
+    case 'ok':
+      return navigateToSafeUrl(result.redirectTo);
+    case 'invalid-email':
+      return invalidEmail;
+    default:
+      return genericError;
+  }
+}
+
+function buildPayload(email) {
+  return {
+    email,
+    attribution: window.qawAttribution.getAttribution(),
+    ...getPosthogIds(),
+  };
+}
+
+const FORM_KINDS = [
+  {
+    formSelector: '[data-signup-form]',
+    emailSelector: '[data-signup-email]',
+    feedbackSelector: '[data-signup-feedback]',
+    procedure: 'auth.submitSignUpEmail',
+    handleOutcome: handleSignUpOutcome,
+    submitLabel: 'Get started',
+  },
+  {
+    formSelector: '[data-book-a-demo-form]',
+    emailSelector: '[data-book-a-demo-email]',
+    feedbackSelector: '[data-book-a-demo-feedback]',
+    procedure: 'acquisition.submitBookADemoForm',
+    handleOutcome: handleBookADemoOutcome,
+    submitLabel: 'Book a demo',
+  },
+];
+
+function setupForm(form, kind) {
+  if (boundForms.has(form)) return;
+  boundForms.add(form);
+
+  const emailInput = form.querySelector(kind.emailSelector);
+  if (!emailInput) {
+    renderFatalBanner(`missing ${kind.emailSelector} inside ${kind.formSelector}`);
+    return;
+  }
+
+  const feedbackEl = form.querySelector(kind.feedbackSelector);
+  if (!feedbackEl) {
+    renderFatalBanner(`missing ${kind.feedbackSelector} inside ${kind.formSelector}`);
+    return;
+  }
+
+  const submitButton = form.querySelector('button[type=submit], input[type=submit]');
+  if (!submitButton) {
+    renderFatalBanner(`missing submit button inside ${kind.formSelector}`);
+    return;
+  }
+
+  form.addEventListener(
+    'submit',
+    async (event) => {
+      event.preventDefault();
+      event.stopImmediatePropagation();
+      if (submitButton.disabled) return;
+      feedbackEl.textContent = '';
+      feedbackEl.style.display = 'none';
+      submitButton.disabled = true;
+      submitButton.classList.add('is-loading');
+      submitButton.value = 'Redirecting...';
+
+      const resetButton = () => {
+        submitButton.disabled = false;
+        submitButton.classList.remove('is-loading');
+        submitButton.value = kind.submitLabel;
+      };
+      const fail = (message) => {
+        feedbackEl.textContent = message;
+        feedbackEl.style.display = 'block';
+        resetButton();
+      };
+
+      const email = (emailInput.value || '').trim();
+
+      try {
+        const outcome = await postTrpc(kind.procedure, buildPayload(email), AbortSignal.timeout(requestTimeoutMs));
+        if (outcome.type === 'http-error' || outcome.type === 'bad-shape') {
+          fail(genericError);
+          return;
+        }
+        const errorMessage = kind.handleOutcome(outcome.result, email);
+        if (errorMessage) fail(errorMessage);
+      } catch (error) {
+        if (error?.name === 'TimeoutError') {
+          fail('Request timed out. Please try again.');
+        } else if (error?.name === 'AbortError') {
+          // Expected on page unload / navigation. Ignore silently.
+        } else {
+          fail('Failed to connect to the server. Please try again.');
+        }
+      }
+    },
+    true,
+  );
+
+  window.addEventListener('pageshow', () => {
+    submitButton.disabled = false;
+    submitButton.classList.remove('is-loading');
+    submitButton.value = kind.submitLabel;
+  });
+}
+
+function initFormHandlers() {
+  FORM_KINDS.forEach((kind) => {
+    document.querySelectorAll(kind.formSelector).forEach((form) => setupForm(form, kind));
+  });
+}
+
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', initFormHandlers);
+} else {
+  initFormHandlers();
+}
+
+// Handle forms (re)created later via Finsweet Attributes Inject.
+// Harmless no-op on Mintlify — Finsweet only exists on the Webflow marketing
+// site, so this array just sits unused here. Left in since it's verbatim.
+window.FinsweetAttributes ||= [];
+window.FinsweetAttributes.push([
+  'inject',
+  async (instances) => {
+    await Promise.all(instances.map((i) => i.loadingPromise));
+    initFormHandlers();
+  },
+]);
\ No newline at end of file
diff --git a/qawolf/quick-start.mdx b/qawolf/quick-start.mdx
index bedee52..3233d8c 100644
--- a/qawolf/quick-start.mdx
+++ b/qawolf/quick-start.mdx
@@ -8,7 +8,7 @@ description: "Connect your application, generate your first flow, and run your f
 
 ## Before you begin
 
-import TryForFreeForm from '/snippets/try-for-free-form.mdx';
+import TryForFreeForm from '/snippets/try-for-free-embed.mdx';
 
 <Check>
   Before getting started, make sure the following are set up:
diff --git a/snippets/try-for-free-embed.mdx b/snippets/try-for-free-embed.mdx
new file mode 100644
index 0000000..58906a5
--- /dev/null
+++ b/snippets/try-for-free-embed.mdx
@@ -0,0 +1,116 @@
+{/*
+  "Try for free" sign-up embed for Mintlify docs pages, using the real
+  production handler (from the designer/engineer), not the Zapier webhook
+  guessed at earlier — that URL in the homepage's raw HTML turned out to be
+  vestigial. The actual mechanism is a direct call to QA Wolf's own backend:
+  POST https://app.qawolf.com/api/trpc/auth.submitSignUpEmail
+
+  SETUP: this file goes in your Mintlify repo at /snippets/try-for-free-form.mdx
+  (Kirk wants this on 4 pages, so make it a snippet, not 4 copies).
+
+  Then on each target page (Welcome, Quick Start, Mapping AI, Automation AI),
+  add near the top:
+
+    import TryForFreeForm from '/snippets/try-for-free-form.mdx';
+
+  ...and drop <TryForFreeForm /> wherever the component should render.
+
+  BLOCKERS before this can work at all (both confirmed by reading the actual
+  script, not guessed):
+
+  1. CORS: this fetches cross-origin from the docs domain to app.qawolf.com.
+     That only works if app.qawolf.com's API allows the docs origin. It almost
+     certainly doesn't yet — this is the real engineering ask for Haroon/
+     Mateus: add https://docs.qawolf.com to the allowed-origins list for
+     /api/trpc/*. No credentials/cookies are sent by this call, so they don't
+     need Access-Control-Allow-Credentials — just the origin added. Until
+     this is done, every submission will fail client-side with a generic
+     "Failed to connect to the server" message and no other clue why.
+
+  2. window.qawAttribution: the handler script calls
+     window.qawAttribution.getAttribution() with no null-check. If that
+     global isn't loaded on the docs domain, every submission throws and
+     falls into the same generic failure message. Ask whoever owns that
+     script whether it's safe/intended to load on docs.qawolf.com, or get a
+     no-op stub to use instead.
+
+  Until both of those are resolved, this will look "broken" in exactly the
+  same unhelpful way (generic connection error) regardless of which one is
+  actually missing — don't burn time debugging the form markup itself if
+  submissions are failing; check these two first.
+  */}
+
+{/*
+  IMPORTANT — button element type: the handler script controls the loading
+  state by setting `submitButton.value` (e.g. to "Redirecting..."). That only
+  updates visible text on an <input type="submit">, not a <button> element
+  (a <button>'s `.value` isn't what renders its label). Using <input
+  type="submit"> below so the loading-state swap actually works, instead of
+  a <button> that would silently not update its own text.
+
+  IMPORTANT — label mismatch: the script's config for this form kind sets
+  submitLabel: 'Get started', so after any failed submission, resetButton()
+  will change the visible label to "Get started", not back to "Try for
+  free". Either change submitLabel in the shared handler script to 'Try for
+  free' to match the brand copy everywhere, or accept that a failed attempt
+  changes the button's label. Left the initial value as "Try for free"
+  below to match the design; flagging this so it's a deliberate choice, not
+  a bug someone finds later.
+
+  Required markup contract from the handler script:
+  - form needs [data-signup-form]
+  - email input inside it needs [data-signup-email]
+  - a feedback/error element inside it needs [data-signup-feedback]
+  - the submit control must be <button type="submit"> or <input type="submit">
+  */}
+
+<div style={{ display: 'flex', justifyContent: 'center', padding: '4px 8px 8px 4px' }}>
+  <form data-signup-form style={{ display: 'flex', flexWrap: 'wrap', gap: '12px', alignItems: 'flex-start' }}>
+    <input
+      data-signup-email
+      type="email"
+      name="email"
+      required
+      placeholder="your work email"
+      style={{
+      flex: '0 0 auto',
+      minWidth: 0,
+      width: '320px',
+      height: '56px',
+      boxSizing: 'border-box',
+      padding: '0 20px',
+      borderRadius: '999px',
+      border: '2px solid #000',
+      boxShadow: '4px 4px 0 #000',
+      fontSize: '16px',
+      background: '#fff',
+      color: '#000',
+      colorScheme: 'light', // stop the browser auto-dark-styling this input in dark mode
+    }}
+    />
+
+    <input
+      type="submit"
+      value="Try for free"
+      style={{
+      flex: '0 0 auto',
+      height: '56px',
+      boxSizing: 'border-box',
+      padding: '0 28px',
+      borderRadius: '999px',
+      border: '2px solid #000',
+      boxShadow: '4px 4px 0 #000',
+      background: '#6EE7C4',
+      color: '#000',
+      fontWeight: 600,
+      fontSize: '16px',
+      lineHeight: '52px', // input[type=submit] can't use flex centering directly; match to height minus border
+      whiteSpace: 'nowrap',
+      cursor: 'pointer',
+      textAlign: 'center',
+    }}
+    />
+
+    <div data-signup-feedback style={{ display: 'none', width: '100%', textAlign: 'center', color: '#b00020', fontSize: '14px' }} />
+  </form>
+</div>
\ No newline at end of file
diff --git a/snippets/try-for-free-form.mdx b/snippets/try-for-free-form.mdx
deleted file mode 100644
index dfe2a58..0000000
--- a/snippets/try-for-free-form.mdx
+++ /dev/null
@@ -1,106 +0,0 @@
-{/*
-  Prototype: "Try for free" sign-up embed for Mintlify docs pages.
-  Mirrors the homepage component (Webflow form -> Zapier webhook -> redirect),
-  but adds a `source: "docs"` field so submissions can be told apart from
-  homepage submissions in whatever consumes the webhook downstream.
-
-  SETUP: this file goes in your Mintlify repo at /snippets/try-for-free-form.mdx
-
-  Then on each target page (Welcome, Quick Start, Mapping AI, Automation AI),
-  add near the top:
-
-    import TryForFreeForm from '/snippets/try-for-free-form.mdx';
-
-  ...and drop <TryForFreeForm /> wherever the component should render
-  (e.g. right below the intro).
-
-  */}
-
-{/*
-  Layout below matches the actual site component: pill-shaped input + pill-shaped
-  button, side by side, same height, hard offset shadow. Colors/fonts below are
-  placeholders (per instruction to ignore those for now) — swap in real brand
-  tokens once the structural layout is confirmed to render correctly.
-
-
-  */}
-
-<div style={{ display: 'flex', justifyContent: 'center', padding: '4px 8px 8px 4px' }}>
-  <div id="try-for-free-form" style={{ display: 'flex', gap: '12px' }}>
-    <form
-      onSubmit={(e) => {
-      e.preventDefault();
-      const email = e.currentTarget.querySelector('input[name="Email-2"]').value;
-
-      fetch('https://hooks.zapier.com/hooks/catch/9281305/bzrnsj7', {
-        method: 'POST',
-        mode: 'no-cors',
-        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-        body: new URLSearchParams({
-          'Email-2': email,
-          source: 'docs', // <- flag so this can be split from homepage submissions
-        }),
-      });
-
-      document.getElementById('try-for-free-form').style.display = 'none';
-      document.getElementById('try-for-free-success').style.display = 'block';
-
-      // Homepage version redirects to /schedule-a-demo on success.
-      // Uncomment once Kirk confirms that's the right destination from docs:
-      // window.location.href = 'https://www.qawolf.com/schedule-a-demo';
-    }}
-      style={{ display: 'flex', gap: '12px', boxSizing: 'border-box' }}
-    >
-      <input
-        type="email"
-        name="Email-2"
-        required
-        placeholder="your work email"
-        style={{
-        flex: '0 0 auto',
-        minWidth: 0,
-        width: '320px',
-        height: '56px',
-        boxSizing: 'border-box',
-        padding: '0 20px',
-        borderRadius: '999px',
-        border: '2px solid #000',
-        boxShadow: '4px 4px 0 #000',
-        fontSize: '16px',
-        background: '#fff',
-        color: '#000',
-        colorScheme: 'light', // stop the browser auto-dark-styling this input in dark mode
-      }}
-      />
-
-      <button
-        type="submit"
-        style={{
-        flex: '0 0 auto',
-        display: 'flex',
-        alignItems: 'center',
-        justifyContent: 'center',
-        height: '56px',
-        boxSizing: 'border-box',
-        padding: '0 28px',
-        borderRadius: '999px',
-        border: '2px solid #000',
-        boxShadow: '4px 4px 0 #000',
-        background: '#6EE7C4',
-        color: '#000',
-        fontWeight: 600,
-        fontSize: '16px',
-        lineHeight: 1,
-        whiteSpace: 'nowrap',
-        cursor: 'pointer',
-      }}
-      >
-        Try for free
-      </button>
-    </form>
-  </div>
-</div>
-
-<p id="try-for-free-success" style={{ display: 'none', textAlign: 'center' }}>
-  Thanks! We'll be in touch shortly.
-</p>
\ No newline at end of file

From 9f223a2f54fca10cb9e4b9fc595b79260106c821 Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Wed, 15 Jul 2026 07:18:54 -0700
Subject: [PATCH 07/10] Updated mintlify pages

- Updated qawolf/quick-start.mdx

Mintlify-Source: dashboard-editor

From 634d5fe8df213d11381ba50728807c0605a0973b Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Wed, 15 Jul 2026 07:19:58 -0700
Subject: [PATCH 08/10] Updated mintlify pages

- Updated qawolf/quick-start.mdx

Mintlify-Source: dashboard-editor
---
 qawolf/quick-start.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qawolf/quick-start.mdx b/qawolf/quick-start.mdx
index 3233d8c..eddb190 100644
--- a/qawolf/quick-start.mdx
+++ b/qawolf/quick-start.mdx
@@ -13,7 +13,7 @@ import TryForFreeForm from '/snippets/try-for-free-embed.mdx';
 <Check>
   Before getting started, make sure the following are set up:
 
-  - **You have access to a QA Wolf workspace.**<br />Create a new account below or [Sign in](https://app.qawolf.com/sign-in) to your existing account.
+  - **You have access to a QA Wolf workspace.**<br />Create an account below or [Sign in](https://app.qawolf.com/sign-in) to your existing account.
 
   <TryForFreeForm />
 

From 7a5c974c9bcb0a07b2feebd9874ea182d90b8d70 Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Wed, 15 Jul 2026 07:43:14 -0700
Subject: [PATCH 09/10] Updated mintlify pages

- Updated snippets/try-for-free-embed.mdx

Mintlify-Source: dashboard-editor
---
 snippets/try-for-free-embed.mdx | 46 +++++++++++++++++++++------------
 1 file changed, 30 insertions(+), 16 deletions(-)

diff --git a/snippets/try-for-free-embed.mdx b/snippets/try-for-free-embed.mdx
index 58906a5..5da938a 100644
--- a/snippets/try-for-free-embed.mdx
+++ b/snippets/try-for-free-embed.mdx
@@ -40,6 +40,16 @@
   submissions are failing; check these two first.
   */}
 
+{/*
+  Styling below is pulled directly from the live homepage component's
+  computed styles (measured via devtools on the actual hero form), not
+  eyeballed from a screenshot: border-radius 10.8px (not a full pill —
+  the earlier draft over-rounded this), 1.5px black border, 3.6px hard
+  shadow, 44px height, 18px "GT Flexa" font at regular (400) weight, not
+  bold, 9.9px/13.5px padding, button fill #0DF2CC. Input is a fixed 300px
+  wide on the real site (not responsive/flexible), matched here too.
+  */}
+
 {/*
   IMPORTANT — button element type: the handler script controls the loading
   state by setting `submitButton.value` (e.g. to "Redirecting..."). That only
@@ -75,14 +85,17 @@
       style={{
       flex: '0 0 auto',
       minWidth: 0,
-      width: '320px',
-      height: '56px',
+      width: '300px',
+      height: '44px',
       boxSizing: 'border-box',
-      padding: '0 20px',
-      borderRadius: '999px',
-      border: '2px solid #000',
-      boxShadow: '4px 4px 0 #000',
-      fontSize: '16px',
+      padding: '9.9px 13.5px',
+      borderRadius: '10.8px',
+      border: '1.5px solid #000',
+      boxShadow: '3.6px 3.6px 0 #000',
+      fontSize: '18px',
+      fontWeight: 400,
+      fontFamily: '"GT Flexa", Arial, sans-serif',
+      lineHeight: '18px',
       background: '#fff',
       color: '#000',
       colorScheme: 'light', // stop the browser auto-dark-styling this input in dark mode
@@ -94,17 +107,18 @@
       value="Try for free"
       style={{
       flex: '0 0 auto',
-      height: '56px',
+      height: '44px',
       boxSizing: 'border-box',
-      padding: '0 28px',
-      borderRadius: '999px',
-      border: '2px solid #000',
-      boxShadow: '4px 4px 0 #000',
-      background: '#6EE7C4',
+      padding: '9.9px 13.5px',
+      borderRadius: '10.8px',
+      border: '1.5px solid #000',
+      boxShadow: '3.6px 3.6px 0 #000',
+      background: '#0DF2CC',
       color: '#000',
-      fontWeight: 600,
-      fontSize: '16px',
-      lineHeight: '52px', // input[type=submit] can't use flex centering directly; match to height minus border
+      fontWeight: 400,
+      fontSize: '18px',
+      fontFamily: '"GT Flexa", Arial, sans-serif',
+      lineHeight: '18px', // input[type=submit] centers text vertically on its own; no flex trick needed here
       whiteSpace: 'nowrap',
       cursor: 'pointer',
       textAlign: 'center',

From 021991e5fd7bf345db44a2089eef3ed1d2d81f1b Mon Sep 17 00:00:00 2001
From: John Gluck <141772680+JohnGluck@users.noreply.github.com>
Date: Wed, 15 Jul 2026 08:16:23 -0700
Subject: [PATCH 10/10] Updated mintlify pages

- Updated qawolf-signup-handler.js
- Created qawolf-attribution-handler.js

Mintlify-Source: dashboard-editor
---
 qawolf-attribution-handler.js | 146 ++++++++++++++++++++++++++++++++++
 qawolf-signup-handler.js      |   9 +--
 2 files changed, 148 insertions(+), 7 deletions(-)
 create mode 100644 qawolf-attribution-handler.js

diff --git a/qawolf-attribution-handler.js b/qawolf-attribution-handler.js
new file mode 100644
index 0000000..175ebfa
--- /dev/null
+++ b/qawolf-attribution-handler.js
@@ -0,0 +1,146 @@
+/*
+  Must be present (in some form) before qawolf-signup-handler.js runs its
+  submit handler, since that script calls window.qawAttribution.getAttribution()
+  with no null-check. In practice this isn't a real ordering risk: this file
+  sets window.qawAttribution synchronously within milliseconds of page load,
+  long before a user could type an email and click submit.
+
+  No head/early-load requirement despite earlier assumption: document.referrer
+  is fixed by the browser at navigation time regardless of when JS reads it,
+  and setIfAbsent() means first-touch data only gets captured once per
+  session anyway. Mintlify's standard "runs after the page becomes
+  interactive" timing is sufficient.
+
+  Nothing sensitive in here — no keys, no internal endpoints — confirmed
+  safe to commit as plain source in the public docs repo.
+*/
+
+(function () {
+  const attributionUrlParams = ['fbclid', 'gclid', 'utm_campaign', 'utm_content', 'utm_medium', 'utm_source', 'utm_term'];
+  const attributionCookies = ['li_fat_id'];
+
+  const LANDING_PAGE_KEY = 'qaw_attr_landing_page';
+  const REFERRER_KEY = 'qaw_attr_referrer';
+  function sessionKey(name) {
+    return 'qaw_attr_' + name;
+  }
+
+  function setIfAbsent(key, value) {
+    if (!value) return;
+    try {
+      if (sessionStorage.getItem(key)) return;
+      sessionStorage.setItem(key, value);
+    } catch {
+      // sessionStorage unavailable
+    }
+  }
+
+  function readSession(key) {
+    try {
+      return sessionStorage.getItem(key) || undefined;
+    } catch {
+      return undefined;
+    }
+  }
+
+  function getQueryParam(name) {
+    try {
+      const url = new URL(window.location.href);
+      return url.searchParams.get(name) || undefined;
+    } catch {
+      return undefined;
+    }
+  }
+
+  function getCookie(name) {
+    if (typeof document === 'undefined') return undefined;
+    try {
+      const rows = document.cookie.split('; ');
+      for (let i = 0; i < rows.length; i++) {
+        if (rows[i].indexOf(name + '=') === 0) {
+          const value = rows[i].slice(name.length + 1);
+          return value ? decodeURIComponent(value) : undefined;
+        }
+      }
+      return undefined;
+    } catch {
+      return undefined;
+    }
+  }
+
+  function initializeAttribution() {
+    if (typeof window === 'undefined') return;
+    setIfAbsent(LANDING_PAGE_KEY, window.location.href);
+    setIfAbsent(REFERRER_KEY, document.referrer);
+    attributionUrlParams.forEach(function (name) {
+      setIfAbsent(sessionKey(name), getQueryParam(name));
+    });
+    attributionCookies.forEach(function (name) {
+      setIfAbsent(sessionKey(name), getCookie(name));
+    });
+  }
+
+  function getStoredAttribution() {
+    if (typeof window === 'undefined') return {};
+    const params = {
+      landing_page: readSession(LANDING_PAGE_KEY),
+      referrer: readSession(REFERRER_KEY),
+    };
+    attributionUrlParams.forEach(function (name) {
+      params[name] = readSession(sessionKey(name));
+    });
+    attributionCookies.forEach(function (name) {
+      const live = getCookie(name);
+      params[name] = live != null ? live : readSession(sessionKey(name));
+    });
+    const output = {};
+    Object.keys(params).forEach(function (key) {
+      if (params[key]) output[key] = params[key];
+    });
+    return output;
+  }
+
+  function getPosthogAttribution() {
+    if (typeof window === 'undefined') return {};
+    var posthog = window.posthog;
+    if (!posthog || typeof posthog.get_property !== 'function' || typeof posthog.getSessionProperty !== 'function') return {};
+
+    try {
+      const clientSessionProps = posthog.get_property('$client_session_props');
+      const cspProps = (clientSessionProps ? clientSessionProps.props : {}) || {};
+      const merged = {};
+      attributionUrlParams.concat(attributionCookies).forEach(function (key) {
+        merged[key] = posthog.getSessionProperty(key);
+      });
+      merged.landing_page = cspProps.u;
+      merged.referrer = cspProps.r;
+      const output = {};
+      Object.keys(merged).forEach(function (key) {
+        if (merged[key]) output[key] = merged[key];
+      });
+      return output;
+    } catch {
+      return {};
+    }
+  }
+
+  function getAttribution() {
+    const stored = getStoredAttribution();
+    const posthog = getPosthogAttribution();
+
+    const output = {};
+    Object.keys(stored).forEach(function (k) {
+      output[k] = stored[k];
+    });
+    Object.keys(posthog).forEach(function (k) {
+      output[k] = posthog[k];
+    });
+    if (typeof window !== 'undefined' && window.location && window.location.href) {
+      output.submitted_from_url = window.location.href;
+    }
+    return output;
+  }
+
+  initializeAttribution();
+  window.qawAttribution = { getAttribution };
+})();
diff --git a/qawolf-signup-handler.js b/qawolf-signup-handler.js
index b71b05f..3a7a3c0 100644
--- a/qawolf-signup-handler.js
+++ b/qawolf-signup-handler.js
@@ -1,17 +1,12 @@
 /*
-  Verbatim handler from the app team, unmodified. Drop this file at the root
-  of the Mintlify docs repo's content directory — Mintlify automatically
-  includes any .js file found there as a real <script> tag on every page.
-  (Pasting this as an inline <script> inside an MDX file will NOT work:
-  React-rendered script tags don't execute, only ones present in raw HTML
-  or ones explicitly created via document.createElement do.)
+  Verbatim handler from the design team, unmodified. 
 
   Uses the default platformUrl ('https://app.qawolf.com') since
   document.currentScript.dataset won't be set when Mintlify includes this
   as an external file rather than an inline tag with data-platform-url — the
   fallback in the code already covers this, no changes needed here.
 
-  Do not merge/deploy this anywhere until both are confirmed:
+ Requires:
   1. CORS on app.qawolf.com's /api/trpc/* allows the docs origin.
   2. window.qawAttribution is loaded (or safely stubbed) on the docs domain.
   Until then every submission fails with the same generic "Failed to