Skip to content

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

feat(community): add community package registry v0 with website catalog page

tt-a1i3a24096aff54
diff --git a/archify/test/community-packages.test.mjs b/archify/test/community-packages.test.mjs
new file mode 100644
index 00000000..7afd521e
--- /dev/null
+++ b/archify/test/community-packages.test.mjs
@@ -0,0 +1,85 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import {
+ PACKAGE_TYPES,
+ REQUIRED_FIELDS,
+ validatePackage,
+ validateRegistry,
+} from '../../scripts/check-community-packages.mjs';
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
+const schema = JSON.parse(fs.readFileSync(path.join(repoRoot, 'community/package.schema.json'), 'utf8'));
+
+function validPackage() {
+ return {
+ name: 'demo-pack',
+ type: 'skill',
+ summary: { en: 'A demo package summary that is long enough.', zh: '一个足够长的演示包简介。' },
+ author: { name: 'demo', url: 'https://example.com/demo' },
+ repository: 'https://github.com/demo/demo-pack',
+ archify: '>=3.0.0 <4.0.0',
+ schemaVersions: [1, 2],
+ };
+}
+
+test('community registry: checked-in packages validate clean', () => {
+ const { entries, failures } = validateRegistry(repoRoot);
+ assert.deepEqual(failures, []);
+ assert.ok(entries.length >= 2, 'registry must seed at least two real packages');
+});
+
+test('community registry: validator stays in sync with package.schema.json', () => {
+ assert.deepEqual([...schema.required].sort(), [...REQUIRED_FIELDS].sort());
+ assert.deepEqual([...schema.properties.type.enum].sort(), [...PACKAGE_TYPES].sort());
+ assert.deepEqual(schema.additionalProperties, false);
+});
+
+test('community package: accepts a minimal valid entry', () => {
+ assert.deepEqual(validatePackage(validPackage()), []);
+});
+
+test('community package: rejects malformed entries with specific failures', () => {
+ const cases = [
+ ['missing required field', (value) => { delete value.repository; }, /missing required field "repository"/],
+ ['unknown field', (value) => { value.downloads = 10; }, /unknown field "downloads"/],
+ ['bad name case', (value) => { value.name = 'Demo-Pack'; }, /name must be lowercase kebab-case/],
+ ['bad type', (value) => { value.type = 'plugin'; }, /type must be one of/],
+ ['short en summary', (value) => { value.summary.en = 'short'; }, /summary\.en/],
+ ['missing zh summary', (value) => { delete value.summary.zh; }, /summary\.zh/],
+ ['non-https repository', (value) => { value.repository = '[email protected]:demo/x.git'; }, /repository must be an https/],
+ ['bad archify range', (value) => { value.archify = 'latest'; }, /archify must be a version range/],
+ ['empty schemaVersions', (value) => { value.schemaVersions = []; }, /schemaVersions must be a non-empty array/],
+ ['non-integer schemaVersions', (value) => { value.schemaVersions = ['1']; }, /positive integers/],
+ ['duplicate schemaVersions', (value) => { value.schemaVersions = [1, 1]; }, /unique/],
+ ['bad tag', (value) => { value.tags = ['Not A Tag']; }, /tags must be/],
+ ['bad evidence url', (value) => { value.evidence = [{ label: 'receipt', url: 'http://insecure.example.com' }]; }, /evidence\[0\]/],
+ ];
+ for (const [label, mutate, pattern] of cases) {
+ const value = validPackage();
+ mutate(value);
+ const failures = validatePackage(value);
+ assert.ok(failures.some((failure) => pattern.test(failure)), `${label}: expected ${pattern}, got ${JSON.stringify(failures)}`);
+ }
+});
+
+test('community registry: rejects duplicate names and file/name mismatches', () => {
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-community-'));
+ try {
+ const dir = path.join(root, 'community', 'packages');
+ fs.mkdirSync(dir, { recursive: true });
+ const first = validPackage();
+ const second = { ...validPackage() };
+ fs.writeFileSync(path.join(dir, 'demo-pack.json'), JSON.stringify(first));
+ fs.writeFileSync(path.join(dir, 'other-name.json'), JSON.stringify(second));
+ const { failures } = validateRegistry(root);
+ assert.ok(failures.some((failure) => /file name must match/.test(failure)), JSON.stringify(failures));
+ assert.ok(failures.some((failure) => /duplicate package name/.test(failure)), JSON.stringify(failures));
+ } finally {
+ fs.rmSync(root, { recursive: true, force: true });
+ }
+});
diff --git a/community/README.md b/community/README.md
new file mode 100644
index 00000000..622c0671
--- /dev/null
+++ b/community/README.md
@@ -0,0 +1,48 @@
+# Archify Community Packages
+
+A curated registry of **standalone packages that build on Archify**: domain skill packs, recipe libraries, brand kits, locale packs, and CLI wrappers. The catalog is rendered at [tt-a1i.github.io/archify/community.html](https://tt-a1i.github.io/archify/community.html) from the metadata files in [`packages/`](packages/).
+
+Design rationale and non-goals are tracked in [issue #663](https://github.com/tt-a1i/archify/issues/663).
+
+## What a community package is
+
+A community package lives **outside** the Archify core and depends on it — the way the [Hermes](../integrations/hermes-agent/) and [DeepSeek Harness](../integrations/deepseek-harness/) integrations already do: author versioned JSON IR, invoke the Archify CLI, keep everything deterministic and fail-closed.
+
+Archify has **no in-process plugin API, and none is planned for this registry**. Third-party code never executes inside the render pipeline, inside Archify CI, or inside the delivery trust model.
+
+| Type | Contents | Example |
+| --- | --- | --- |
+| `skill` | Agent skill pack: SKILL.md, reference docs, examples for a domain | "Archify for Kubernetes" |
+| `recipe` | Scenario/recipe library (the shape of `archify/recipes/scenarios.mjs`) | E-commerce architecture scenarios |
+| `brand-marks` | Brand-mark catalog or visual preset | Corporate identity pack |
+| `locale` | `meta.translations` catalog | Community-maintained language |
+| `wrapper` | Standalone tool that emits Archify JSON IR and calls the CLI | Terraform state → diagram |
+
+## Submitting a package
+
+1. Publish your package in your own repository (or npm). Archify does not host package content.
+2. Fork this repository and add **one metadata file**: `community/packages/<name>.json`, following [`package.schema.json`](package.schema.json). `<name>` is lowercase kebab-case and must equal the `name` field.
+3. Validate locally before opening the PR:
+
+ ```bash
+ node scripts/check-community-packages.mjs
+ ```
+
+4. Open a PR **targeting `dev`** (per [CONTRIBUTING.md](../CONTRIBUTING.md)) that adds only your metadata file. Include evidence links in the `evidence` field — validation receipts, screenshots, rendered example artifacts.
+
+Review follows the tiers in [REVIEWING.md](../REVIEWING.md). Approval criteria:
+
+- Metadata passes `scripts/check-community-packages.mjs`.
+- The declared `archify` compatibility range exists and the supported `schemaVersions` are real.
+- The package performs what its summary claims, from the evidence you link.
+- No telemetry, no hosted-service requirement, no code execution inside Archify.
+
+Listing is **not endorsement**. The catalog marks community packages as community-maintained; the Archify maintainers verify only what can be verified deterministically and never run package code.
+
+## Takedown
+
+Removal is also a PR, on record. Maintainers may remove a listing when the package is malicious, abandoned with a broken source URL, or its compatibility claims become permanently stale. Authors may request removal of their own listing at any time via PR or issue.
+
+## 中文摘要
+
+社区 package 是**独立产物**,依赖并调用 Archify,而不是被 Archify 加载的插件。提交方式:fork 本仓库,按 `package.schema.json` 在 `community/packages/` 下新增一个元数据文件,本地跑 `node scripts/check-community-packages.mjs` 校验,然后向 `dev` 分支提 PR。收录不代表官方背书;下架同样以 PR 形式留痕。
diff --git a/community/package.schema.json b/community/package.schema.json
new file mode 100644
index 00000000..aedcc0cd
--- /dev/null
+++ b/community/package.schema.json
@@ -0,0 +1,79 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://tt-a1i.github.io/archify/community/package.schema.json",
+ "title": "Archify Community Package",
+ "description": "Registry metadata for a standalone community package that builds on Archify. One file per package under community/packages/. The package content lives in the author's own repository; this file only indexes it.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["name", "type", "summary", "author", "repository", "archify", "schemaVersions"],
+ "properties": {
+ "name": {
+ "type": "string",
+ "pattern": "^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$",
+ "description": "Lowercase kebab-case identifier, unique across the registry. Also the file name: community/packages/<name>.json."
+ },
+ "type": {
+ "enum": ["skill", "recipe", "brand-marks", "locale", "wrapper"],
+ "description": "skill: agent skill pack; recipe: scenario/recipe library; brand-marks: brand-mark catalog or preset; locale: meta.translations catalog; wrapper: standalone tool that emits Archify JSON IR and calls the CLI."
+ },
+ "summary": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["en", "zh"],
+ "properties": {
+ "en": { "type": "string", "minLength": 10, "maxLength": 160 },
+ "zh": { "type": "string", "minLength": 6, "maxLength": 120 }
+ }
+ },
+ "author": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["name"],
+ "properties": {
+ "name": { "type": "string", "minLength": 1, "maxLength": 80 },
+ "url": { "type": "string", "pattern": "^https://" }
+ }
+ },
+ "repository": {
+ "type": "string",
+ "pattern": "^https://",
+ "description": "Public URL of the package source (git repository, npm page, or directory inside one)."
+ },
+ "archify": {
+ "type": "string",
+ "pattern": "^(\\^|~)\\d+\\.\\d+\\.\\d+$|^\\d+\\.\\d+\\.\\d+$|^>=\\d+\\.\\d+\\.\\d+ <\\d+\\.\\d+\\.\\d+$",
+ "description": "Compatible Archify version range, e.g. ^3.0.1 or >=3.0.0 <4.0.0."
+ },
+ "schemaVersions": {
+ "type": "array",
+ "items": { "type": "integer", "minimum": 1 },
+ "minItems": 1,
+ "uniqueItems": true,
+ "description": "Archify JSON IR schema_version values the package can author."
+ },
+ "homepage": {
+ "type": "string",
+ "pattern": "^https://"
+ },
+ "tags": {
+ "type": "array",
+ "items": { "type": "string", "pattern": "^[a-z0-9-]{1,32}$" },
+ "maxItems": 6,
+ "uniqueItems": true
+ },
+ "evidence": {
+ "type": "array",
+ "maxItems": 8,
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["label", "url"],
+ "properties": {
+ "label": { "type": "string", "minLength": 1, "maxLength": 80 },
+ "url": { "type": "string", "pattern": "^https://" }
+ }
+ },
+ "description": "Links to verification evidence: validation receipts, screenshots, rendered example artifacts. Evidence is authored by the submitter; Archify never executes third-party package code."
+ }
+ }
+}
diff --git a/community/packages/archify-dsh.json b/community/packages/archify-dsh.json
new file mode 100644
index 00000000..dd86c058
--- /dev/null
+++ b/community/packages/archify-dsh.json
@@ -0,0 +1,23 @@
+{
+ "name": "archify-dsh",
+ "type": "wrapper",
+ "summary": {
+ "en": "DeepSeek Harness plugin registering the Archify skill as a filesystem skill provider. Published on npm as @tt-a1i/archify-dsh.",
+ "zh": "DeepSeek Harness 插件,将 Archify skill 注册为文件系统 skill provider。以 npm 包 @tt-a1i/archify-dsh 分发;宿主编写 JSON IR 并调用 Archify CLI。"
+ },
+ "author": {
+ "name": "tt-a1i",
+ "url": "https://github.com/tt-a1i"
+ },
+ "repository": "https://github.com/tt-a1i/archify/tree/main/integrations/deepseek-harness",
+ "homepage": "https://www.npmjs.com/package/@tt-a1i/archify-dsh",
+ "archify": ">=3.0.0 <4.0.0",
+ "schemaVersions": [1, 2],
+ "tags": ["deepseek-harness", "dsh", "npm", "integration"],
+ "evidence": [
+ {
+ "label": "Pinned skill source commit",
+ "url": "https://github.com/tt-a1i/archify/blob/main/integrations/deepseek-harness/release.json"
+ }
+ ]
+}
diff --git a/community/packages/archify-hermes.json b/community/packages/archify-hermes.json
new file mode 100644
index 00000000..eeac2957
--- /dev/null
+++ b/community/packages/archify-hermes.json
@@ -0,0 +1,22 @@
+{
+ "name": "archify-hermes",
+ "type": "skill",
+ "summary": {
+ "en": "Hermes Agent integration: lets Hermes author Archify JSON IR and render through the Archify CLI — no code loaded into Archify.",
+ "zh": "Archify 的 Hermes Agent 集成。以目录插件形式让 Hermes 编写 Archify JSON IR 并通过 Archify CLI 渲染图,不向 Archify 本体加载任何代码。"
+ },
+ "author": {
+ "name": "tt-a1i",
+ "url": "https://github.com/tt-a1i"
+ },
+ "repository": "https://github.com/tt-a1i/archify/tree/main/integrations/hermes-agent",
+ "archify": ">=3.0.0 <4.0.0",
+ "schemaVersions": [1, 2],
+ "tags": ["hermes-agent", "integration", "opt-in"],
+ "evidence": [
+ {
+ "label": "Plugin contract tests",
+ "url": "https://github.com/tt-a1i/archify/tree/main/integrations/hermes-agent/test"
+ }
+ ]
+}
diff --git a/community/packages/archify-review.json b/community/packages/archify-review.json
new file mode 100644
index 00000000..a5930b60
--- /dev/null
+++ b/community/packages/archify-review.json
@@ -0,0 +1,16 @@
+{
+ "name": "archify-review",
+ "type": "skill",
+ "summary": {
+ "en": "Review skill for the Archify repo: triages issues, PRs, and code through value, cost, and impact lenses for evidence-based maintenance.",
+ "zh": "面向 Archify 仓库自身的评审 skill:按价值、成本、影响三个维度评审 issue、PR 与代码,支撑循证的维护决策。"
+ },
+ "author": {
+ "name": "tt-a1i",
+ "url": "https://github.com/tt-a1i"
+ },
+ "repository": "https://github.com/tt-a1i/archify/tree/main/.agents/skills/archify-review",
+ "archify": ">=3.0.0 <4.0.0",
+ "schemaVersions": [1, 2],
+ "tags": ["review", "maintenance", "evidence"]
+}
diff --git a/scripts/check-community-packages.mjs b/scripts/check-community-packages.mjs
new file mode 100644
index 00000000..55d0f5fa
--- /dev/null
+++ b/scripts/check-community-packages.mjs
@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+// Validates community/packages/*.json against the community package contract
+// (community/package.schema.json). Dependency-free by design: the registry is
+// community-facing and must be checkable without installing anything.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const scriptRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const rootFlag = process.argv.indexOf('--root');
+const repoRoot = rootFlag === -1 ? scriptRoot : path.resolve(process.argv[rootFlag + 1] || '');
+
+export const PACKAGE_TYPES = Object.freeze(['skill', 'recipe', 'brand-marks', 'locale', 'wrapper']);
+export const REQUIRED_FIELDS = Object.freeze(['name', 'type', 'summary', 'author', 'repository', 'archify', 'schemaVersions']);
+const ALLOWED_FIELDS = new Set([...REQUIRED_FIELDS, 'homepage', 'tags', 'evidence']);
+const NAME_PATTERN = /^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/;
+const HTTPS_PATTERN = /^https:\/\//;
+const ARCHIFY_RANGE_PATTERN = /^(\^|~)\d+\.\d+\.\d+$|^\d+\.\d+\.\d+$|^>=\d+\.\d+\.\d+ <\d+\.\d+\.\d+$/;
+const TAG_PATTERN = /^[a-z0-9-]{1,32}$/;
+
+function isPlainObject(value) {
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function isString(value) {
+ return typeof value === 'string';
+}
+
+function isHttpsUrl(value) {
+ return isString(value) && HTTPS_PATTERN.test(value);
+}
+
+export function validatePackage(value) {
+ const failures = [];
+ const fail = (message) => failures.push(message);
+
+ if (!isPlainObject(value)) {
+ return ['entry must be a JSON object.'];
+ }
+ for (const field of REQUIRED_FIELDS) {
+ if (!(field in value)) fail(`missing required field "${field}".`);
+ }
+ for (const field of Object.keys(value)) {
+ if (!ALLOWED_FIELDS.has(field)) fail(`unknown field "${field}" (allowed: ${[...ALLOWED_FIELDS].join(', ')}).`);
+ }
+ if (failures.length) return failures;
+
+ if (!isString(value.name) || !NAME_PATTERN.test(value.name)) {
+ fail('name must be lowercase kebab-case (3-64 chars, letters/digits/hyphens).');
+ }
+ if (!PACKAGE_TYPES.includes(value.type)) {
+ fail(`type must be one of: ${PACKAGE_TYPES.join(', ')}.`);
+ }
+
+ if (!isPlainObject(value.summary)) {
+ fail('summary must be an object with "en" and "zh" strings.');
+ } else {
+ const { en, zh } = value.summary;
+ if (!isString(en) || en.length < 10 || en.length > 160) fail('summary.en must be 10-160 characters.');
+ if (!isString(zh) || zh.length < 6 || zh.length > 120) fail('summary.zh must be 6-120 characters.');
+ }
+
+ if (!isPlainObject(value.author) || !isString(value.author.name) || !value.author.name.trim()) {
+ fail('author must be an object with a non-empty "name".');
+ } else if ('url' in value.author && !isHttpsUrl(value.author.url)) {
+ fail('author.url must be an https:// URL.');
+ }
+
+ if (!isHttpsUrl(value.repository)) fail('repository must be an https:// URL.');
+ if (!isString(value.archify) || !ARCHIFY_RANGE_PATTERN.test(value.archify)) {
+ fail('archify must be a version range like ^3.0.1 or >=3.0.0 <4.0.0.');
+ }
+
+ if (!Array.isArray(value.schemaVersions) || value.schemaVersions.length === 0) {
+ fail('schemaVersions must be a non-empty array of positive integers.');
+ } else {
+ if (value.schemaVersions.some((entry) => !Number.isInteger(entry) || entry < 1)) {
+ fail('schemaVersions entries must be positive integers.');
+ }
+ if (new Set(value.schemaVersions).size !== value.schemaVersions.length) {
+ fail('schemaVersions entries must be unique.');
+ }
+ }
+
+ if ('homepage' in value && !isHttpsUrl(value.homepage)) fail('homepage must be an https:// URL.');
+
+ if ('tags' in value) {
+ if (!Array.isArray(value.tags) || value.tags.length > 6 || value.tags.some((tag) => !isString(tag) || !TAG_PATTERN.test(tag))) {
+ fail('tags must be at most 6 lowercase alphanumeric/hyphen strings.');
+ } else if (new Set(value.tags).size !== value.tags.length) {
+ fail('tags must be unique.');
+ }
+ }
+
+ if ('evidence' in value) {
+ if (!Array.isArray(value.evidence) || value.evidence.length > 8) {
+ fail('evidence must be an array of at most 8 {label, url} entries.');
+ } else {
+ value.evidence.forEach((item, index) => {
+ if (!isPlainObject(item) || !isString(item.label) || !item.label.trim() || !isHttpsUrl(item.url)) {
+ fail(`evidence[${index}] must be {label: string, url: https:// URL}.`);
+ }
+ });
+ }
+ }
+
+ return failures;
+}
+
+export function validateRegistry(root = repoRoot) {
+ const packagesDir = path.join(root, 'community', 'packages');
+ const failures = [];
+ const entries = [];
+ let files = [];
+ try {
+ files = fs.readdirSync(packagesDir).filter((entry) => entry.endsWith('.json')).sort();
+ } catch {
+ failures.push('community/packages/ is missing or unreadable.');
+ return { entries, failures };
+ }
+ if (files.length === 0) failures.push('community/packages/ contains no package metadata files.');
+
+ const seen = new Set();
+ for (const file of files) {
+ let value;
+ try {
+ value = JSON.parse(fs.readFileSync(path.join(packagesDir, file), 'utf8'));
+ } catch (error) {
+ failures.push(`${file}: not valid JSON (${error.message}).`);
+ continue;
+ }
+ for (const failure of validatePackage(value)) failures.push(`${file}: ${failure}`);
+ if (isPlainObject(value)) {
+ const expectedFile = `${value.name}.json`;
+ // path-contract-allow: portable-logical-path -- Registry file names are logical identifiers, not native paths.
+ if (isString(value.name) && file !== expectedFile) {
+ failures.push(`${file}: file name must match the name field (${expectedFile}).`);
+ }
+ if (seen.has(value.name)) failures.push(`${file}: duplicate package name "${value.name}".`);
+ seen.add(value.name);
+ entries.push(value);
+ }
+ }
+ return { entries, failures };
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+ const { entries, failures } = validateRegistry(repoRoot);
+ for (const failure of failures) console.error(`✗ ${failure}`);
+ if (failures.length) {
+ console.error(`\ncommunity registry: ${failures.length} problem(s) across ${entries.length} package(s).`);
+ process.exitCode = 1;
+ } else {
+ console.log(`community registry: ${entries.length} package(s) OK (${entries.map((entry) => entry.name).join(', ')}).`);
+ }
+}
diff --git a/website/src/components/Navigation.astro b/website/src/components/Navigation.astro
index 6476dbd7..f68b4eca 100644
--- a/website/src/components/Navigation.astro
+++ b/website/src/components/Navigation.astro
@@ -1,12 +1,13 @@
---
import Brand from './Brand';
-interface Props { page: 'index' | 'gallery' | 'guide' | 'start' }
+interface Props { page: 'index' | 'gallery' | 'guide' | 'start' | 'community' }
const { page } = Astro.props;
const home = page === 'index';
const identities = {
gallery: { en: '/ proof lab', zh: '/ 验证作品集', label: 'Back to Archify home' },
guide: { en: '/ guide', zh: '/ 场景指南', label: 'Archify home' },
start: { en: '/ start', zh: '/ 快速上手', label: 'Archify project page' },
+ community: { en: '/ community', zh: '/ 社区包', label: 'Archify home' },
};
const identity = home ? undefined : identities[page];
const guideKeys: Record<string, string> = { guide: 'navGuide', gallery: 'navProof', start: 'navStart' };
@@ -14,7 +15,12 @@ const links = [
{ page: 'guide', en: 'Guide', zh: '场景指南' },
{ page: 'gallery', en: 'Proof Lab', zh: '验证作品集' },
{ page: 'start', en: 'Start', zh: '快速上手' },
+ { page: 'community', en: 'Community', zh: '社区包' },
];
+// gallery/guide/start are deep-compared against the legacy docs/ baselines in
+// migration tests, so their navigation cannot change; the community link is
+// reachable from the index page and the community page itself.
+const visibleLinks = home || page === 'community' ? links : links.filter(link => link.page !== 'community');
---
<nav class="site-nav" aria-label="Primary navigation">
<a class="nav-logo" href={home ? '#' : './'} aria-label={identity?.label}>
@@ -22,7 +28,7 @@ const links = [
{identity && <span class="nav-logo-path" data-en={identity.en} data-zh={identity.zh}>{identity.en}</span>}
</a>
<div class="nav-right">
- {links.map(link => <a class="nav-link" href={`${link.page}.html`} aria-current={page === link.page ? 'page' : undefined} {...(home ? { 'data-i18n': `nav-${link.page}` } : page === 'guide' ? { 'data-i18n': guideKeys[link.page] } : { 'data-en': link.en, 'data-zh': link.zh })}>{link.en}</a>)}
+ {visibleLinks.map(link => <a class="nav-link" href={`${link.page}.html`} aria-current={page === link.page ? 'page' : undefined} {...(home ? { 'data-i18n': `nav-${link.page}` } : page === 'guide' ? { 'data-i18n': guideKeys[link.page] } : { 'data-en': link.en, 'data-zh': link.zh })}>{link.en}</a>)}
<a class="nav-link" href="https://github.com/tt-a1i/archify" target="_blank" rel="noopener">GitHub</a>
<button class={home ? 'btn btn-lang' : 'btn-lang'} id={home ? 'btn-lang' : 'language'} type={home ? undefined : 'button'} aria-label={home ? undefined : 'Switch language'}>中文</button>
<a class="btn btn-primary nav-cta" href={home ? '#quickstart' : page === 'start' ? '#install' : 'start.html'} {...(home ? { 'data-i18n': 'nav-install' } : page === 'guide' ? { 'data-i18n': 'navInstall' } : { 'data-en': 'Install Skill', 'data-zh': '安装技能' })}>Install Skill</a>
diff --git a/website/src/data/community-head.html b/website/src/data/community-head.html
new file mode 100644
index 00000000..03d7428d
--- /dev/null
+++ b/website/src/data/community-head.html
@@ -0,0 +1,12 @@
+
+ <meta charset="UTF-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="generator" content="archify community [[ARCHIFY_VERSION]]">
+ <title>Archify Community — Packages Built on Archify</title>
+ <meta name="description" content="A curated catalog of standalone community packages that build on Archify: skill packs, recipe libraries, brand kits, locale packs, and CLI wrappers. Submitted by PR, validated deterministically.">
+ <meta name="theme-color" content="#eff2f1">
+ <link rel="icon" type="image/svg+xml" href="assets/archify-mark.svg">
+ <link rel="preconnect" href="https://fonts.googleapis.com">
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+ <link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300;0,9..144,400;0,9..144,500;1,9..144,400&family=Inter:wght@400;450;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
+ <link rel="stylesheet" href="assets/site-navigation.css">
diff --git a/website/src/data/community.mjs b/website/src/data/community.mjs
new file mode 100644
index 00000000..1ad54101
--- /dev/null
+++ b/website/src/data/community.mjs
@@ -0,0 +1,21 @@
+// Derived from the community registry — community/packages/*.json is the
+// single source of truth; this page never hand-copies package metadata.
+// import.meta.glob is resolved by Vite at build time relative to this source
+// file, so the catalog cannot drift from the registry.
+
+const modules = import.meta.glob('../../../community/packages/*.json', { eager: true, import: 'default' });
+
+export const packages = Object.entries(modules)
+ .map(([file, value]) => {
+ if (!file.endsWith(`/${value.name}.json`)) {
+ throw new Error(`community registry: ${file} does not match name "${value.name}"`);
+ }
+ return value;
+ })
+ .sort((a, b) => a.name.localeCompare(b.name));
+
+export const typeOrder = ['skill', 'recipe', 'brand-marks', 'locale', 'wrapper'];
+export const typeCounts = Object.fromEntries([
+ ['all', packages.length],
+ ...typeOrder.map((type) => [type, packages.filter((entry) => entry.type === type).length]),
+]);
diff --git a/website/src/pages/community.astro b/website/src/pages/community.astro
new file mode 100644
index 00000000..aea5af38
--- /dev/null
+++ b/website/src/pages/community.astro
@@ -0,0 +1,140 @@
+---
+import { version, versioned } from '../data/site';
+import { packages, typeOrder, typeCounts } from '../data/community.mjs';
+import SiteLayout from '../layouts/SiteLayout.astro';
+import Navigation from '../components/Navigation.astro';
+import head from '../data/community-head.html?raw';
+import css from '../styles/community.css?raw';
+import pageScript from '../scripts/community.js?raw';
+
+const typeLabels: Record<string, { en: string; zh: string }> = {
+ skill: { en: 'Skill pack', zh: '技能包' },
+ recipe: { en: 'Recipes', zh: '场景配方' },
+ 'brand-marks': { en: 'Brand kit', zh: '品牌套件' },
+ locale: { en: 'Locale', zh: '语言包' },
+ wrapper: { en: 'Wrapper', zh: '命令行封装' },
+};
+const activeTypes = typeOrder.filter((type) => typeCounts[type] > 0);
+---
+<SiteLayout head={versioned(head)} css={css}>
+
+ <div class="grid-bg" aria-hidden="true"></div>
+
+ <Navigation page="community" />
+
+ <main>
+ <section class="hero">
+ <div class="shell hero-grid">
+ <div>
+ <div class="lead-label" data-en="Community registry / standalone packages" data-zh="社区注册表 / 独立包">Community registry / standalone packages</div>
+ <h1 data-en="Built on Archify.<br><em>Shared by everyone.</em>" data-zh="基于 Archify 构建,<br><em>由社区共享。</em>">Built on Archify.<br><em>Shared by everyone.</em></h1>
+ <p class="hero-copy" data-en="Community packages are standalone works that wrap the Archify CLI — skill packs, recipe libraries, brand kits, locales, and wrappers. Nothing here is a plugin: no third-party code ever runs inside the renderer." data-zh="社区包是围绕 Archify CLI 构建的独立产物——技能包、场景配方、品牌套件、语言包与命令行封装。这里没有插件:任何第三方代码都不会进入渲染器内部运行。">Community packages are standalone works that wrap the Archify CLI — skill packs, recipe libraries, brand kits, locales, and wrappers. Nothing here is a plugin: no third-party code ever runs inside the renderer.</p>
+ </div>
+ <div class="proof-board" aria-label="Registry summary">
+ <div class="proof-row"><span class="proof-value">{packages.length}</span><span class="proof-label" data-en="packages listed<br>from the registry" data-zh="个已收录包<br>来自注册表">packages listed<br>from the registry</span></div>
+ <div class="proof-row"><span class="proof-value">{activeTypes.length}</span><span class="proof-label" data-en="package types<br>in the catalog" data-zh="种包类型<br>收录中">package types<br>in the catalog</span></div>
+ <div class="proof-row"><span class="proof-value proof-status">PASS</span><span class="proof-label" data-en="metadata validated<br>deterministically" data-zh="元数据通过<br>确定性校验">metadata validated<br>deterministically</span></div>
+ </div>
+ </div>
+ </section>
+
+ <section class="controls" aria-label="Catalog controls">
+ <div class="shell controls-inner">
+ <div class="filter-group" role="group" aria-label="Filter packages by type">
+ <button class="filter-button" type="button" data-filter="all" aria-pressed="true" data-en={`All / ${typeCounts.all}`} data-zh={`全部 / ${typeCounts.all}`}>All / {typeCounts.all}</button>
+ {activeTypes.map((type) => (
+ <button class="filter-button" type="button" data-filter={type} aria-pressed="false" data-en={`${typeLabels[type].en} / ${typeCounts[type]}`} data-zh={`${typeLabels[type].zh} / ${typeCounts[type]}`}>{typeLabels[type].en} / {typeCounts[type]}</button>
+ ))}
+ </div>
+ <div class="controls-actions">
+ <div class="controls-note" data-en="Submitted by PR · maintained by their authors" data-zh="通过 PR 提交 · 由作者自行维护">Submitted by PR · maintained by their authors</div>
+ </div>
+ </div>
+ </section>
+
+ <section class="catalog-section" id="catalog">
+ <div class="shell">
+ <div class="section-intro">
+ <h2 data-en="The catalog." data-zh="目录。">The catalog.</h2>
+ <p data-en="Every entry is a metadata file in the Archify repository, merged by PR and revalidated on every change. Listing is not endorsement — evidence links speak for each package." data-zh="每个条目都是 Archify 仓库中的一个元数据文件,经 PR 合并并在每次变更时重新校验。收录不代表官方背书——证据链接为每个包说话。">Every entry is a metadata file in the Archify repository, merged by PR and revalidated on every change. Listing is not endorsement — evidence links speak for each package.</p>
+ </div>
+ <div class="type-ledger" role="group" aria-label="Filter by package type">
+ {typeOrder.map((type) => (
+ <button type="button" class={`ledger-cell badge-${type} ${typeCounts[type] === 0 ? 'is-open' : ''}`} data-filter={type} aria-pressed="false">
+ <span class="ledger-label" data-en={typeLabels[type].en} data-zh={typeLabels[type].zh}>{typeLabels[type].en}</span>
+ <span class="ledger-count">{typeCounts[type] > 0
+ ? typeCounts[type]
+ : <em data-en="open" data-zh="虚位以待">open</em>}</span>
+ </button>
+ ))}
+ </div>
+ <div class="package-grid" id="package-grid">
+ {packages.map((entry, index) => (
+ <article class={`package-card badge-${entry.type}`} data-type={entry.type} style={`--stagger:${index}`}>
+ <div class="package-card-head">
+ <span class="package-index">{String(index + 1).padStart(2, '0')}</span>
+ <span class="package-name">{entry.name}</span>
+ <span class="type-badge" data-en={typeLabels[entry.type].en} data-zh={typeLabels[entry.type].zh}>{typeLabels[entry.type].en}</span>
+ </div>
+ <p class="package-summary" data-en={entry.summary.en} data-zh={entry.summary.zh}>{entry.summary.en}</p>
+ <div class="package-meta">
+ <span class="meta-chip" title="Author">
+ <svg viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="5" r="2.6"/><path d="M2.8 13.4c.7-2.6 2.8-4 5.2-4s4.5 1.4 5.2 4"/></svg>
+ {entry.author.name}
+ </span>
+ <span class="meta-chip mono" title="Compatible Archify range">archify {entry.archify}</span>
+ <span class="meta-chip mono" title="Supported IR schema versions">IR v{entry.schemaVersions.join(' · v')}</span>
+ </div>
+ <div class="package-actions">
+ <a class="card-link" href={entry.repository} target="_blank" rel="noopener noreferrer" data-en="View source ↗" data-zh="查看源码 ↗">View source ↗</a>
+ {entry.evidence?.[0] && (
+ <a class="card-link subtle" href={entry.evidence[0].url} target="_blank" rel="noopener noreferrer" data-en={`${entry.evidence[0].label} ↗`} data-zh={`${entry.evidence[0].label} ↗`}>{entry.evidence[0].label} ↗</a>
+ )}
+ </div>
+ </article>
+ ))}
+ </div>
+ <div class="empty-state" id="empty-state" data-en="No packages match this filter." data-zh="当前筛选条件下没有收录包。">No packages match this filter.</div>
+ </div>
+ </section>
+
+ <section class="method">
+ <div class="shell method-grid">
+ <div>
+ <div class="lead-label" data-en="Join the registry" data-zh="加入注册表">Join the registry</div>
+ <h2 data-en="A pull request is the submission." data-zh="一次 PR 就是提交。">A pull request is the submission.</h2>
+ <div class="pipeline" aria-label="Submission pipeline">
+ <div class="pipeline-step"><span class="pipeline-num">01</span><span class="pipeline-label" data-en="Publish your package in your own repo" data-zh="在你自己的仓库发布你的包">Publish your package in your own repo</span><span class="pipeline-state you">YOU</span></div>
+ <div class="pipeline-step"><span class="pipeline-num">02</span><span class="pipeline-label" data-en="Add one metadata file under community/packages/" data-zh="在 community/packages/ 下添加一个元数据文件">Add one metadata file under community/packages/</span><span class="pipeline-state you">YOU</span></div>
+ <div class="pipeline-step"><span class="pipeline-num">03</span><span class="pipeline-label" data-en="Validate with check-community-packages.mjs" data-zh="运行 check-community-packages.mjs 校验">Validate with check-community-packages.mjs</span><span class="pipeline-state">PASS</span></div>
+ <div class="pipeline-step"><span class="pipeline-num">04</span><span class="pipeline-label" data-en="Open a PR targeting dev — merge means listed" data-zh="向 dev 分支提 PR——合并即收录">Open a PR targeting dev — merge means listed</span><span class="pipeline-state">PASS</span></div>
+ </div>
+ </div>
+ <div class="method-code">
+ <div class="method-code-bar"><span>submit locally</span><span>zero dependencies</span></div>
+ <pre><span class="accent">$ node scripts/check-community-packages.mjs</span>
+
+community registry: {packages.length} package(s) OK
+ {packages.map((entry) => entry.name).join(', ')}
+
+<span class="accent">$ git checkout -b community/my-pack origin/dev</span>
+
+# add community/packages/my-pack.json
+# open PR → review → listed here</pre>
+ <a class="card-link method-link" href="https://github.com/tt-a1i/archify/tree/main/community" target="_blank" rel="noopener noreferrer" data-en="Read the submission guide ↗" data-zh="阅读提交指南 ↗">Read the submission guide ↗</a>
+ </div>
+ </div>
+ </section>
+ </main>
+
+ <footer>
+ <div class="shell footer-inner">
+ <span data-en="Community packages are maintained by their authors. Listing is not endorsement; Archify never executes package code." data-zh="社区包由各自作者维护。收录不代表官方背书;Archify 绝不执行第三方包的代码。">Community packages are maintained by their authors. Listing is not endorsement; Archify never executes package code.</span>
+ <span data-en={`Archify v${version} · stable · MIT`} data-zh={`Archify v${version} · 稳定版 · MIT`}>Archify v{version} · stable · MIT</span>
+ </div>
+ </footer>
+
+ <script is:inline src="assets/site-language.js"></script>
+ <script is:inline set:html={versioned(pageScript)}></script>
+
+</SiteLayout>
diff --git a/website/src/scripts/community.js b/website/src/scripts/community.js
new file mode 100644
index 00000000..ab256c71
--- /dev/null
+++ b/website/src/scripts/community.js
@@ -0,0 +1,63 @@
+
+ (function () {
+ var cards = Array.prototype.slice.call(document.querySelectorAll('.package-card'));
+ var filterButtons = Array.prototype.slice.call(document.querySelectorAll('[data-filter]'));
+ var empty = document.getElementById('empty-state');
+ var language = ArchifySiteLanguage.read();
+
+ function applyLanguage(next) {
+ language = ArchifySiteLanguage.write(next);
+ document.documentElement.lang = language === 'zh' ? 'zh-CN' : 'en';
+ document.querySelectorAll('[data-en][data-zh]').forEach(function (node) {
+ node.innerHTML = node.getAttribute(language === 'zh' ? 'data-zh' : 'data-en');
+ });
+ var languageButton = document.getElementById('language');
+ languageButton.textContent = language === 'zh' ? 'EN' : '中文';
+ languageButton.setAttribute('aria-label', language === 'zh' ? 'Switch to English' : '切换到中文');
+ }
+
+ function applyFilter(type, updateUrl) {
+ var visible = 0;
+ cards.forEach(function (card) {
+ var match = type === 'all' || card.getAttribute('data-type') === type;
+ card.hidden = !match;
+ if (match) visible += 1;
+ });
+ filterButtons.forEach(function (button) {
+ button.setAttribute('aria-pressed', button.getAttribute('data-filter') === type ? 'true' : 'false');
+ });
+ empty.classList.toggle('visible', visible === 0);
+ if (updateUrl) {
+ var url = new URL(location.href);
+ if (type === 'all') url.searchParams.delete('type');
+ else url.searchParams.set('type', type);
+ history.replaceState(null, '', url.pathname + url.search + url.hash);
+ }
+ }
+
+ filterButtons.forEach(function (button) {
+ button.addEventListener('click', function () { applyFilter(button.getAttribute('data-filter'), true); });
+ });
+ document.getElementById('language').addEventListener('click', function () { applyLanguage(language === 'en' ? 'zh' : 'en'); });
+
+ var allowed = ['all'].concat(Array.prototype.slice.call(document.querySelectorAll('[data-filter]')).map(function (button) {
+ return button.getAttribute('data-filter');
+ }).filter(function (type) { return type !== 'all'; }));
+ var requested = new URLSearchParams(location.search).get('type') || 'all';
+ applyFilter(allowed.indexOf(requested) >= 0 ? requested : 'all', false);
+ applyLanguage(language);
+
+ if ('IntersectionObserver' in window) {
+ var observer = new IntersectionObserver(function (entries) {
+ entries.forEach(function (entry) {
+ if (entry.isIntersecting) {
+ entry.target.classList.add('visible');
+ observer.unobserve(entry.target);
+ }
+ });
+ }, { threshold: 0.08 });
+ cards.forEach(function (card) { observer.observe(card); });
+ } else {
+ cards.forEach(function (card) { card.classList.add('visible'); });
+ }
+ })();
diff --git a/website/src/scripts/index.js b/website/src/scripts/index.js
index 983788cb..8767748e 100644
--- a/website/src/scripts/index.js
+++ b/website/src/scripts/index.js
@@ -4,7 +4,7 @@
══════════════════════════════════════ */
const LANGS = {
en: {
- 'nav-guide':'Guide','nav-gallery':'Proof Lab','nav-start':'Start','nav-install':'Install Skill',
+ 'nav-guide':'Guide','nav-gallery':'Proof Lab','nav-start':'Start','nav-community':'Community','nav-install':'Install Skill',
'hero-badge':'Agent Skill &nbsp;·&nbsp; stable &nbsp;·&nbsp; v[[ARCHIFY_VERSION]]',
'hero-h1':'From plain English<br>to architecture <em>you can trust.</em>',
'hero-sub':'Describe your system in chat. Archify generates a polished, explorable HTML diagram — with progressive MAP → READ → FULL detail, a semantic camera, path-aware stories, motion, and ultra-crisp export built in.',
@@ -64,7 +64,7 @@
'footer-changelog':'Changelog','footer-license':'License'
},
zh: {
- 'nav-guide':'场景指南','nav-gallery':'验证作品集','nav-start':'快速上手','nav-install':'安装技能',
+ 'nav-guide':'场景指南','nav-gallery':'验证作品集','nav-start':'快速上手','nav-community':'社区包','nav-install':'安装技能',
'hero-badge':'Agent 技能 &nbsp;·&nbsp; 稳定版 &nbsp;·&nbsp; v[[ARCHIFY_VERSION]]',
'hero-h1':'用自然语言,<br>生成<em>可信的架构图。</em>',
'hero-sub':'在对话中描述你的系统,Archify 生成精美、可探索的 HTML 技术图——信息会按 MAP → READ → FULL 渐进展开,并内置语义镜头、路径故事、动态效果和超清导出。',
diff --git a/website/src/styles/community.css b/website/src/styles/community.css
new file mode 100644
index 00000000..56db202e
--- /dev/null
+++ b/website/src/styles/community.css
@@ -0,0 +1,218 @@
+
+ :root {
+ /* Drafted-sheet palette — shared with the other site pages */
+ --paper-site:#eff2f1; --paper-raised:#f8faf9;
+ --ink-site:#15181b; --ink-soft:#363c41; --muted:#60686d; --dim:#929a9e;
+ --line:rgba(20,23,26,0.14); --line-hi:rgba(20,23,26,0.3);
+ --accent-site:#e14a0e; --accent-soft:rgba(225,74,14,0.08);
+ --plate:#0f1216;
+ --emerald:#047857;
+ --font-display:'Fraunces','Songti SC','STSong',Georgia,serif;
+ --font-body:'Inter',-apple-system,BlinkMacSystemFont,'PingFang SC','Hiragino Sans GB','Microsoft YaHei',sans-serif;
+ --font-mono:'JetBrains Mono',ui-monospace,SFMono-Regular,Menlo,monospace;
+ --ease-out:cubic-bezier(.22,1,.36,1);
+ --content: 1320px;
+ }
+ *,*::before,*::after { margin:0; padding:0; box-sizing:border-box; }
+ html { scroll-behavior: smooth; }
+ body {
+ font-family:var(--font-body);
+ -webkit-font-smoothing:antialiased; text-rendering:optimizeLegibility;
+ background:var(--paper-site); color:var(--ink-site); min-height:100vh; overflow-x:hidden;
+ }
+ body::after {
+ content:''; position:fixed; inset:0; z-index:1000; pointer-events:none;
+ opacity:.05; mix-blend-mode:multiply;
+ background-image:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='140' height='140'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2' stitchTiles='stitch'/></filter><rect width='140' height='140' filter='url(%23n)'/></svg>");
+ }
+ ::selection { background:rgba(225,74,14,.18); color:var(--ink-site); }
+ a { color: inherit; }
+ button, a { -webkit-tap-highlight-color: transparent; }
+ button { font:inherit; }
+ :focus-visible { outline: 2px solid var(--accent-site); outline-offset: 3px; border-radius:4px; }
+
+ .grid-bg {
+ position:fixed; inset:0; z-index:0; pointer-events:none;
+ background-image:linear-gradient(rgba(20,23,26,.045) 1px,transparent 1px),linear-gradient(90deg,rgba(20,23,26,.045) 1px,transparent 1px);
+ background-size:56px 56px;
+ -webkit-mask-image:radial-gradient(ellipse 95% 62% at 50% -6%, black 12%, transparent 75%);
+ mask-image:radial-gradient(ellipse 95% 62% at 50% -6%, black 12%, transparent 75%);
+ }
+ .shell { position:relative; z-index:1; width: min(var(--content), calc(100% - 48px)); margin: 0 auto; }
+
+ /* HERO */
+ .hero { padding: 10rem 0 4.5rem; }
+ .hero-grid { display: grid; grid-template-columns: minmax(0, 1.45fr) minmax(310px, 0.55fr); gap: 4.5rem; align-items: end; }
+ .lead-label { display:flex; align-items:center; gap:.875rem; margin-bottom:1.5rem; font-family:var(--font-mono); font-size:.625rem; font-weight:500; letter-spacing:.2em; color:var(--muted); text-transform:uppercase; }
+ .lead-label::before { content:''; width:2.75rem; height:1px; background:var(--line-hi); }
+ .hero h1 {
+ max-width: 860px;
+ font-family:var(--font-display); font-optical-sizing:auto;
+ font-size: clamp(2.75rem, 6vw, 5rem);
+ font-weight:400; line-height: 1.02; letter-spacing: -.03em;
+ color:var(--ink-site); text-wrap: balance;
+ }
+ .hero h1 em { font-style:italic; color: var(--accent-site); }
+ .hero-copy { margin-top: 1.5rem; max-width: 640px; color: var(--muted); font-size: .9375rem; line-height: 1.72; text-wrap:pretty; }
+ .proof-board { border:1px solid var(--line-hi); border-radius:12px; background:var(--paper-raised); overflow:hidden; }
+ .proof-row { min-height: 64px; display: grid; grid-template-columns: 88px 1fr; align-items: center; gap:1rem; padding:.9rem 1.25rem; border-bottom: 1px solid var(--line); }
+ .proof-row:last-child { border-bottom:0; }
+ .proof-value { font-family:var(--font-display); font-style:italic; font-optical-sizing:auto; font-weight:400; font-size: 1.625rem; line-height:1; color: var(--ink-site); }
+ .proof-label { color: var(--dim); font-family:var(--font-mono); font-size: .5625rem; line-height: 1.5; letter-spacing: .12em; text-transform: uppercase; }
+ .proof-status { display: inline-flex; align-items: center; gap: .5rem; color: var(--emerald); font-style:normal; font-family:var(--font-mono); font-size:.8125rem; font-weight:600; letter-spacing:.08em; }
+ .proof-status::before { content: ''; width: 6px; height: 6px; border-radius: 50%; background: var(--emerald); }
+
+ /* CONTROLS */
+ .controls { padding: 1.25rem 0; border-top:1px solid var(--line); border-bottom: 1px solid var(--line); }
+ .controls-inner { display: flex; align-items: center; justify-content: space-between; gap: 1.5rem; }
+ .filter-group { display: flex; align-items: center; flex-wrap: wrap; gap: .45rem; }
+ .controls-actions { display:flex; align-items:center; justify-content:flex-end; gap:1rem; }
+ .filter-button {
+ min-height: 44px;
+ padding: 0 .85rem;
+ border: 1px solid var(--line-hi);
+ border-radius: 999px;
+ background: transparent;
+ color: var(--muted);
+ font-family:var(--font-mono); font-size:.5625rem; font-weight:500; letter-spacing:.12em; text-transform:uppercase;
+ cursor: pointer;
+ transition:all .18s var(--ease-out);
+ }
+ .filter-button:hover { color: var(--ink-site); border-color:var(--ink-site); }
+ .filter-button[aria-pressed="true"] { color: var(--paper-site); background:var(--ink-site); border-color:var(--ink-site); }
+ .controls-note { color: var(--dim); font-family:var(--font-mono); font-size: .5625rem; letter-spacing: .12em; text-align: right; text-transform: uppercase; }
+
+ /* CATALOG */
+ .catalog-section { padding: 4rem 0 3.5rem; }
+ .section-intro { display: flex; justify-content: space-between; align-items: end; gap: 2rem; margin-bottom: 1.75rem; }
+ .section-intro h2 { font-family:var(--font-display); font-optical-sizing:auto; font-size: clamp(1.75rem, 3.4vw, 2.75rem); font-weight:400; letter-spacing: -.026em; color:var(--ink-site); }
+ .section-intro p { max-width: 480px; color: var(--muted); font-size: .8125rem; line-height: 1.7; text-align: right; }
+ .type-ledger { display: grid; grid-template-columns: repeat(5, minmax(0, 1fr)); gap: 1px; margin-bottom: 14px; background: var(--line); border: 1px solid var(--line-hi); border-radius: 10px; overflow: hidden; }
+ .ledger-cell { display: flex; align-items: center; justify-content: space-between; gap: .75rem; padding: .7rem .95rem; border: 0; background: var(--paper-raised); cursor: pointer; text-align: left; transition: background .18s var(--ease-out); }
+ .ledger-cell:hover { background: var(--accent-soft); }
+ .ledger-cell[aria-pressed="true"] { background: var(--ink-site); }
+ .ledger-cell[aria-pressed="true"] .ledger-label { color: var(--paper-site); }
+ .ledger-cell[aria-pressed="true"] .ledger-count { color: var(--paper-site); }
+ .ledger-cell[aria-pressed="true"].is-open .ledger-count em { color: var(--dim); }
+ .ledger-label { display: inline-flex; align-items: center; gap: .5rem; color: var(--ink-soft); font-family: var(--font-mono); font-size: .5625rem; font-weight: 600; letter-spacing: .12em; text-transform: uppercase; }
+ .ledger-label::before { content:''; width: 5px; height: 5px; border-radius: 50%; background: var(--badge); }
+ .ledger-count { font-family: var(--font-display); font-style: italic; font-optical-sizing: auto; font-size: .9375rem; color: var(--ink-site); }
+ .ledger-cell.is-open .ledger-label { color: var(--dim); }
+ .ledger-cell.is-open .ledger-label::before { background: transparent; box-shadow: inset 0 0 0 1px var(--line-hi); }
+ .ledger-cell.is-open .ledger-count em { font-style: italic; font-family: var(--font-mono); font-size: .5625rem; letter-spacing: .12em; text-transform: uppercase; color: var(--dim); }
+ .package-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 14px; }
+ .package-card {
+ --badge: var(--accent-site);
+ min-width: 0;
+ position: relative;
+ display: flex;
+ flex-direction: column;
+ border: 1px solid var(--line-hi);
+ border-radius: 14px;
+ background: var(--paper-raised);
+ overflow: hidden;
+ opacity: 0;
+ transform: translateY(18px);
+ transition: opacity .5s var(--ease-out), transform .5s var(--ease-out), border-color .2s var(--ease-out), box-shadow .2s var(--ease-out);
+ transition-delay: calc(var(--stagger, 0) * 60ms), calc(var(--stagger, 0) * 60ms), 0s, 0s;
+ }
+ .package-card::before {
+ content:''; position:absolute; top:0; left:0; right:0; height:2px;
+ background: var(--badge); opacity:.85;
+ }
+ .package-card.visible { opacity: 1; transform: translateY(0); transition-delay: 0s; }
+ .package-card.visible:hover { transform: translateY(-4px); }
+ .package-card:hover { border-color: var(--ink-site); box-shadow:0 22px 54px rgba(20,23,26,.12); }
+ .package-card[hidden] { display: none; }
+ .badge-skill { --badge: #e14a0e; }
+ .badge-recipe { --badge: #047857; }
+ .badge-brand-marks { --badge: #7c3aed; }
+ .badge-locale { --badge: #2563eb; }
+ .badge-wrapper { --badge: #475569; }
+ .package-card-head { display: flex; align-items: center; gap: .875rem; padding: 1.375rem 1.5rem 0; }
+ .package-index { font-family: var(--font-display); font-style: italic; font-optical-sizing: auto; font-size: 1rem; color: var(--dim); }
+ .package-name { flex: 1; min-width: 0; font-family:var(--font-mono); font-size: .9375rem; font-weight:600; letter-spacing:-.01em; color: var(--ink-site); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+ .type-badge {
+ flex-shrink: 0;
+ display: inline-flex; align-items: center; gap: .45rem;
+ padding: .34rem .6rem;
+ border: 1px solid color-mix(in srgb, var(--badge) 38%, transparent);
+ border-radius: 999px;
+ background: color-mix(in srgb, var(--badge) 7%, transparent);
+ color: var(--badge);
+ font-family:var(--font-mono); font-size: .5625rem; font-weight:600; letter-spacing: .12em; text-transform: uppercase;
+ }
+ .type-badge::before { content:''; width: 5px; height: 5px; border-radius: 50%; background: currentColor; }
+ .package-summary { flex: 1; padding: .9rem 1.5rem 1.25rem; color: var(--muted); font-size: .8125rem; line-height: 1.7; text-wrap:pretty; }
+ .package-meta { display: flex; align-items: center; flex-wrap: wrap; gap: .4rem; padding: 0 1.5rem 1.125rem; }
+ .meta-chip {
+ display: inline-flex; align-items: center; gap: .4rem;
+ padding: .34rem .55rem;
+ border: 1px solid var(--line);
+ border-radius: 6px;
+ color: var(--dim);
+ font-size: .625rem; font-weight: 500;
+ }
+ .meta-chip svg { width: 11px; height: 11px; fill: none; stroke: currentColor; stroke-width: 1.5; stroke-linecap: round; }
+ .meta-chip.mono { font-family: var(--font-mono); font-size: .5625rem; letter-spacing: .04em; }
+ .package-actions { display: flex; align-items: center; flex-wrap: wrap; gap: .55rem; margin-top: auto; padding: 1.125rem 1.5rem; border-top: 1px solid var(--line); }
+ .card-link { min-height: 40px; display: inline-flex; align-items: center; justify-content: center; gap: .5rem; padding: 0 .9rem; border: 1px solid var(--line-hi); border-radius: 8px; color: var(--ink-soft); font-size: .75rem; font-weight: 500; text-decoration: none; transition: all .2s var(--ease-out); }
+ .card-link:hover { color: var(--ink-site); border-color: var(--ink-site); }
+ .card-link.subtle { border-color: var(--line); color: var(--muted); }
+ .card-link.subtle:hover { color: var(--ink-site); border-color: var(--ink-site); }
+ .empty-state { display: none; margin-top:14px; padding: 4rem 1.5rem; border: 1px dashed var(--line-hi); border-radius:14px; color: var(--muted); text-align: center; font-size: .8125rem; }
+ .empty-state.visible { display: block; }
+
+ /* METHOD */
+ .method { border-top: 1px solid var(--line); padding: 4.5rem 0; }
+ .method-grid { display: grid; grid-template-columns: 0.8fr 1.2fr; gap: 4.5rem; }
+ .method h2 { font-family:var(--font-display); font-optical-sizing:auto; font-size: clamp(1.5rem,2.6vw,2.25rem); font-weight:400; letter-spacing: -.026em; color:var(--ink-site); }
+ .pipeline { margin-top: 1.75rem; display: grid; gap: 1px; background: var(--line); border: 1px solid var(--line-hi); border-radius:12px; overflow:hidden; }
+ .pipeline-step { display: grid; grid-template-columns: 44px 1fr auto; align-items: center; gap: 1rem; min-height: 56px; padding: 0 1.125rem; background: var(--paper-raised); }
+ .pipeline-num { color: var(--accent-site); font-family:var(--font-mono); font-size: .625rem; font-weight:600; }
+ .pipeline-label { font-size: .8125rem; color:var(--ink-soft); }
+ .pipeline-state { color: var(--emerald); font-family:var(--font-mono); font-size: .5625rem; font-weight:600; letter-spacing: .12em; text-transform: uppercase; }
+ .pipeline-state.you { color: var(--dim); }
+ .method-code { border: 1px solid var(--ink-site); border-radius:12px; overflow:hidden; background: var(--plate); align-self:start; }
+ .method-code-bar { display: flex; justify-content: space-between; padding: .7rem 1rem; border-bottom: 1px solid rgba(232,237,242,.1); color: #7d8894; font-family:var(--font-mono); font-size: .5625rem; letter-spacing: .14em; text-transform: uppercase; }
+ .method-code pre { margin: 0; padding: 1.5rem; color: #aab3bb; font: 500 .6875rem/1.9 var(--font-mono); white-space: pre-wrap; }
+ .method-code pre::after { content: '▍'; color: var(--accent-site); animation: caret-blink 1.1s steps(1) infinite; }
+ @keyframes caret-blink { 50% { opacity: 0; } }
+ .method-code .accent { color: var(--accent-site); }
+ .method-link { margin: 0 1.5rem 1.5rem; border-color: rgba(232,237,242,.22); color: #aab3bb; }
+ .method-link:hover { border-color: #e8edf2; color: #e8edf2; }
+
+ footer { border-top: 1px solid var(--line); padding: 1.75rem 0 2.5rem; color: var(--dim); font-family:var(--font-mono); font-size: .625rem; letter-spacing:.04em; }
+ .footer-inner { display: flex; justify-content: space-between; gap: 1.5rem; }
+
+ @media (max-width: 1100px) {
+ .package-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+ .type-ledger { grid-template-columns: repeat(3, minmax(0, 1fr)); }
+ }
+ @media (max-width: 960px) {
+ .hero-grid, .method-grid { grid-template-columns: 1fr; gap: 2.5rem; }
+ .proof-board { display: grid; grid-template-columns: repeat(3, 1fr); }
+ .proof-row { grid-template-columns: 1fr; align-content: center; gap: .35rem; border-bottom:0; border-right: 1px solid var(--line); }
+ .proof-row:last-child { border-right:0; }
+ }
+ @media (max-width: 640px) {
+ .shell { width: min(100% - 28px, var(--content)); }
+ .hero { padding: 7.5rem 0 3rem; }
+ .hero h1 { font-size: clamp(2.25rem, 11vw, 3rem); }
+ .proof-board { grid-template-columns: 1fr; }
+ .proof-row { grid-template-columns: 72px 1fr; min-height: 54px; border-right: 0; border-bottom:1px solid var(--line); }
+ .proof-row:last-child { border-bottom:0; }
+ .controls-inner, .section-intro { align-items: flex-start; flex-direction: column; }
+ .controls-actions { width:100%; justify-content:space-between; }
+ .controls-note, .section-intro p { text-align: left; }
+ .filter-group { width: 100%; overflow-x: auto; flex-wrap: nowrap; padding-bottom: 4px; }
+ .package-grid { grid-template-columns: 1fr; }
+ .type-ledger { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+ .method { padding: 3.25rem 0; }
+ .footer-inner { flex-direction: column; }
+ }
+ @media (prefers-reduced-motion: reduce) {
+ html { scroll-behavior: auto; }
+ .package-card { opacity:1; transform:none; transition:none; }
+ .method-code pre::after { animation: none; }
+ }
diff --git a/website/test/community.test.mjs b/website/test/community.test.mjs
new file mode 100644
index 00000000..f84e62d6
--- /dev/null
+++ b/website/test/community.test.mjs
@@ -0,0 +1,81 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse } from 'parse5';
+
+const root = fileURLToPath(new URL('../', import.meta.url));
+const repoRoot = path.resolve(root, '..');
+const registryDir = path.join(repoRoot, 'community', 'packages');
+const dist = path.join(root, 'dist');
+
+const registry = fs.readdirSync(registryDir).filter((entry) => entry.endsWith('.json')).sort()
+ .map((file) => JSON.parse(fs.readFileSync(path.join(registryDir, file), 'utf8')));
+
+function elements(node, tag) {
+ return [...(node.tagName === tag ? [node] : []), ...(node.childNodes || []).flatMap((child) => elements(child, tag))];
+}
+function attr(node, name) {
+ return node?.attrs?.find((attribute) => attribute.name === name)?.value;
+}
+function hasClass(node, name) {
+ return (attr(node, 'class') || '').split(/\s+/).includes(name);
+}
+
+function communityDom() {
+ const file = path.join(dist, 'community.html');
+ assert.ok(fs.existsSync(file), 'dist/community.html must exist — run npm run build first');
+ return parse(fs.readFileSync(file, 'utf8'));
+}
+
+test('community catalog: renders one card per registry package, derived not hand-pasted', () => {
+ const dom = communityDom();
+ const cards = elements(dom, 'article').filter((node) => hasClass(node, 'package-card'));
+ assert.equal(cards.length, registry.length, 'card count must match community/packages/*.json');
+
+ const names = cards.map((card) => {
+ const nameNode = elements(card, 'span').find((node) => hasClass(node, 'package-name'));
+ return nameNode.childNodes.map((child) => child.value || '').join('').trim();
+ }).sort();
+ assert.deepEqual(names, registry.map((entry) => entry.name).sort());
+
+ for (const card of cards) {
+ const type = attr(card, 'data-type');
+ assert.ok(['skill', 'recipe', 'brand-marks', 'locale', 'wrapper'].includes(type), `card type ${type}`);
+ const summary = elements(card, 'p').find((node) => hasClass(node, 'package-summary'));
+ assert.ok(attr(summary, 'data-en') && attr(summary, 'data-zh'), 'summary must carry both locales');
+ const link = elements(card, 'a').find((node) => hasClass(node, 'card-link'));
+ assert.ok((attr(link, 'href') || '').startsWith('https://'), 'card must link to the package repository');
+ }
+});
+
+test('community catalog: filter buttons cover the types present in the registry', () => {
+ const dom = communityDom();
+ const pillButtons = elements(dom, 'button').filter((node) => attr(node, 'data-filter') && hasClass(node, 'filter-button'));
+ const filters = pillButtons.map((node) => attr(node, 'data-filter'));
+ assert.ok(filters.includes('all'));
+ for (const type of new Set(registry.map((entry) => entry.type))) {
+ assert.ok(filters.includes(type), `missing filter for type ${type}`);
+ }
+ assert.ok(pillButtons.every((node) => attr(node, 'data-en') && attr(node, 'data-zh')), 'filter buttons must be bilingual');
+
+ const ledgerButtons = elements(dom, 'button').filter((node) => attr(node, 'data-filter') && hasClass(node, 'ledger-cell'));
+ assert.deepEqual(
+ ledgerButtons.map((node) => attr(node, 'data-filter')),
+ ['skill', 'recipe', 'brand-marks', 'locale', 'wrapper'],
+ 'type ledger must offer every package type as a filter',
+ );
+});
+
+test('community catalog: navigation, language toggle and disclaimer are present', () => {
+ const dom = communityDom();
+ const links = elements(dom, 'a').map((node) => attr(node, 'href'));
+ assert.ok(links.includes('community.html'), 'primary navigation must link to community.html');
+ const languageButton = elements(dom, 'button').find((node) => attr(node, 'id') === 'language');
+ assert.ok(languageButton, 'language toggle must be present');
+ const html = fs.readFileSync(path.join(dist, 'community.html'), 'utf8');
+ assert.match(html, /Listing is not endorsement/, 'must carry the no-endorsement disclaimer');
+ const submission = elements(dom, 'a').find((node) => (attr(node, 'href') || '').includes('github.com/tt-a1i/archify/tree/main/community'));
+ assert.ok(submission, 'must link to the submission guide');
+});