docs: archify

2026-08-24 19:34:16 -03:00
parent 23de7d8fe7
commit d2d1aad001
180 changed files with 216559 additions and 5766 deletions
@@ -0,0 +1,31 @@
+# Built-in brand marks
+
+Archify ships a bounded catalogue of 107 commonly used brands for architecture,
+workflow, sequence, data-flow, and lifecycle nodes. The mark is optional authored
+identity: it never replaces the node's semantic `type`, color, label, or
+relationships.
+
+Unknown sites are handled by an explicit two-stage workflow. Run
+`node bin/archify.mjs brands capture <url> --json`, then author the returned
+digest-pinned `brand` value. Normal render and validate commands do not perform
+an unpinned capture, and changed or unavailable content fails closed.
+
+Most vector paths and brand metadata are generated from Simple Icons 16.28.0.
+The OpenAI mark is traced to OpenAI's official brand guidelines. Every generated
+entry records its source and, when available upstream, its guidelines and license
+metadata in `renderers/shared/generated-brand-marks.mjs`.
+
+Brand names and logos may be trademarks of their respective owners. Simple
+Icons' CC0 license covers its collection work, not every underlying trademark or
+artwork. Contributors must review the recorded source, current brand guidelines,
+and intended referential use before adding or updating a mark. Archify does not
+imply sponsorship, endorsement, or partnership.
+
+Edit `catalog.json`, then regenerate the committed zero-runtime-dependency bundle:
+
+```bash
+npm run generate:brand-marks
+npm run check:brand-marks
+```
+
+Do not hand-edit `renderers/shared/generated-brand-marks.mjs`.