From 408ee409faa6bdf4f23bc9553b716830fe3f1b75 Mon Sep 17 00:00:00 2001 From: Jackson Chen <90215880+Sma1lboy@users.noreply.github.com> Date: Thu, 1 Oct 2026 04:37:17 -0700 Subject: [PATCH] fix(website): clarify provider privacy and recover download states --- .github/workflows/website-ux-copy.yml | 69 ++++ docs/ux-review-website.md | 27 ++ packages/website/package.json | 3 +- packages/website/scripts/verify-ux-copy.mjs | 137 +++++++ packages/website/src/components/Footer.tsx | 14 +- packages/website/src/components/Navbar.tsx | 6 +- .../src/components/download/Download.tsx | 350 +++++++----------- .../website/src/components/home/Index.tsx | 38 +- .../src/components/pricing/Pricing.tsx | 8 +- packages/website/src/lib/release-info.test.ts | 50 +++ packages/website/src/lib/release-info.ts | 39 ++ 11 files changed, 491 insertions(+), 250 deletions(-) create mode 100644 .github/workflows/website-ux-copy.yml create mode 100644 docs/ux-review-website.md create mode 100644 packages/website/scripts/verify-ux-copy.mjs create mode 100644 packages/website/src/lib/release-info.test.ts create mode 100644 packages/website/src/lib/release-info.ts 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:

