Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 69 additions & 0 deletions .github/workflows/website-ux-copy.yml
Original file line number Diff line number Diff line change
@@ -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
27 changes: 27 additions & 0 deletions docs/ux-review-website.md
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 2 additions & 1 deletion packages/website/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
137 changes: 137 additions & 0 deletions packages/website/scripts/verify-ux-copy.mjs
Original file line number Diff line number Diff line change
@@ -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();
}
14 changes: 6 additions & 8 deletions packages/website/src/components/Footer.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -27,11 +26,10 @@ const Footer = () => {
Colleagues, not chatbots.
</h2>
<p className="text-ink-3 mx-auto mt-4 max-w-[44ch] text-[0.9375rem] leading-relaxed">
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.
</p>
<Button size="lg" className="mt-8 rounded-full px-7 font-medium" asChild>
<Link to="/download">Get Convera →</Link>
<Link to="/download">Download macOS beta</Link>
</Button>
</div>
</div>
Expand All @@ -43,8 +41,8 @@ const Footer = () => {
<div>
<LogoBrand size="md" linkable={true} />
<p className="text-ink-muted mt-4 max-w-[36ch] text-sm leading-relaxed">
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.
</p>
</div>

Expand Down Expand Up @@ -93,7 +91,7 @@ const Footer = () => {
<div>
<p className={columnLabel}>Install</p>
<p className="text-ink-muted mt-4 text-sm leading-relaxed">
One command, quarantine handled:
Homebrew install command for macOS:
</p>
<code className="bg-well border-rule mt-3 block overflow-x-auto rounded-md border px-3 py-2 font-mono text-[11px] leading-relaxed">
brew install --cask
Expand Down
6 changes: 4 additions & 2 deletions packages/website/src/components/Navbar.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,9 @@ const Navbar: React.FC = () => {
<button
onClick={() => setIsMenuOpen(!isMenuOpen)}
className="text-ink-muted hover:text-ink p-2 transition-colors md:hidden"
aria-label="Toggle menu"
aria-label={isMenuOpen ? "Close menu" : "Open menu"}
aria-expanded={isMenuOpen}
aria-controls="mobile-navigation"
>
{isMenuOpen ? <X className="h-5 w-5" /> : <Menu className="h-5 w-5" />}
</button>
Expand All @@ -52,7 +54,7 @@ const Navbar: React.FC = () => {

{isMenuOpen && (
<div className="mx-auto mt-2 w-full max-w-[420px]">
<nav className={`flex flex-col gap-1 rounded-2xl p-3 ${glass}`}>
<nav id="mobile-navigation" className={`flex flex-col gap-1 rounded-2xl p-3 ${glass}`}>
<Link
to="/pricing"
onClick={() => setIsMenuOpen(false)}
Expand Down
Loading
Loading