diff --git a/.github/workflows/website-ux-copy.yml b/.github/workflows/website-ux-copy.yml
new file mode 100644
index 00000000..dcfb0d9b
--- /dev/null
+++ b/.github/workflows/website-ux-copy.yml
@@ -0,0 +1,69 @@
+name: Website UX verification
+on:
+ pull_request:
+ branches: [main]
+ paths:
+ - "packages/website/**"
+ - ".github/workflows/website-ux-copy.yml"
+jobs:
+ website-ux:
+ runs-on: ubuntu-latest
+ timeout-minutes: 20
+ permissions:
+ contents: read
+ steps:
+ - uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
+ - uses: actions/setup-node@v4
+ with:
+ node-version: "22"
+ - uses: pnpm/action-setup@v4
+ - name: Install locked dependencies
+ run: pnpm install --frozen-lockfile
+ - name: Test release copy states
+ run: pnpm --filter @convera/website test:copy
+ - name: Build website
+ working-directory: packages/website
+ run: pnpm exec vite build
+ - name: Install isolated browser test tools
+ run: |
+ npm install --prefix "$RUNNER_TEMP/convera-ui" playwright@1.58.2
+ "$RUNNER_TEMP/convera-ui/node_modules/.bin/playwright" install --with-deps chromium
+ - name: Prepare baseline source
+ env:
+ BASE_SHA: ${{ github.event.pull_request.base.sha }}
+ run: |
+ git worktree add "$RUNNER_TEMP/convera-before" "$BASE_SHA"
+ ln -s "$GITHUB_WORKSPACE/node_modules" "$RUNNER_TEMP/convera-before/node_modules"
+ if [ -d "$GITHUB_WORKSPACE/packages/website/node_modules" ]; then
+ ln -s "$GITHUB_WORKSPACE/packages/website/node_modules" "$RUNNER_TEMP/convera-before/packages/website/node_modules"
+ fi
+ - name: Verify real website and capture before and after
+ env:
+ BEFORE_URL: http://127.0.0.1:8180
+ AFTER_URL: http://127.0.0.1:8181
+ run: |
+ set -euo pipefail
+ mkdir -p ux-evidence
+ (cd "$RUNNER_TEMP/convera-before/packages/website" && "$GITHUB_WORKSPACE/packages/website/node_modules/.bin/vite" --host 127.0.0.1 --port 8180 > "$GITHUB_WORKSPACE/ux-evidence/before-server.log" 2>&1) &
+ before_pid=$!
+ (cd packages/website && pnpm exec vite --host 127.0.0.1 --port 8181 > "$GITHUB_WORKSPACE/ux-evidence/after-server.log" 2>&1) &
+ after_pid=$!
+ trap 'kill "$before_pid" "$after_pid" 2>/dev/null || true' EXIT
+ for port in 8180 8181; do
+ ready=0
+ for attempt in $(seq 1 60); do
+ if curl --fail --silent "http://127.0.0.1:$port" >/dev/null; then ready=1; break; fi
+ sleep 1
+ done
+ test "$ready" -eq 1
+ done
+ PLAYWRIGHT_MODULE="$RUNNER_TEMP/convera-ui/node_modules/playwright/index.mjs" EVIDENCE_DIR="$GITHUB_WORKSPACE/ux-evidence" node packages/website/scripts/verify-ux-copy.mjs
+ - name: Upload verification evidence
+ if: always()
+ uses: actions/upload-artifact@v4
+ with:
+ name: convera-website-ux-evidence
+ path: ux-evidence
+ if-no-files-found: error
diff --git a/docs/ux-review-website.md b/docs/ux-review-website.md
new file mode 100644
index 00000000..01d1aec1
--- /dev/null
+++ b/docs/ux-review-website.md
@@ -0,0 +1,27 @@
+# Website UX copy review
+
+Scope: home, download, pricing expectations, mobile navigation. Based on source at `0e21210e7f9bcfb6164c95b53338621a98e46cb6` and the public website observed on October 1, 2026. The UX-writing skill at https://www.skills.sh/content-designer/ux-writing-skill/ux-writing was read, including its full upstream SKILL.md. Copy was reviewed for purpose, concision, conversational tone and factual clarity.
+
+## Before → after
+
+- “Everything you say stays…” / “keys never leave” → local history is distinguished from requests to AI providers and connected tools
+- Generic download invitation → macOS beta / Apple Silicon / provider setup expectations
+- A failed release request invented version 0.0.8, a release date and release notes → unavailable state, retry and GitHub release fallback; no invented data
+- “Coming Soon” with unverified Windows/Linux requirements → not available, no confirmed date or requirements
+- Clipboard success was announced without waiting → success only after the write resolves, actionable failure otherwise
+- “Previous Versions” and “Report Issues” opened coming-soon toasts → actual repository releases and issues
+- “Toggle menu” → Open/Close menu plus expanded-state semantics
+- Pricing omitted separate AI-provider costs → provider subscriptions/API usage may cost extra; existing prices and checkout behavior unchanged
+- Installation copy guaranteed a “damaged” build was safe → explains the non-notarized beta and what removing quarantine does, without running any command
+
+## Evidence and acceptance
+
+- `pnpm --filter @convera/website test:copy`: missing release, real ARM64 asset, bad date and missing-note cases
+- `pnpm exec vite build` in the website: production bundle
+- `Website UX verification`: actual baseline and modified website rendered at desktop and mobile widths, with documented release-response fixtures and no production authentication requests
+- Browser checks: visible successful release, failure without invented data, retry recovery, disabled missing DMG, rejected clipboard write without a false success toast, mobile menu expanded/collapsed state
+- Screenshot names: `{before,after}-{desktop,mobile}-{home,privacy,download,release-error}.png`, plus after copy-error views
+
+## Boundaries
+
+This is source/preview verification, not a production rollout. No checkout, account creation, model call, download installation, security-setting change or deployment is performed. Commercial plan prices, limits, support promises, Discord membership, notarization and future release timing are not independently certified. Existing checkout/backend behavior is outside this copy change. Full website type-check reports React 18/19 cross-workspace dependency conflicts; a clean-baseline re-check was terminated by the cloud environment, so no clean type-check pass is claimed. Changed-file lint and bundling are separate checks, not a type-check substitute.
diff --git a/packages/website/package.json b/packages/website/package.json
index 6b299f8c..64eec26d 100644
--- a/packages/website/package.json
+++ b/packages/website/package.json
@@ -10,7 +10,8 @@
"build:dev": "bun run typecheck && vite build --mode development",
"typecheck": "tsc --noEmit",
"lint": "eslint .",
- "preview": "vite preview"
+ "preview": "vite preview",
+ "test:copy": "node --experimental-strip-types --test src/lib/release-info.test.ts"
},
"dependencies": {
"@daveyplate/better-auth-tanstack": "^1.3.6",
diff --git a/packages/website/scripts/verify-ux-copy.mjs b/packages/website/scripts/verify-ux-copy.mjs
new file mode 100644
index 00000000..e1c8617f
--- /dev/null
+++ b/packages/website/scripts/verify-ux-copy.mjs
@@ -0,0 +1,137 @@
+import assert from "node:assert/strict";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+// Run against the real Vite renderer. Only network replies and clipboard failure
+// are fixtures: no recreated UI, test-only components, account or model calls.
+const { chromium } = await import(pathToFileURL(process.env.PLAYWRIGHT_MODULE).href);
+const output = process.env.EVIDENCE_DIR ?? "ux-evidence";
+await mkdir(output, { recursive: true });
+const browser = await chromium.launch({ headless: true });
+const results = [];
+const release = {
+ tag_name: "v0.1.0",
+ published_at: "2026-08-01T20:19:45Z",
+ body: "## What changed\n- Conversation branching\n- Local provider settings",
+ assets: [
+ {
+ name: "Convera-0.1.0-arm64.dmg",
+ size: 114630244,
+ browser_download_url:
+ "https://github.com/CodeFox-Repo/Convera/releases/download/v0.1.0/Convera-0.1.0-arm64.dmg",
+ },
+ ],
+};
+try {
+ for (const [version, base] of [
+ ["before", process.env.BEFORE_URL],
+ ["after", process.env.AFTER_URL],
+ ]) {
+ for (const [viewportName, viewport] of [
+ ["desktop", { width: 1440, height: 1080 }],
+ ["mobile", { width: 390, height: 844 }],
+ ]) {
+ const context = await browser.newContext({ viewport, reducedMotion: "reduce" });
+ let failRelease = false;
+ let requests = 0;
+ await context.route("**/*", async (route) => {
+ const url = new URL(route.request().url());
+ if (url.href.includes("api.github.com/repos/CodeFox-Repo/Convera/releases/latest")) {
+ requests++;
+ return route.fulfill({
+ status: failRelease ? 503 : 200,
+ contentType: "application/json",
+ body: JSON.stringify(failRelease ? { message: "fixture unavailable" } : release),
+ });
+ }
+ if (url.origin === new URL(base).origin) return route.continue();
+ // Production auth APIs are never reached by this test.
+ return route.fulfill({ status: 200, contentType: "application/json", body: "null" });
+ });
+ const page = await context.newPage();
+ await page.goto(base, { waitUntil: "networkidle" });
+ await page.getByRole("heading", { name: "AI colleagues in your workspace." }).waitFor();
+ await page.screenshot({ path: join(output, `${version}-${viewportName}-home.png`) });
+ const privacy = page.getByRole("heading", {
+ name:
+ version === "before"
+ ? "Everything you say stays in a database you own."
+ : "Your chat history, stored on your device.",
+ });
+ await privacy.scrollIntoViewIfNeeded();
+ await page.waitForTimeout(500); // CSS entrance transition, not an application assertion
+ await page.screenshot({ path: join(output, `${version}-${viewportName}-privacy.png`) });
+ if (version === "after")
+ assert.match(
+ await page.locator("body").innerText(),
+ /Provider terms, data policies and usage charges apply/,
+ );
+ await page.goto(`${base}/download`, { waitUntil: "networkidle" });
+ await page.getByText("v0.1.0", { exact: true }).waitFor();
+ await page.screenshot({ path: join(output, `${version}-${viewportName}-download.png`) });
+ failRelease = true;
+ await page.reload({ waitUntil: "networkidle" });
+ await page
+ .getByText(version === "before" ? "⚠️ Using fallback data" : "Version unavailable", {
+ exact: true,
+ })
+ .waitFor();
+ await page.screenshot({ path: join(output, `${version}-${viewportName}-release-error.png`) });
+ if (version === "after") {
+ const body = await page.locator("body").innerText();
+ assert.ok(!body.includes("v0.0.8"));
+ assert.ok(!body.includes("Initial public release"));
+ assert.equal(
+ await page
+ .getByRole("button", { name: "macOS DMG unavailable", exact: true })
+ .isDisabled(),
+ true,
+ );
+ failRelease = false;
+ const priorRequests = requests;
+ await page.getByRole("button", { name: "Try again", exact: true }).click();
+ await page.getByText("v0.1.0", { exact: true }).waitFor();
+ assert.ok(requests > priorRequests);
+ assert.equal(await page.getByRole("alert").count(), 0);
+ await page.evaluate(() => {
+ Object.defineProperty(navigator, "clipboard", {
+ value: {
+ writeText: async () => {
+ throw new Error("fixture denied");
+ },
+ },
+ configurable: true,
+ });
+ });
+ await page
+ .getByRole("button", { name: "Copy Homebrew install command", exact: true })
+ .click();
+ await page.getByText("Couldn’t copy the command", { exact: true }).waitFor();
+ await page.screenshot({ path: join(output, `${version}-${viewportName}-copy-error.png`) });
+ assert.equal(await page.getByText("Install command copied", { exact: true }).count(), 0);
+ if (viewportName === "mobile") {
+ await page.getByRole("button", { name: "Open menu", exact: true }).click();
+ assert.equal(
+ await page
+ .getByRole("button", { name: "Close menu", exact: true })
+ .getAttribute("aria-expanded"),
+ "true",
+ );
+ await page.getByRole("button", { name: "Close menu", exact: true }).click();
+ assert.equal(
+ await page
+ .getByRole("button", { name: "Open menu", exact: true })
+ .getAttribute("aria-expanded"),
+ "false",
+ );
+ }
+ }
+ results.push({ version, viewportName, passed: true, releaseRequests: requests });
+ await context.close();
+ }
+ }
+ await writeFile(join(output, "results.json"), JSON.stringify(results, null, 2));
+} finally {
+ await browser.close();
+}
diff --git a/packages/website/src/components/Footer.tsx b/packages/website/src/components/Footer.tsx
index 4c943619..180285e1 100644
--- a/packages/website/src/components/Footer.tsx
+++ b/packages/website/src/components/Footer.tsx
@@ -3,8 +3,7 @@ import { Link } from "@tanstack/react-router";
import LogoBrand from "./LogoBrand";
const columnLabel = "text-ink-3 font-mono text-[11px] tracking-[0.14em] uppercase";
-const columnLink =
- "text-ink-muted hover:text-ink block py-1 text-sm transition-colors";
+const columnLink = "text-ink-muted hover:text-ink block py-1 text-sm transition-colors";
/**
* CTA banner over the generated landscape, then a link grid — the Prism-style
@@ -27,11 +26,10 @@ const Footer = () => {
Colleagues, not chatbots.
- A workspace on your machine where agents read the room and the
- record stays yours.
+ A workspace on your machine where agents read the room and the record stays yours.
@@ -43,8 +41,8 @@ const Footer = () => {
- AI colleagues in a workspace on your machine. Channels, direct
- messages, and a database you own.
+ AI colleagues in a workspace on your machine. Channels, direct messages, and a
+ database you own.
@@ -93,7 +91,7 @@ const Footer = () => {
Install
- One command, quarantine handled:
+ Homebrew install command for macOS:
- One command installs Convera and clears macOS quarantine for you — no
- “damaged app” dialog, no manual steps.
+ Run this command if you use Homebrew. Review the release and installation instructions
+ before installing this beta.
- Click to copy · Apple Silicon · macOS 12+
+ Copy install command · Apple Silicon · macOS 12+
- Prefer a direct download? Grab the DMG — you'll need one
- extra Terminal command (see the quick-start below).
+ Prefer a direct download? Review the release notes and macOS installation guidance
+ before opening the DMG.
-
- Install with Homebrew
-
+
Install with Homebrew
- One command installs the app and clears macOS
- quarantine for you
+ Requires Homebrew. Review the command and the release before installing.
@@ -578,18 +479,14 @@ const Download = () => {
2
-
- Downloaded the DMG instead?
-
+
Downloaded the DMG instead?
- The build isn't notarized yet, so macOS will say
- the app “is damaged”. It isn't — run
- this once in Terminal after moving Convera to
- Applications:
+ macOS may block this beta because it is not notarized. Verify the download
+ came from this repository. The command below removes macOS quarantine checks
+ for this app; use it only if you trust the download:
- Open Convera and meet your starter colleagues
+ Open Settings → General to check providers. Configure the provider used by
+ your colleagues before sending a message.
@@ -619,19 +517,31 @@ const Download = () => {
variant="outline"
size="sm"
className="border-primary/20 text-primary hover:bg-primary/5 w-full justify-start"
- onClick={() => showComingSoonToast("Community Forum")}
+ onClick={() =>
+ window.open(
+ "https://github.com/CodeFox-Repo/Convera",
+ "_blank",
+ "noopener,noreferrer",
+ )
+ }
>
- Join Community
+ View GitHub repository
showComingSoonToast("Issue Reporting")}
+ onClick={() =>
+ window.open(
+ "https://github.com/CodeFox-Repo/Convera/issues",
+ "_blank",
+ "noopener,noreferrer",
+ )
+ }
>
- Report Issues
+ Report an issue
diff --git a/packages/website/src/components/home/Index.tsx b/packages/website/src/components/home/Index.tsx
index aa08ce07..f70abf74 100644
--- a/packages/website/src/components/home/Index.tsx
+++ b/packages/website/src/components/home/Index.tsx
@@ -40,7 +40,8 @@ const Index = () => {
className="rise text-ink-faint font-mono text-[11px] tracking-[0.14em] uppercase"
style={slot(0)}
>
- a chatbot answers you → colleagues work with you
+ a chatbot answers you →{" "}
+ colleagues work with you
{
>
Channels, colleagues, direct messages — a workplace on your machine where agents read
the room, answer when spoken to, and stay out of conversations that aren't theirs.
- Everything lives in a database on your disk.
+ Chat history is stored on your device. AI replies use your chosen provider.
@@ -128,8 +129,8 @@ const Index = () => {
writing a paragraph about it.
- No routing rules decide who talks. Each colleague reads the message and decides —
- like people do.
+ No routing rules decide who talks. Each colleague reads the message and decides — like
+ people do.
@@ -161,16 +162,16 @@ const Index = () => {
className="rise mt-4 max-w-[20ch] text-[clamp(1.75rem,3.4vw,2.5rem)] leading-[1.08] font-bold tracking-[-0.025em]"
style={slot(1)}
>
- Everything you say stays in a database you own.
+ Your chat history, stored on your device.
- Conversations, messages, agents and model configs live in a local database — not on a
- sync server you have to trust. Global search covers all of it, instantly, offline. And
- a fail-closed guard throws before any request containing an API key can leave the
- machine.
+ Conversations, messages, agents and model settings are saved locally. Search works on
+ your device. When you use AI or connected tools, relevant messages and context are
+ sent to the provider or service you choose.
- Delete the app and the folder — the record is gone. That's the whole cloud story.
+ Provider terms, data policies and usage charges apply. Local storage does not mean
+ that AI processing stays on your device.
@@ -185,8 +186,8 @@ const Index = () => {
{"\n"}
▸ newest: "q3 launch plan" — 2 days ago
{"\n"}
- ✓ credential guard
- keys never leave this machine
+ ● AI replies
+ processed by your chosen provider
@@ -339,16 +340,19 @@ const Index = () => {
Put your record where you can keep it.
- One brew command and you're standing in a workspace with three colleagues.
- If something feels wrong in the first minute, tell us in Discord — that's a bug
+ One brew command and you're standing in a workspace with three colleagues. If
+ something feels wrong in the first minute, tell us in Discord — that's a bug
worth filing.