brew install --cask diff --git a/packages/website/src/components/Navbar.tsx b/packages/website/src/components/Navbar.tsx index 3e210bde..e968c824 100644 --- a/packages/website/src/components/Navbar.tsx +++ b/packages/website/src/components/Navbar.tsx @@ -43,7 +43,9 @@ const Navbar: React.FC = () => { @@ -52,7 +54,7 @@ const Navbar: React.FC = () => { {isMenuOpen && (
-
@@ -303,22 +201,31 @@ const Download = () => { ) : ( )} - v{currentVersion} + {isLoading + ? "Checking latest version…" + : currentVersion + ? `v${currentVersion}` + : "Version unavailable"} - {releaseDate} + {isLoading ? "Loading release date…" : (releaseDate ?? "Release date unavailable")} {error && ( - - ⚠️ Using fallback data - +
+

{error}

+ +
)}
@@ -350,29 +257,21 @@ const Download = () => { Install with Homebrew

- 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+

@@ -386,7 +285,7 @@ const Download = () => { Other Platforms

- Windows and Linux ship when the agent sandbox covers them. + Windows and Linux downloads are not available. No release date is confirmed.

@@ -414,7 +313,7 @@ const Download = () => { variant="outline" className="bg-accent/5 border-accent/20 text-accent px-3 py-1" > - Coming Soon + Not available )} @@ -455,10 +354,9 @@ const Download = () => { className="text-foreground bg-muted hover:bg-muted/80 w-full shadow-md transition-all duration-300 hover:shadow-lg" size="lg" disabled={option.comingSoon} - onClick={() => showComingSoonToast(option.platform)} > - Coming Soon + Not available @@ -468,8 +366,8 @@ const Download = () => { {/* Direct DMG — the fallback path, deliberately below the fold */}

- 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:

- sudo xattr -rd com.apple.quarantine - /Applications/Convera.app + sudo xattr -rd com.apple.quarantine /Applications/Convera.app
@@ -599,9 +496,10 @@ const Download = () => { 3
-

Launch Application

+

Choose an AI provider

- 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 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.

{ style={slot(3)} >
@@ -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.

- + brew install --cask codefox-repo/codefox/convera
{ isVisible.hero ? "translate-y-0 opacity-100" : "translate-y-8 opacity-0" }`} > - Choose the plan that fits your needs and start using Convera today. + Review the plan and renewal price before continuing. +

+

+ AI provider subscriptions and API usage may cost extra. Check your provider’s + terms and usage limits separately.

@@ -202,7 +206,7 @@ const Pricing: React.FC = () => { : "" } features={[ - "All feature in Free", + "Everything in Free", "Boosted AI Model rate limits for advanced usage", "Priority response time", ]} diff --git a/packages/website/src/lib/release-info.test.ts b/packages/website/src/lib/release-info.test.ts new file mode 100644 index 00000000..15a4cbe4 --- /dev/null +++ b/packages/website/src/lib/release-info.test.ts @@ -0,0 +1,50 @@ +import assert from "node:assert/strict"; +import { test } from "node:test"; +import { getReleaseSummary, RELEASES_URL } from "./release-info.ts"; + +test("missing releases never invent a version, date, asset or changelog", () => { + assert.deepEqual(getReleaseSummary(null), { + version: null, + date: null, + dmgUrl: null, + dmgSize: "size unavailable", + url: RELEASES_URL, + notes: [], + }); +}); +test("only a real Apple Silicon DMG becomes a download", () => { + const result = getReleaseSummary({ + tag_name: "v1.2.3", + published_at: "2026-09-01T00:00:00Z", + body: "# Release\n- Fixed search\n* Improved keyboard access", + assets: [ + { + name: "Convera-x64.dmg", + size: 1024, + browser_download_url: "https://example.com/intel.dmg", + }, + { + name: "Convera-arm64.dmg", + size: 1048576, + browser_download_url: "https://example.com/arm.dmg", + }, + ], + }); + assert.equal(result.version, "1.2.3"); + assert.equal(result.date, "September 1, 2026"); + assert.equal(result.dmgUrl, "https://example.com/arm.dmg"); + assert.equal(result.dmgSize, "1.0 MB"); + assert.deepEqual(result.notes, ["Fixed search", "Improved keyboard access"]); +}); +test("bad dates and missing notes remain unavailable", () => { + const result = getReleaseSummary({ + tag_name: "v1", + published_at: "bad-date", + body: "No bullet notes", + assets: [], + }); + assert.equal(result.date, null); + assert.equal(result.dmgUrl, null); + assert.deepEqual(result.notes, []); + assert.equal(result.url, `${RELEASES_URL}/tag/v1`); +}); diff --git a/packages/website/src/lib/release-info.ts b/packages/website/src/lib/release-info.ts new file mode 100644 index 00000000..495248e7 --- /dev/null +++ b/packages/website/src/lib/release-info.ts @@ -0,0 +1,39 @@ +export const RELEASES_URL = "https://github.com/CodeFox-Repo/Convera/releases"; + +export interface GitHubRelease { + tag_name: string; + body?: string | null; + published_at?: string | null; + assets: Array<{ name: string; browser_download_url: string; size: number }>; +} + +/** Missing release data stays missing; never substitute an invented release. */ +export function getReleaseSummary(release: GitHubRelease | null) { + const dmg = release?.assets.find( + (asset) => asset.name.endsWith(".dmg") && asset.name.includes("arm64"), + ); + const date = release?.published_at ? new Date(release.published_at) : null; + return { + version: release?.tag_name.replace(/^v/, "") || null, + date: + date && !Number.isNaN(date.getTime()) + ? date.toLocaleDateString("en-US", { + year: "numeric", + month: "long", + day: "numeric", + timeZone: "UTC", + }) + : null, + dmgUrl: dmg?.browser_download_url ?? null, + dmgSize: dmg?.size ? `${(dmg.size / (1024 * 1024)).toFixed(1)} MB` : "size unavailable", + url: release?.tag_name + ? `${RELEASES_URL}/tag/${encodeURIComponent(release.tag_name)}` + : RELEASES_URL, + notes: (release?.body ?? "") + .split("\n") + .map((line) => line.trim()) + .filter((line) => /^([-*]\s|\d+\.\s)/.test(line)) + .map((line) => line.replace(/^([-*]\s|\d+\.\s)/, "")) + .slice(0, 6), + }; +}