{
  "id": "apple",
  "version": "1.0.0",
  "name": "Apple",
  "description": "Apple Inc. is a global technology company whose product portfolio spans personal computers (Mac), mobile devices (iPhone, iPad, Apple Watch, Apple TV, Vision Pro), services (App Store, iCloud, Apple Music, Apple TV+), and the software platforms that bind them (macOS, iOS, iPadOS, watchOS, tvOS, visionOS). The visual identity is built around restraint: the monochrome Apple mark, the SF type family, and the twelve System Colors that the Human Interface Guidelines releases as a coordinated set. The voice is precise, considered, and human-centered — clarity and deference to content over decoration.\n",
  "provenance": {
    "source": "https://developer.apple.com/design/human-interface-guidelines/",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "Apple, the Apple logo, iPhone, iPad, Mac, iOS, macOS, iPadOS, watchOS, tvOS, visionOS, Human Interface Guidelines, and related names and marks are trademarks of Apple Inc. Brand colors and identity guidance documented here are derived from the Human Interface Guidelines at developer.apple.com/design/human-interface-guidelines/ and the Apple Identity Guidelines distributed to platform partners.\n",
    "importedDate": "2026-05-17",
    "notes": "Brand-atoms' read of Apple's public HIG. This file is not an official Apple brand document. Apple's logo is among the most- protected trademarks on the internet; no asset files are bundled here and any reference to \"the Apple logo\" must respect the Identity Guidelines.\n"
  },
  "tags": [
    "tech",
    "apple",
    "hardware",
    "hig",
    "premium"
  ],
  "palette": {
    "ref": "apple@1.0.0",
    "swatches": [
      {
        "id": "system-blue",
        "name": "System Blue",
        "value": "#007AFF",
        "description": "Default iOS tint color. Used for interactive elements (links, buttons, switches) across iOS, iPadOS, and macOS.\n",
        "aliases": []
      },
      {
        "id": "system-brown",
        "name": "System Brown",
        "value": "#A2845E",
        "description": "Earth-tone accent in the HIG System Colors set.",
        "aliases": []
      },
      {
        "id": "system-gray",
        "name": "System Gray",
        "value": "#8E8E93",
        "description": "Mid-gray for secondary content and inactive controls. Equivalent to UIColor.systemGray.\n",
        "aliases": []
      },
      {
        "id": "system-green",
        "name": "System Green",
        "value": "#34C759",
        "description": "Confirmation / success accent (e.g., toggle switches in the \"on\" state, recording indicators).\n",
        "aliases": []
      },
      {
        "id": "system-indigo",
        "name": "System Indigo",
        "value": "#5856D6",
        "description": "Cool-violet accent in the HIG System Colors set.",
        "aliases": []
      },
      {
        "id": "system-mint",
        "name": "System Mint",
        "value": "#00C7BE",
        "description": "Cool-teal accent introduced in iOS 15.",
        "aliases": []
      },
      {
        "id": "system-orange",
        "name": "System Orange",
        "value": "#FF9500",
        "description": "Warning accent. Used on system controls that signal caution (e.g., Cellular Data warnings).\n",
        "aliases": []
      },
      {
        "id": "system-pink",
        "name": "System Pink",
        "value": "#FF2D55",
        "description": "Warm-pink accent in the HIG System Colors set.",
        "aliases": []
      },
      {
        "id": "system-purple",
        "name": "System Purple",
        "value": "#AF52DE",
        "description": "Purple accent. Used on Siri, Podcasts, and other identity-bearing Apple product surfaces.\n",
        "aliases": []
      },
      {
        "id": "system-red",
        "name": "System Red",
        "value": "#FF3B30",
        "description": "Destructive / error accent. Used for delete actions, error states, and recording indicators.\n",
        "aliases": []
      },
      {
        "id": "system-teal",
        "name": "System Teal",
        "value": "#30B0C7",
        "description": "Cooler complement to System Mint in the HIG set.",
        "aliases": []
      },
      {
        "id": "system-yellow",
        "name": "System Yellow",
        "value": "#FFCC00",
        "description": "Highlight / warning accent in the HIG System Colors set.",
        "aliases": []
      },
      {
        "id": "label",
        "name": "Label",
        "value": "#000000",
        "description": "Primary text on light-mode surfaces. Equivalent to the HIG `label` semantic color in Light Appearance.\n",
        "aliases": []
      },
      {
        "id": "secondary-label",
        "name": "Secondary Label",
        "value": "#3C3C43",
        "description": "Secondary text. Equivalent to the HIG `secondaryLabel` (60% alpha black resolved against systemBackground) in Light.\n",
        "aliases": []
      },
      {
        "id": "tertiary-label",
        "name": "Tertiary Label",
        "value": "#3C3C434D",
        "description": "Tertiary text. Equivalent to the HIG `tertiaryLabel` (~30% alpha) in Light.\n",
        "aliases": []
      },
      {
        "id": "system-background",
        "name": "System Background",
        "value": "#FFFFFF",
        "description": "Base background in Light Appearance.",
        "aliases": []
      },
      {
        "id": "secondary-system-background",
        "name": "Secondary System Background",
        "value": "#F2F2F7",
        "description": "Grouped-table and grouped-cell background in Light.",
        "aliases": []
      },
      {
        "id": "tertiary-system-background",
        "name": "Tertiary System Background",
        "value": "#FFFFFF",
        "description": "Elevated card / sheet background in Light.",
        "aliases": []
      },
      {
        "id": "system-background-dark",
        "name": "System Background (Dark)",
        "value": "#000000",
        "description": "Base background in Dark Appearance.",
        "aliases": []
      },
      {
        "id": "secondary-system-background-dark",
        "name": "Secondary System Background (Dark)",
        "value": "#1C1C1E",
        "description": "Grouped-cell background in Dark.",
        "aliases": []
      },
      {
        "id": "tertiary-system-background-dark",
        "name": "Tertiary System Background (Dark)",
        "value": "#2C2C2E",
        "description": "Elevated card / sheet background in Dark.",
        "aliases": []
      },
      {
        "id": "label-dark",
        "name": "Label (Dark)",
        "value": "#FFFFFF",
        "description": "Primary text on dark-mode surfaces.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "system-background",
          "surface": "secondary-system-background",
          "surface-elevated": "tertiary-system-background",
          "text-primary": "label",
          "text-secondary": "secondary-label",
          "text-tertiary": "system-gray",
          "primary": "system-blue",
          "primary-hover": "system-blue",
          "accent": "system-indigo",
          "accent-hover": "system-purple",
          "warning": "system-orange",
          "warning-hover": "system-yellow",
          "error": "system-red",
          "success": "system-green"
        }
      },
      "dark": {
        "roles": {
          "background": "system-background-dark",
          "surface": "secondary-system-background-dark",
          "surface-elevated": "tertiary-system-background-dark",
          "text-primary": "label-dark",
          "text-secondary": "system-gray",
          "text-tertiary": "system-gray",
          "primary": "system-blue",
          "primary-hover": "system-blue",
          "accent": "system-indigo",
          "accent-hover": "system-purple",
          "warning": "system-orange",
          "warning-hover": "system-yellow",
          "error": "system-red",
          "success": "system-green"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "sf-pro@1.0.0",
      "family": "SF Pro",
      "classification": "sans-serif",
      "source": {
        "kind": "system",
        "stack": [
          "-apple-system",
          "BlinkMacSystemFont",
          "SF Pro Text",
          "SF Pro Display",
          "SF Pro",
          "system-ui",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ]
      },
      "fallbackStack": [
        "Inter",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "normal"
        }
      ]
    },
    {
      "role": "body",
      "ref": "sf-pro@1.0.0",
      "family": "SF Pro",
      "classification": "sans-serif",
      "source": {
        "kind": "system",
        "stack": [
          "-apple-system",
          "BlinkMacSystemFont",
          "SF Pro Text",
          "SF Pro Display",
          "SF Pro",
          "system-ui",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ]
      },
      "fallbackStack": [
        "Inter",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "normal"
        }
      ]
    },
    {
      "role": "mono",
      "ref": "sf-pro@1.0.0",
      "family": "SF Pro",
      "classification": "sans-serif",
      "source": {
        "kind": "system",
        "stack": [
          "-apple-system",
          "BlinkMacSystemFont",
          "SF Pro Text",
          "SF Pro Display",
          "SF Pro",
          "system-ui",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ]
      },
      "fallbackStack": [
        "Inter",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "normal"
        }
      ]
    }
  ],
  "roles": {
    "colors": {
      "identity": "label",
      "on-identity": "system-background",
      "primary": "system-blue",
      "primary-hover": "system-blue",
      "accent": "system-indigo",
      "background": "system-background",
      "surface": "secondary-system-background",
      "surface-elevated": "tertiary-system-background",
      "text-primary": "label",
      "text-secondary": "secondary-label",
      "text-tertiary": "system-gray"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "The Apple Identity Guidelines explicitly prohibit altering the proportions, color, orientation, or surrounding clearspace of the Apple logo. Only the approved monochrome variants (black, white, or single-color silver / gray) are permitted, and only on backgrounds that meet the documented contrast threshold.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "on-busy-photo",
        "outlined"
      ]
    },
    {
      "type": "colorChoice",
      "target": "logo.mark.fill",
      "severity": "error",
      "rationale": "The Apple mark is monochrome. The Identity Guidelines prohibit filling the logo with any of the System Colors — the chromatic System Colors are reserved for product UI tint, not for the corporate mark.\n",
      "allowed": [
        "label",
        "label-dark",
        "system-gray"
      ],
      "forbidden": [
        "system-blue",
        "system-red",
        "system-green",
        "system-yellow",
        "system-orange",
        "system-purple"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "WCAG 2.1 Level AA contrast requirement for body text. The HIG Accessibility section calls out 4.5:1 as the floor for body text and 3:1 for large text on a typical iOS surface; Label on System Background clears AA at ~21:1.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contrastRatio",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "System Blue on System Background must remain perceptible at interactive-control size. The HIG specifies that tint colors need at least 3:1 contrast against the underlying surface to preserve the \"tappable\" affordance.\n",
      "against": "background",
      "minRatio": 3,
      "standard": "WCAG-AA-large"
    },
    {
      "type": "fontPairing",
      "target": "typography.heading",
      "severity": "recommendation",
      "rationale": "Apple's HIG uses SF Pro for both heading and body, distinguished by the SF Pro Display vs SF Pro Text optical-size cuts and a meaningful size differential. Maintain at least a 1.3× ratio between heading and body to preserve hierarchy when one family does both jobs.\n",
      "requires": "body",
      "minSizeRatio": 1.3
    },
    {
      "type": "enumMembership",
      "target": "typography.body.fontWeight",
      "severity": "recommendation",
      "rationale": "The HIG type ramp uses SF Pro Regular (400) for body, Medium (500) for emphasis, and Semibold (600) for headings and controls. Lighter weights (100–300) are reserved for very large display sizes; bolder weights (700+) are rare in iOS UI.\n",
      "allowed": [
        "400",
        "500",
        "600"
      ]
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "error",
      "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The HIG Accessibility section aligns Apple's platform guidance with WCAG AA contrast as the floor for legible text-on-surface pairings.\n",
      "standard": "WCAG-AA",
      "criterion": "1.4.3"
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.system-red",
      "severity": "warning",
      "rationale": "System Red is semantically reserved for destructive actions and error / recording indicators in the HIG. Using it as a marketing accent dilutes the platform-wide affordance that \"red means destructive.\"\n",
      "forbiddenContexts": [
        "marketing-headline",
        "hero-background"
      ]
    }
  ]
}