Canon / foundations

rule.foundations.platform-literacy · canon

Respect platform grammar before brand divergence

Apple/Material/Web conventions are baseline literacy; brand divergence must be intentional and complete.

Guidance

Load platform foundations (safe area, focus, type scaling, materials) before inventing custom chrome.

Verification contract

platform-literacy module present

Supporting references

• ref.apple.hig-foundations — Apple HIG Foundations
• ref.apple.hig — Apple Human Interface Guidelines
• ref.freee.vibes — Vibes Design System
• ref.google.android-adaptive-layout — Build adaptive apps — Android Developers
• ref.google.material-3 — Material Design 3
• ref.google.material-motion — Material 3 Motion — How it works

Implementations and verification artifacts

• artifact.doc.platform-literacy — Platform literacy doc · design-system/foundations/platform-literacy.md
• artifact.script.design-decision-contract — Executable design decision contracts script · packages/core/src/design-contracts.ts