Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

test(website): capture bilingual homepage visual evidence

tt-a1i17ed57fa9e20
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 5d6623f4..6874ec69 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -471,6 +471,14 @@ jobs:
ARCHIFY_SITE_INTEGRATION: '1'
ARCHIFY_CHROME: ${{ steps.website-chrome.outputs.chrome-path }}
ARCHIFY_CHROME_NO_SANDBOX: '1'
+ - name: Upload homepage visual evidence
+ if: always()
+ uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
+ with:
+ name: website-homepage-evidence
+ path: website/.browser-evidence
+ include-hidden-files: true
+ if-no-files-found: warn
- uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
with:
name: website-dist
diff --git a/website/package.json b/website/package.json
index 9e5e5aae..8a33bb67 100644
--- a/website/package.json
+++ b/website/package.json
@@ -12,7 +12,7 @@
"preview": "astro preview",
"check": "astro check",
"test": "node --test test/*.test.mjs",
- "test:browser": "node --test --test-name-pattern=\"real Chrome\" ../test/site-language-continuity.test.mjs test/community-browser.test.mjs"
+ "test:browser": "node --test --test-name-pattern=\"real Chrome\" ../test/site-language-continuity.test.mjs test/community-browser.test.mjs test/homepage-browser.test.mjs"
},
"dependencies": {
"@astrojs/react": "^6.0.6",
diff --git a/website/test/homepage-browser.test.mjs b/website/test/homepage-browser.test.mjs
new file mode 100644
index 00000000..bee9ef22
--- /dev/null
+++ b/website/test/homepage-browser.test.mjs
@@ -0,0 +1,109 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import http from 'node:http';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
+import { ChromeVisualBrowser, findChrome } from '../../archify/bin/visual-check.mjs';
+
+const website = fileURLToPath(new URL('../', import.meta.url));
+const enabled = process.env.ARCHIFY_SITE_INTEGRATION === '1';
+const root = path.resolve(process.env.ARCHIFY_SITE_ROOT || path.join(website, 'dist'));
+const mount = process.env.ARCHIFY_SITE_BASE ?? '/archify';
+const target = mount ? 'github' : 'cloudflare';
+const output = path.join(website, '.browser-evidence', target);
+
+test('real Chrome: homepage category and identity remain readable across languages, themes and viewports', {
+ skip: enabled ? false : 'Set ARCHIFY_SITE_INTEGRATION=1 and ARCHIFY_CHROME to run homepage browser evidence.',
+ timeout: 120000,
+}, async () => {
+ const chrome = findChrome();
+ assert.ok(chrome, 'The requested homepage gate requires usable Chrome.');
+ const server = http.createServer((request, response) => {
+ const url = new URL(request.url, 'http://127.0.0.1');
+ if (mount && !url.pathname.startsWith(`${mount}/`)) return response.writeHead(404).end();
+ let relative = url.pathname.slice(mount.length).replace(/^\/+/, '') || 'index.html';
+ if (relative === 'zh') relative = 'zh.html';
+ const file = path.resolve(root, relative);
+ if (!file.startsWith(`${root}${path.sep}`)) return response.writeHead(404).end();
+ try {
+ const types = { '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css', '.svg': 'image/svg+xml', '.woff2': 'font/woff2' };
+ response.setHeader('Content-Type', types[path.extname(file)] || 'application/octet-stream');
+ response.end(fs.readFileSync(file));
+ } catch { response.writeHead(404).end(); }
+ });
+ let browser;
+ fs.mkdirSync(output, { recursive: true });
+ const event = process.env.GITHUB_EVENT_PATH ? JSON.parse(fs.readFileSync(process.env.GITHUB_EVENT_PATH, 'utf8')) : null;
+ const manifest = {
+ capturedAt: new Date().toISOString(), target,
+ checkoutSha: execFileSync('git', ['rev-parse', 'HEAD'], { cwd: website, encoding: 'utf8' }).trim(),
+ pullRequestHead: event?.pull_request?.head?.sha || null,
+ runId: process.env.GITHUB_RUN_ID || null,
+ screenshots: [],
+ };
+ try {
+ await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
+ browser = new ChromeVisualBrowser(chrome);
+ const session = await browser.sessionPromise;
+ const evaluate = async expression => {
+ const result = await browser.cdp.send('Runtime.evaluate', { expression, awaitPromise: true, returnByValue: true }, session);
+ assert.ok(!result.exceptionDetails, JSON.stringify(result.exceptionDetails));
+ return result.result.value;
+ };
+ await browser.cdp.send('Emulation.setEmulatedMedia', { features: [{ name: 'prefers-reduced-motion', value: 'reduce' }] }, session);
+ for (const width of [1440, 390, 320]) for (const lang of ['en', 'zh']) {
+ await browser.cdp.send('Emulation.setDeviceMetricsOverride', { width, height: 1000, deviceScaleFactor: 1, mobile: width < 768 }, session);
+ const loaded = browser.cdp.waitFor('Page.loadEventFired', session);
+ loaded.catch(() => {});
+ await browser.cdp.send('Page.navigate', { url: `http://127.0.0.1:${server.address().port}${mount}/${lang === 'zh' ? (mount ? 'zh.html' : 'zh') : ''}` }, session);
+ await loaded;
+ await evaluate('document.fonts.ready');
+ for (const theme of ['light', 'dark']) {
+ await evaluate(`(async () => {
+ if (document.documentElement.dataset.theme !== ${JSON.stringify(theme)}) document.querySelector('[data-theme-toggle]').click();
+ scrollTo(0, 0);
+ await new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)));
+ })()`);
+ for (const region of ['hero', 'identity']) {
+ if (region === 'identity') await evaluate(`document.querySelector('.facts-identity').scrollIntoView({block:'center',behavior:'instant'})`);
+ await evaluate('new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))');
+ const receipt = await evaluate(`(() => {
+ const selectors = ${JSON.stringify(region === 'hero' ? ['.hero h1', '.hero-sub'] : ['.facts-identity', '.facts-identity a'])};
+ return { lang: document.documentElement.lang, theme: document.documentElement.dataset.theme,
+ viewport: innerWidth, scrollY, pageWidth: document.documentElement.scrollWidth,
+ nodes: selectors.flatMap(selector => [...document.querySelectorAll(selector)].map(node => {
+ const box = node.getBoundingClientRect(), style = getComputedStyle(node);
+ return { rect: { x: box.x, y: box.y, width: box.width, height: box.height }, text: node.innerText, href: node.getAttribute('href'), visible: box.width > 0 && box.height > 0 && style.visibility === 'visible' && Number(style.opacity) === 1,
+ fits: [...node.getClientRects()].every(rect => rect.left >= -1 && rect.right <= innerWidth + 1),
+ inView: box.top >= 0 && box.bottom <= innerHeight };
+ })) };
+ })()`);
+ const name = `${lang}-${width}-${theme}-${region}.png`;
+ const image = await browser.cdp.send('Page.captureScreenshot', { format: 'png' }, session);
+ fs.writeFileSync(path.join(output, name), Buffer.from(image.data, 'base64'));
+ manifest.screenshots.push({ file: name, width, height: 1000, lang, theme, region, receipt });
+ fs.writeFileSync(path.join(output, 'manifest.json'), JSON.stringify(manifest, null, 2));
+ assert.equal(receipt.lang, lang === 'en' ? 'en' : 'zh-Hans');
+ assert.equal(receipt.theme, theme);
+ assert.equal(receipt.viewport, width, `${name}: requested layout viewport`);
+ assert.ok(receipt.pageWidth <= receipt.viewport + 1, `${name}: no page overflow`);
+ assert.equal(receipt.nodes.length, region === 'hero' ? 2 : 3);
+ for (const node of receipt.nodes) assert.ok(node.visible && node.fits && node.inView, `${name}: readable ${node.text}`);
+ if (region === 'hero') {
+ assert.match(receipt.nodes[0].text, /AI agent|AI Agent/);
+ assert.match(receipt.nodes[1].text, /diagram skill|画图工具/);
+ } else {
+ assert.deepEqual(receipt.nodes.slice(1).map(node => [node.text, node.href]), [
+ ['archify.si', 'https://archify.si/'], ['tt-a1i/archify', 'https://github.com/tt-a1i/archify'],
+ ]);
+ }
+ }
+ }
+ }
+ } finally {
+ if (browser) await browser.close();
+ await new Promise(resolve => server.close(resolve));
+ }
+});