Skip to content

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

docs: embed localized v4 launch videos in READMEs

tt-a1i402f13387aa1
diff --git a/README.md b/README.md
index a5cbc48a..56e83a63 100644
--- a/README.md
+++ b/README.md
@@ -44,14 +44,11 @@
## See Archify in action
-<p align="center">
- <!-- archify-launch-video -->
- <a href="https://tt-a1i.github.io/archify/gallery.html"><img src="docs/assets/archify-live-proof.gif" alt="Three verified Archify artifacts moving through Signal Flow, Blueprint, and Classic presets" width="960"/></a>
- <br/>
- <sub><strong>Three real generated artifacts.</strong> Signal Flow · Blueprint · Classic · <a href="https://tt-a1i.github.io/archify/gallery.html">open the interactive Proof Lab ↗</a></sub>
-</p>
+<!-- archify-launch-video -->
+
+https://github.com/user-attachments/assets/78570807-ba1d-4737-953f-55504a378a87
-**Click the preview to open real interactive artifacts.** The GIF shows the motion; the HTML lets you explore it yourself.
+**One sentence. Your repo, mapped.** Watch the 35-second demo: explore the diagram, follow source links, and trace a path. [Try the interactive examples ↗](https://tt-a1i.github.io/archify/gallery.html)
<a id="start"></a>
diff --git a/README_EN.md b/README_EN.md
index a5cbc48a..56e83a63 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -44,14 +44,11 @@
## See Archify in action
-<p align="center">
- <!-- archify-launch-video -->
- <a href="https://tt-a1i.github.io/archify/gallery.html"><img src="docs/assets/archify-live-proof.gif" alt="Three verified Archify artifacts moving through Signal Flow, Blueprint, and Classic presets" width="960"/></a>
- <br/>
- <sub><strong>Three real generated artifacts.</strong> Signal Flow · Blueprint · Classic · <a href="https://tt-a1i.github.io/archify/gallery.html">open the interactive Proof Lab ↗</a></sub>
-</p>
+<!-- archify-launch-video -->
+
+https://github.com/user-attachments/assets/78570807-ba1d-4737-953f-55504a378a87
-**Click the preview to open real interactive artifacts.** The GIF shows the motion; the HTML lets you explore it yourself.
+**One sentence. Your repo, mapped.** Watch the 35-second demo: explore the diagram, follow source links, and trace a path. [Try the interactive examples ↗](https://tt-a1i.github.io/archify/gallery.html)
<a id="start"></a>
diff --git a/README_JA.md b/README_JA.md
index a2cbe876..21a389a4 100644
--- a/README_JA.md
+++ b/README_JA.md
@@ -42,14 +42,11 @@
## 実際の Archify
-<p align="center">
- <!-- archify-launch-video -->
- <a href="https://tt-a1i.github.io/archify/gallery.html"><img src="docs/assets/archify-live-proof.gif" alt="Signal Flow、Blueprint、Classic の各プリセットで動作する 3 つの検証済み Archify 成果物" width="960"/></a>
- <br/>
- <sub><strong>実際に生成された 3 つの成果物。</strong> Signal Flow · Blueprint · Classic · <a href="https://tt-a1i.github.io/archify/gallery.html">インタラクティブな Proof Lab を開く ↗</a></sub>
-</p>
+<!-- archify-launch-video -->
+
+https://github.com/user-attachments/assets/78570807-ba1d-4737-953f-55504a378a87
-**プレビューをクリックすると、実際のインタラクティブな成果物が開きます。** GIF は動きを見せるためのもので、実際に探索できるのはブラウザで開く HTML のほうです。
+**ひと言で、リポジトリを可視化。** 約35秒の英語デモで、図の操作、ソースコードへのリンク、経路の追跡をご覧ください。[インタラクティブな作例を試す ↗](https://tt-a1i.github.io/archify/gallery.html)
<a id="start"></a>
diff --git a/README_ZH.md b/README_ZH.md
index 0648a8a7..e09b6950 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -44,14 +44,11 @@
## 看看 Archify 能做什么
-<p align="center">
- <!-- archify-launch-video -->
- <a href="https://tt-a1i.github.io/archify/gallery.html"><img src="docs/assets/archify-live-proof.gif" alt="三个经过验证的 Archify 成品依次展示 Signal Flow、Blueprint 和 Classic 预设" width="960"/></a>
- <br/>
- <sub><strong>三个真实生成、校验通过的成品。</strong> Signal Flow · Blueprint · Classic · <a href="https://tt-a1i.github.io/archify/gallery.html">打开可交互验证作品集 ↗</a></sub>
-</p>
+<!-- archify-launch-video -->
+
+https://github.com/user-attachments/assets/88cff7dd-bdf3-4b97-950c-37cc079898b1
-**点击上方预览,打开真实交互成品。** GIF 展示效果,浏览器中的 HTML 才能点击探索。
+**一句话,看懂你的项目。** 35 秒演示:探索交互图、查看源码关联、追踪完整路径。[试试可交互示例 ↗](https://tt-a1i.github.io/archify/gallery.html)
<a id="start"></a>
diff --git a/archify/test/readme-showcase.test.mjs b/archify/test/readme-showcase.test.mjs
index 9e057318..1b46760f 100644
--- a/archify/test/readme-showcase.test.mjs
+++ b/archify/test/readme-showcase.test.mjs
@@ -186,7 +186,7 @@ test('every README header links to the other languages', () => {
}
});
-test('all README languages show the brand mark and retain the verified animated proof', () => {
+test('all README languages show the brand mark and localized launch video', () => {
for (const language of readmeLanguages) {
const filename = language.file;
const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
@@ -198,11 +198,13 @@ test('all README languages show the brand mark and retain the verified animated
assert.ok(markIndex < taglineEnd && taglineEnd < heroIndex, `${filename}: hero must follow the logo and tagline`);
assert.ok(heroIndex < readme.indexOf('<strong>', taglineEnd), `${filename}: hero must precede navigation`);
assert.match(readme.slice(taglineEnd + 5), /^\s*<p align="center"><img src="docs\/assets\/archify-readme-hero\.png"/);
- const proofIndex = readme.indexOf('docs/assets/archify-live-proof.gif');
+ const proofIndex = readme.indexOf('<!-- archify-launch-video -->');
const demosIndex = sectionIndex(readme, filename, language.demos);
assert.ok(markIndex >= 0 && markIndex < demosIndex, `${filename}: brand lockup is missing before the demos`);
- assert.ok(proofIndex > demosIndex, `${filename}: animated proof must live in the demo section`);
- assert.match(readme, /docs\/assets\/archify-live-proof\.gif/);
+ assert.ok(proofIndex > demosIndex, `${filename}: launch video must live in the demo section`);
+ const videoId = filename === 'README_ZH.md' ? '88cff7dd-bdf3-4b97-950c-37cc079898b1' : '78570807-ba1d-4737-953f-55504a378a87';
+ assert.ok(readme.includes(`\nhttps://github.com/user-attachments/assets/${videoId}\n`), `${filename}: missing standalone localized video attachment`);
+ assert.ok(!readme.includes('docs/assets/archify-live-proof.gif'), `${filename}: obsolete preview remains`);
assert.match(readme, /https:\/\/tt-a1i\.github\.io\/archify\/gallery\.html/);
}
assert.equal(
@@ -282,13 +284,13 @@ test('README demos use checked-in captures and live deep links below the existin
const filename = language.file;
const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
const markIndex = readme.indexOf('docs/assets/archify-lockup-light.svg');
- const proofIndex = readme.indexOf('docs/assets/archify-live-proof.gif');
+ const proofIndex = readme.indexOf('<!-- archify-launch-video -->');
const previewIndex = sectionIndex(readme, filename, language.preview);
const demosIndex = sectionIndex(readme, filename, language.demos);
const quickStartIndex = sectionIndex(readme, filename, language.quickStart);
assert.ok(markIndex >= 0 && markIndex < demosIndex, `${filename}: brand mark must precede the demos`);
assert.ok(demosIndex < previewIndex && previewIndex < quickStartIndex, `${filename}: demo section is misplaced`);
- assert.ok(demosIndex < proofIndex && proofIndex < previewIndex, `${filename}: animated proof is outside the demo section`);
+ assert.ok(demosIndex < proofIndex && proofIndex < previewIndex, `${filename}: launch video is outside the demo section`);
for (const demo of demos) {
assert.match(readme, new RegExp(`docs/assets/${demo.asset.replaceAll('.', '\\.')}`));
assert.ok(readme.includes(demo.link), `${filename}: missing ${demo.link}`);
@@ -301,7 +303,6 @@ test('README preserves the visual proof set and key content', () => {
'archify-lockup-light.svg',
'archify-lockup-dark.svg',
'archify-readme-hero.png',
- 'archify-live-proof.gif',
'archify-demo-reach.png',
'archify-demo-route.png',
'archify-demo-lens.png',