Design Knowledge Base
Community-maintained principles reviewed before publication and retrieved as Agent design constraints.
Deterministic Avatar Placeholder Governance
Avatar generators such as Boring Avatars and DiceBear work well for identity placeholders, but seed, style, license, private inputs, and accessible names must be recorded; generated avatars are not real likenesses or brand assets.
The value of a deterministic avatar is stable object recognition, not real identity. It combines visual distinction, privacy, licensing, accessible labeling, and cross-project reuse boundaries.95%Resource Licensingbrand-logo / trademarkBrand Logo Use Boundaries
Brand logos should be used only for real brand references, integrations, payment methods, customer or partner proof, or authorized collaboration. Confirm trademark and brand guidelines, avoid implied endorsement, do not alter shape or color casually, and provide accessible names.
A brand logo is not an ordinary icon. The code license of an open-source project, aggregator, or SVG package usually does not replace trademark, brand-guideline, endorsement-context, and usage-scope judgment.95%Resource Licensingicons / licenseIcon Set License, Trademark, and Accessibility Governance
Icons are not arbitrary decoration; primary icon sets, aggregated icons, brand logos, and icon-only controls need separate license, trademark, import, and accessibility rules.
Icon governance keeps symbols visually consistent, legally reusable, screen-reader understandable, tree-shakable, and prevents brand logos from becoming free decoration or implied endorsement.95%Resource Licensingvideo / motionStock Video Hero and Background Governance
Free stock video can make heroes feel more real, but each use must confirm item license, likeness/trademark/property rights, attribution, poster, pause control, reduced motion, and mobile performance.
Background video is not moving wallpaper. It belongs in production only when it serves first-viewport signal, brand tone, or story evidence without weakening readability, accessibility, licensing, or performance.95%Resource Licensingillustration / empty-stateFriendly Asset Governance for Empty States
Illustrations, emoji, and Lottie can make empty states friendlier, but they must first serve reason, next action, license record, alt text, and reduced-motion.
Friendly assets are not the main actor in an empty state. They reinforce tone, reduce anxiety, or aid understanding; the real interface value is clear reason, next action, and legally reusable asset metadata.95%