Skip to content

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

fix: align stable website identity and distinguish starter recipes

tt-a1i86a23e426ba4
diff --git a/website/src/components/SupportedDiagrams.astro b/website/src/components/SupportedDiagrams.astro
new file mode 100644
index 00000000..e7fad312
--- /dev/null
+++ b/website/src/components/SupportedDiagrams.astro
@@ -0,0 +1,4 @@
+<p class="supported-diagrams" data-en="Ten supported diagram types: Architecture, Workflow, Sequence, Dataflow, Lifecycle, ERD, Class, Tree, Timeline, and Waterfall. The recipes below are selected starting points." data-zh="支持十类图:架构图、工作流、时序图、数据流、生命周期、实体关系图、类图、树图、时间线和瀑布图。下方配方是精选入门示例。">Ten supported diagram types: Architecture, Workflow, Sequence, Dataflow, Lifecycle, ERD, Class, Tree, Timeline, and Waterfall. The recipes below are selected starting points.</p>
+<style>
+ .supported-diagrams { color: var(--text-2); font-size: 14px; line-height: 1.8; margin: 16px 0 24px; }
+</style>
diff --git a/website/src/data/site-translations.mjs b/website/src/data/site-translations.mjs
index 3b056d21..f7a8ec77 100644
--- a/website/src/data/site-translations.mjs
+++ b/website/src/data/site-translations.mjs
@@ -32,7 +32,7 @@ export const indexCopy = {
'beat-3-t':'Compare by meaning, not by box.','beat-3-b':'Lens keeps only the semantic kinds you name — security against data, backend against storage — and quiets the rest.',
'stat-types':'Diagram types','stat-presets':'Visual presets','stat-checks':'Validation checks per artifact','stat-export':'Native export scale','stat-deps':'Runtime dependencies',
'label-types':'Diagram types',
- 'types-h2':'Five questions. <em>Five kinds of map.</em>',
+ 'types-h2':'Five starting questions. <em>Choose your map.</em>',
'types-body':'Ask the question you actually have. Archify picks the picture that answers it — for a software system, a plan, or something in your own life.',
'types-more':'Browse the full proof gallery','types-more-sub':'Live artifacts · every preset · every type',
'arch-h':'What is it made of?',
@@ -114,7 +114,7 @@ export const indexCopy = {
'beat-3-t':'按语义对比,而不是按方框。','beat-3-b':'语义镜头只保留你点名的类型——安全对数据、后端对存储——其余全部压暗。',
'stat-types':'图表类型','stat-presets':'视觉预设','stat-checks':'每个成品的校验项','stat-export':'原生导出倍率','stat-deps':'运行时依赖',
'label-types':'图表类型',
- 'types-h2':'五个问题,<br><em>五种图。</em>',
+ 'types-h2':'五个入门问题,<br><em>选择合适的图。</em>',
'types-body':'问你真正想问的问题。Archify 会选出能回答它的那种图——不管是一套软件系统、一份计划,还是你自己生活里的事。',
'types-more':'浏览完整作品集','types-more-sub':'实时成品 · 全部预设 · 全部图型',
'arch-h':'它由什么组成?',
@@ -168,12 +168,12 @@ export const indexCopy = {
export const guideCopy = {
en: {
navGuide:'Guide',navProof:'Proof Lab',navStart:'Get started',navCommunity:'Community',navInstall:'Install Skill',versionLabel:'Scenario guide / development / v[[ARCHIFY_VERSION]]',eyebrow:'Question-first diagramming', headline:'Choose the question.<br>Get the <em>right diagram.</em>', lede:'Describe what your audience needs to understand. Archify recommends one bounded visual recipe—plus the evidence it must contain, when not to use it, and a prompt you can copy.',
- metricRecipes:'real-world<br>recipes',metricModes:'typed diagram<br>modes',metricRuntime:'runtime<br>dependencies',chooserTitle:'What must the diagram explain?',chooserBody:'Write a situation, not a diagram type. Specific system facts produce a stronger recommendation.',placeholder:'Example: Show an API request with JWT auth, a Redis cache miss, database fallback, and async tracing.',recommend:'Recommend a recipe →',clear:'Clear',libraryEyebrow:'Recipe library',libraryTitle:'13 small, opinionated starting points.',libraryBody:'Each recipe answers one technical question. That boundary keeps the result legible, reviewable, and honest about missing evidence.',footerLeft:'Generated from the same recipe source as the Archify CLI.',all:'All recipes',recommended:'Recommended recipe',use:'Use when',avoid:'Avoid when',must:'Evidence to include',presentation:'Presentation',prompt:'Copy-ready prompt',copyPrompt:'Copy prompt',copied:'Copied',alternatives:'Other possible fits:',confidence:'confidence',open:'Open recipe',proofReady:'Verified proof',proofLink:'Open verified example ↗',
+ metricRecipes:'real-world<br>recipes',metricModes:'diagram modes<br>with recipes',metricRuntime:'runtime<br>dependencies',chooserTitle:'What must the diagram explain?',chooserBody:'Write a situation, not a diagram type. Specific system facts produce a stronger recommendation.',placeholder:'Example: Show an API request with JWT auth, a Redis cache miss, database fallback, and async tracing.',recommend:'Recommend a recipe →',clear:'Clear',libraryEyebrow:'Recipe library',libraryTitle:'13 small, opinionated starting points.',libraryBody:'Each recipe answers one technical question. That boundary keeps the result legible, reviewable, and honest about missing evidence.',footerLeft:'Generated from the same recipe source as the Archify CLI.',all:'All recipes',recommended:'Recommended recipe',use:'Use when',avoid:'Avoid when',must:'Evidence to include',presentation:'Presentation',prompt:'Copy-ready prompt',copyPrompt:'Copy prompt',copied:'Copied',alternatives:'Other possible fits:',confidence:'confidence',open:'Open recipe',proofReady:'Verified proof',proofLink:'Open verified example ↗',
samples:[['API + cache miss','Show an API request with JWT auth, a Redis cache miss, database fallback, and async tracing.'],['Kafka + DLQ','Map Kafka topics, ordered processors, consumer groups, replay, state stores, and the dead-letter queue.'],['Incident response','Show how responders detect, triage, mitigate, escalate, communicate, and verify recovery.']]
},
zh: {
navGuide:'场景指南',navProof:'验证作品集',navStart:'开始使用',navCommunity:'社区包',navInstall:'安装技能',versionLabel:'场景指南 / 开发版 / v[[ARCHIFY_VERSION]]',eyebrow:'先问题,后图表',headline:'先选对问题,<br>再得到<em>对的图。</em>',lede:'描述受众真正需要理解的内容。Archify 会推荐一个有边界的视觉配方,同时给出证据清单、禁用条件和可复制提示词。',
- metricRecipes:'个真实场景<br>配方',metricModes:'种类型化<br>图表模式',metricRuntime:'个运行时<br>依赖',chooserTitle:'这张图必须解释什么?',chooserBody:'写清场景,不要只写图表类型。系统事实越具体,推荐越可靠。',placeholder:'例如:展示带 JWT 鉴权、Redis 缓存未命中、数据库回退和异步追踪的 API 请求。',recommend:'推荐配方 →',clear:'清空',libraryEyebrow:'配方库',libraryTitle:'13 个小而专的起点。',libraryBody:'每个配方只回答一个技术问题。清晰的边界让图更易读、可评审,也不会掩盖证据缺口。',footerLeft:'网页与 Archify CLI 使用同一份配方数据生成。',all:'全部配方',recommended:'推荐配方',use:'适合',avoid:'不要这样用',must:'必须包含的证据',presentation:'表现建议',prompt:'可直接复制的提示词',copyPrompt:'复制提示词',copied:'已复制',alternatives:'其他可能:',confidence:'置信度',open:'打开配方',proofReady:'已验证成品',proofLink:'打开验证成品 ↗',
+ metricRecipes:'个真实场景<br>配方',metricModes:'种图表模式<br>有入门配方',metricRuntime:'个运行时<br>依赖',chooserTitle:'这张图必须解释什么?',chooserBody:'写清场景,不要只写图表类型。系统事实越具体,推荐越可靠。',placeholder:'例如:展示带 JWT 鉴权、Redis 缓存未命中、数据库回退和异步追踪的 API 请求。',recommend:'推荐配方 →',clear:'清空',libraryEyebrow:'配方库',libraryTitle:'13 个小而专的起点。',libraryBody:'每个配方只回答一个技术问题。清晰的边界让图更易读、可评审,也不会掩盖证据缺口。',footerLeft:'网页与 Archify CLI 使用同一份配方数据生成。',all:'全部配方',recommended:'推荐配方',use:'适合',avoid:'不要这样用',must:'必须包含的证据',presentation:'表现建议',prompt:'可直接复制的提示词',copyPrompt:'复制提示词',copied:'已复制',alternatives:'其他可能:',confidence:'置信度',open:'打开配方',proofReady:'已验证成品',proofLink:'打开验证成品 ↗',
samples:[['API + 缓存未命中','展示带 JWT 鉴权、Redis 缓存未命中、数据库回退和异步追踪的 API 请求。'],['Kafka + 死信','梳理 Kafka Topic、有序处理器、消费者组、重放、状态存储和死信队列。'],['事故处置','展示响应者如何发现、分诊、缓解、升级、沟通并验证恢复。']]
}
};
diff --git a/website/src/pages/gallery.astro b/website/src/pages/gallery.astro
index f8db7fd1..a71fc9b3 100644
--- a/website/src/pages/gallery.astro
+++ b/website/src/pages/gallery.astro
@@ -1,5 +1,6 @@
---
import { version, versioned, jsonScript, gallery, cards } from '../data/site';
+import { productChannel } from '../data/product-facts';
import SiteLayout from '../layouts/SiteLayout.astro';
import GalleryCard from '../components/GalleryCard.astro';
import Navigation from '../components/Navigation.astro';
@@ -132,7 +133,7 @@ receipt {gallery.checkCount} checks / {gallery.entryCount} artifacts / determini
<footer>
<div class="shell footer-inner">
<span data-en="Generated from Archify's checked-in examples. No hand-authored capability claims." data-zh="由 Archify 仓库内示例自动生成,不手写可能过期的能力声明。">Generated from Archify's checked-in examples. No hand-authored capability claims.</span>
- <span data-en={`Archify v${version} · development · MIT`} data-zh={`Archify v${version} · 开发版 · MIT`}>Archify v{version} · development · MIT</span>
+ <span data-en={`Archify v${version} · ${productChannel} · MIT`} data-zh={`Archify v${version} · ${productChannel === 'development' ? '开发版' : '稳定版'} · MIT`}>Archify v{version} · {productChannel} · MIT</span>
</div>
</footer>
diff --git a/website/src/pages/guide.astro b/website/src/pages/guide.astro
index e1dde192..28210fe8 100644
--- a/website/src/pages/guide.astro
+++ b/website/src/pages/guide.astro
@@ -1,5 +1,6 @@
---
import { version, versioned, jsonScript, guide } from '../data/site';
+import SupportedDiagrams from '../components/SupportedDiagrams.astro';
import SiteLayout from '../layouts/SiteLayout.astro';
import Navigation from '../components/Navigation.astro';
import RecipeReference from '../components/RecipeReference.astro';
@@ -21,6 +22,7 @@ const { lang = 'en' } = Astro.props;
<h1 data-i18n-html="headline">Choose the question.<br>Get the <em>right diagram.</em></h1>
<p class="lede" data-i18n="lede">Describe what your audience needs to understand. Archify recommends one bounded visual recipe—plus the evidence it must contain, when not to use it, and a prompt you can copy.</p>
</div>
+ <SupportedDiagrams />
<div class="metrics" aria-label="Guide metrics">
<div class="metric"><strong>{guide.length}</strong><span data-i18n-html="metricRecipes">real-world<br>recipes</span></div>
<div class="metric"><strong>{new Set(guide.map(recipe => recipe.type)).size}</strong><span data-i18n-html="metricModes">typed diagram<br>modes</span></div>
diff --git a/website/src/pages/index.astro b/website/src/pages/index.astro
index 19153ee9..0e493a37 100644
--- a/website/src/pages/index.astro
+++ b/website/src/pages/index.astro
@@ -1,5 +1,6 @@
---
import { version, versioned } from '../data/site';
+import SupportedDiagrams from '../components/SupportedDiagrams.astro';
import SiteLayout from '../layouts/SiteLayout.astro';
import Navigation from '../components/Navigation.astro';
import Brand from '../components/Brand';
@@ -160,10 +161,11 @@ const { lang = 'en' } = Astro.props;
<div class="container">
<header class="section-head fade-up">
<p class="section-label"><span>02</span><span data-i18n="label-types">Diagram types</span></p>
- <h2 class="section-heading" data-i18n="types-h2">Five questions. <em>Five kinds of map.</em></h2>
+ <h2 class="section-heading" data-i18n="types-h2">Five starting questions. <em>Choose your map.</em></h2>
<p class="section-body" data-i18n="types-body">Ask the question you actually have. Archify picks the picture that answers it — for a software system, a plan, or something in your own life.</p>
</header>
+ <SupportedDiagrams />
<div class="types-index">
<ol class="types-list" id="types-list">
<li class="type-item is-active" data-type="arch">
diff --git a/website/src/pages/start.astro b/website/src/pages/start.astro
index 90f3db80..28e971d0 100644
--- a/website/src/pages/start.astro
+++ b/website/src/pages/start.astro
@@ -1,5 +1,7 @@
---
import { version, versioned, jsonScript, starts } from '../data/site';
+import { productChannel } from '../data/product-facts';
+import SupportedDiagrams from '../components/SupportedDiagrams.astro';
import SiteLayout from '../layouts/SiteLayout.astro';
import Navigation from '../components/Navigation.astro';
import head from '../data/start-head.html?raw';
@@ -31,7 +33,8 @@ const { lang = 'en' } = Astro.props;
<button class="input-path" type="button" role="tab" data-input="description"><strong data-en="Just describe it" data-zh="直接描述">直接描述</strong><span data-en="Start in any chat. No files or repository needed." data-zh="在任意对话里开始,不需要文件或代码库。">Start in any chat. No files or repository needed.</span></button>
<button class="input-path" type="button" role="tab" data-input="repository"><strong data-en="Use a repository" data-zh="从代码库开始">Use a repository</strong><span data-en="Let the agent inspect code when source evidence matters." data-zh="需要源码证据时,再让 Agent 检查代码。">Let the agent inspect code when source evidence matters.</span></button>
</div>
- <p class="type-label" id="type-label"><span data-en="Choose the question shape" data-zh="选择问题形态">Choose the question shape</span><strong data-en={`${Object.keys(starts).length} typed renderers`} data-zh={`${Object.keys(starts).length} 种类型化渲染器`}>{Object.keys(starts).length} typed renderers</strong></p>
+ <p class="type-label" id="type-label"><span data-en="Choose the question shape" data-zh="选择问题形态">Choose the question shape</span><strong data-en={`${Object.keys(starts).length} starting recipes`} data-zh={`${Object.keys(starts).length} 个入门配方`}>{Object.keys(starts).length} starting recipes</strong></p>
+ <SupportedDiagrams />
<div class="type-tabs" role="tablist" aria-label="Diagram type">
<button class="type-tab" type="button" role="tab" data-type="architecture" data-en="Architecture" data-zh="架构图">Architecture</button>
<button class="type-tab" type="button" role="tab" data-type="workflow" data-en="Workflow" data-zh="工作流">Workflow</button>
@@ -87,7 +90,7 @@ const { lang = 'en' } = Astro.props;
</section>
<footer class="page-footer">
- <span data-en={`Archify v${version} · development · self-contained HTML · typed JSON source`} data-zh={`Archify v${version} · 开发版 · 独立 HTML · 类型化 JSON 源`}>Archify v{version} · development · self-contained HTML · typed JSON source</span>
+ <span data-en={`Archify v${version} · ${productChannel} · self-contained HTML · typed JSON source`} data-zh={`Archify v${version} · ${productChannel === 'development' ? '开发版' : '稳定版'} · 独立 HTML · 类型化 JSON 源`}>Archify v{version} · {productChannel} · self-contained HTML · typed JSON source</span>
<span id="copy-status" role="status" aria-live="polite"></span>
<a href="https://github.com/tt-a1i/archify" data-en="View source on GitHub ↗" data-zh="在 GitHub 查看源码 ↗">View source on GitHub ↗</a>
</footer>
diff --git a/website/test/migration.test.mjs b/website/test/migration.test.mjs
index 27bd6a43..c52a54d8 100644
--- a/website/test/migration.test.mjs
+++ b/website/test/migration.test.mjs
@@ -89,16 +89,19 @@ test('homepage version labels and translations match the release identity baseli
const generated = parse(read(dist, 'index.html'));
// The redesigned eyebrow separates the version chip from its channel label.
const version = JSON.parse(read(path.resolve(root, '../archify'), 'package.json')).version;
+ const { channel } = JSON.parse(read(path.resolve(root, '../archify'), 'skill-release.json'));
+ const englishBadge = `${channel === 'development' ? 'Development' : 'Stable'} Agent Skill · see what's new`;
+ const chineseBadge = `${channel === 'development' ? '开发版' : '稳定版'} Agent 技能 · 查看更新`;
const spans = elements(generated, 'span');
const badge = spans.find(node => attr(node, 'data-i18n') === 'hero-badge');
- assert.equal(semantic(badge).children.join(' '), "Development Agent Skill · see what's new");
+ assert.equal(semantic(badge).children.join(' '), englishBadge);
const versionChip = spans.find(node => (attr(node, 'class') || '').split(/\s+/).includes('eyebrow-tag'));
assert.equal(semantic(versionChip).children.join(' '), `v${version}`);
const copyNode = byId(generated, 'site-copy');
assert.ok(copyNode, 'built page must carry its shared translation dictionary');
const copy = JSON.parse(copyNode.childNodes.map(child => child.value || '').join(''));
- assert.equal(copy.en['hero-badge'], "Development Agent Skill · see what's new");
- assert.equal(copy.zh['hero-badge'], '开发版 Agent 技能 · 查看更新');
+ assert.equal(copy.en['hero-badge'], englishBadge);
+ assert.equal(copy.zh['hero-badge'], chineseBadge);
for (const key of ['footer-meta']) {
const labels = (tree) => [...elements(tree, 'span'), ...elements(tree, 'p')]
.filter(node => attr(node, 'data-i18n') === key).map(semantic);
diff --git a/website/test/seo-content.test.mjs b/website/test/seo-content.test.mjs
index cc998132..48420e26 100644
--- a/website/test/seo-content.test.mjs
+++ b/website/test/seo-content.test.mjs
@@ -14,7 +14,7 @@ const attr = (node, name) => node.attrs?.find(item => item.name === name)?.value
const find = (node, id) => attr(node, 'id') === id ? node : (node.childNodes || []).map(child => find(child, id)).find(Boolean);
const text = node => node?.nodeName === '#text' ? node.value : ['script', 'style'].includes(node?.tagName) ? '' : (node?.childNodes || []).map(text).join(' ');
const clean = value => value.replace(/\s+/g, ' ').trim();
-const read = (page, lang) => parse(fs.readFileSync(path.join(root, lang === 'zh' ? 'zh' : '', `${page}.html`), 'utf8'));
+const read = (page, lang) => parse(fs.readFileSync(path.join(root, lang === 'zh' && page !== 'index' ? 'zh' : '', `${lang === 'zh' && page === 'index' ? 'zh' : page}.html`), 'utf8'));
const byClass = (node, name) => [...((attr(node, 'class') || '').split(/\s+/).includes(name) ? [node] : []), ...(node.childNodes || []).flatMap(child => byClass(child, name))];
const byTag = (node, tag) => node.tagName === tag ? node : (node.childNodes || []).map(child => byTag(child, tag)).find(Boolean);
function assertProofLink(page, link, lang, proof) {
@@ -63,7 +63,7 @@ for (const lang of ['en', 'zh']) {
const recipe = SCENARIO_RECIPES.find(item => item.id === 'system-overview');
const data = JSON.parse(find(page, 'start-data').childNodes.map(node => node.value || '').join(''));
const count = Object.keys(data).length;
- assert.equal(clean(text(byTag(find(page, 'type-label'), 'strong'))), lang === 'zh' ? `${count} 种类型化渲染器` : `${count} typed renderers`);
+ assert.equal(clean(text(byTag(find(page, 'type-label'), 'strong'))), lang === 'zh' ? `${count} 个入门配方` : `${count} starting recipes`);
assert.equal(clean(text(find(page, 'recipe-question'))), clean(recipe[lang].question));
assert.equal(clean(text(find(page, 'recipe-prompt'))), clean(startPromptsFor(recipe, lang).descriptionPrompt));
for (const evidence of recipe[lang].include) assert.ok(clean(text(find(page, 'include-list'))).includes(clean(evidence)));
@@ -80,3 +80,18 @@ test('initial homepage product facts explain identity, inputs, delivery, license
assert.ok(hrefs.includes('https://github.com/tt-a1i/archify/releases'));
assert.ok(hrefs.includes('https://github.com/tt-a1i/archify/blob/main/LICENSE'));
});
+
+for (const lang of ['en', 'zh']) {
+ test(`initial ${lang} pages distinguish supported types from selected recipes and use the release channel`, () => {
+ const release = JSON.parse(fs.readFileSync(new URL('../../archify/skill-release.json', import.meta.url)));
+ for (const name of ['index', 'guide', 'start']) {
+ const inventory = clean(text(byClass(read(name, lang), 'supported-diagrams')[0]));
+ for (const label of lang === 'zh' ? ['类图', '树图', '时间线', '瀑布图', '精选入门示例'] : ['Class', 'Tree', 'Timeline', 'Waterfall', 'selected starting points']) assert.ok(inventory.includes(label), `${name}: ${label}`);
+ }
+ for (const name of ['start', 'gallery']) {
+ const footer = clean(text(byTag(read(name, lang), 'footer')));
+ const channel = lang === 'zh' ? (release.channel === 'development' ? '开发版' : '稳定版') : release.channel;
+ assert.ok(footer.includes(`v${release.version} · ${channel}`), `${name}: release identity`);
+ }
+ });
+}