{
  "id": "apple-music",
  "version": "1.0.0",
  "name": "Apple Music",
  "description": "Apple Music is Apple's subscription music-streaming service, a product brand operated under the Apple corporate parent. Where the Apple corporate mark is strictly monochrome, Apple Music carries the warmest, most chromatic identity in Apple's service-tier portfolio: a signature pink-to-red gradient mark used across the iOS / macOS app icon, the marketing site, and the Apple Music wordmark lockup. The brand voice inherits Apple's HIG restraint — clarity, deference to content, generous whitespace — but is expressive and editorial in marketing: bold hero photography of artists, gradient typographic moments, and the dark canvas the app itself uses by default.\nThis atom is the **product-brand** atom; the corporate Apple parent brand lives at `apple@1` and is documented separately. Apple Music inherits Apple's SF Pro typography, dark-first HIG surface model, and platform-wide accessibility floor — but overrides the corporate brand's monochrome posture with the pink/red gradient as its primary identity color.\n",
  "provenance": {
    "source": "https://brandcolorcode.com/apple-music",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "Apple, Apple Music, the Apple Music wordmark, and the pink-to-red gradient mark are trademarks of Apple Inc. This atom captures brand-atoms' read of Apple Music's publicly observable identity (the marketing site at apple.com/apple-music/ and the iOS / macOS app icon and wordmark) cross-referenced against third-party brand-color aggregators. It is not an official Apple brand-guidelines document.\n",
    "importedDate": "2026-05-19",
    "notes": "Apple Music sits **under the `apple@1` parent brand**. The parent atom MUST NOT be modified by this child; relationship is documented here in prose only. Apple does not publish explicit hex values for the Apple Music gradient — the pink (#FF4E6B) and red (#FF0436) values are the closest third-party-reported approximations per brandcolorcode.com. The proprietary SF Pro family is not openly distributed; this atom substitutes `inter@1` as the open-source rendering fallback for both heading and body roles, mirroring the convention used by other Apple-family atoms in this catalog.\n"
  },
  "tags": [
    "apple-music",
    "music",
    "streaming",
    "apple",
    "dark-first",
    "consumer-tech",
    "gradient"
  ],
  "palette": {
    "ref": "apple-music@1.0.0",
    "swatches": [
      {
        "id": "apple-music-pink",
        "name": "Apple Music Pink",
        "value": "#FF4E6B",
        "description": "The lighter terminus of Apple Music's signature pink-to-red gradient; primary mark fill.",
        "aliases": []
      },
      {
        "id": "apple-music-red",
        "name": "Apple Music Red",
        "value": "#FF0436",
        "description": "The deeper terminus of the gradient; pairs with the pink to form the mark.",
        "aliases": []
      },
      {
        "id": "apple-music-coral",
        "name": "Apple Music Coral",
        "value": "#FA233B",
        "description": "Mid-gradient coral — the pressed / hovered state on the gradient marks.",
        "aliases": []
      },
      {
        "id": "apple-music-white",
        "name": "Apple Music White",
        "value": "#FFFFFF",
        "description": "Primary text and reversed wordmark fill on the dark canvas.",
        "aliases": []
      },
      {
        "id": "apple-music-black",
        "name": "Apple Music Black",
        "value": "#000000",
        "description": "Canonical Apple HIG dark-mode canvas. Inherited from the iOS / macOS system-background-dark token.",
        "aliases": []
      },
      {
        "id": "apple-music-surface",
        "name": "Apple Music Surface",
        "value": "#1C1C1E",
        "description": "Elevated surface on the dark canvas — matches HIG secondary-system-background-dark.",
        "aliases": []
      },
      {
        "id": "apple-music-surface-elevated",
        "name": "Apple Music Surface Elevated",
        "value": "#2C2C2E",
        "description": "Cards, sheets, and elevated tiles — matches HIG tertiary-system-background-dark.",
        "aliases": []
      },
      {
        "id": "apple-music-gray",
        "name": "Apple Music Gray",
        "value": "#8E8E93",
        "description": "Secondary text and divider tone — matches HIG system-gray on dark.",
        "aliases": []
      },
      {
        "id": "apple-music-gray-light",
        "name": "Apple Music Gray Light",
        "value": "#C7C7CC",
        "description": "Tertiary text and metadata on the dark canvas.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "apple-music-white",
          "surface": "apple-music-white",
          "surface-elevated": "apple-music-white",
          "text-primary": "apple-music-black",
          "text-secondary": "apple-music-gray",
          "text-tertiary": "apple-music-gray-light",
          "primary": "apple-music-red",
          "primary-hover": "apple-music-coral",
          "accent": "apple-music-pink",
          "accent-hover": "apple-music-coral",
          "error": "apple-music-red",
          "success": "apple-music-pink"
        }
      },
      "dark": {
        "roles": {
          "background": "apple-music-black",
          "surface": "apple-music-surface",
          "surface-elevated": "apple-music-surface-elevated",
          "text-primary": "apple-music-white",
          "text-secondary": "apple-music-gray-light",
          "text-tertiary": "apple-music-gray",
          "primary": "apple-music-pink",
          "primary-hover": "apple-music-coral",
          "accent": "apple-music-pink",
          "accent-hover": "apple-music-red",
          "error": "apple-music-red",
          "success": "apple-music-pink"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "inter@1.0.0",
      "family": "Inter",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Inter",
        "url": "https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Roboto",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 100,
          "style": "italic"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "italic"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "italic"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "italic"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "italic"
        },
        {
          "weight": 900,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "italic"
        }
      ]
    },
    {
      "role": "body",
      "ref": "inter@1.0.0",
      "family": "Inter",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Inter",
        "url": "https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Roboto",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 100,
          "style": "italic"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "italic"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "italic"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "italic"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "italic"
        },
        {
          "weight": 900,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "italic"
        }
      ]
    },
    {
      "role": "mono",
      "ref": "jetbrainsmono-nerdfont@1.0.0",
      "family": "JetBrainsMono Nerd Font",
      "classification": "monospace",
      "source": {
        "kind": "external",
        "family": "JetBrainsMono Nerd Font",
        "notes": "Nerd-Font-patched build of JetBrains Mono. Not available via Google Fonts. Download woff2/ttf files from the Nerd Fonts GitHub release and self-host, or install system-wide for terminal/IDE use.\n"
      },
      "fallbackStack": [
        "JetBrains Mono",
        "Fira Code",
        "Menlo",
        "Monaco",
        "Consolas",
        "Liberation Mono",
        "monospace"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 100,
          "style": "italic"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "italic"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "italic"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "italic"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "italic"
        }
      ]
    }
  ],
  "roles": {
    "colors": {
      "identity": "apple-music-pink",
      "on-identity": "apple-music-white",
      "background": "apple-music-black",
      "surface": "apple-music-surface",
      "surface-elevated": "apple-music-surface-elevated",
      "text-primary": "apple-music-white",
      "text-secondary": "apple-music-gray-light",
      "text-tertiary": "apple-music-gray",
      "primary": "apple-music-pink",
      "primary-hover": "apple-music-coral",
      "accent": "apple-music-pink",
      "accent-hover": "apple-music-red",
      "mark": "apple-music-pink",
      "error": "apple-music-red"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "wordmark": "heading",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "logo.mark.fill",
      "severity": "error",
      "rationale": "The Apple Music mark renders as the pink-to-red gradient or as a flat-white reversed variant on dark / chromatic surfaces. Filling the mark with the neutral grays or with black collapses the gradient identity into the parent Apple corporate monochrome posture, which is reserved for the Apple corporate mark at `apple@1`.\n",
      "allowed": [
        "apple-music-pink",
        "apple-music-red",
        "apple-music-coral",
        "apple-music-white"
      ],
      "forbidden": [
        "apple-music-black",
        "apple-music-gray",
        "apple-music-gray-light"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "Apple Music inherits the Apple Identity Guidelines' prohibition on stretching, rotating, recoloring, or adding effects to the mark. The gradient direction is fixed (pink at one terminus, red at the other) — reversing the gradient inverts the brand's published treatment.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "on-busy-photo",
        "outlined",
        "gradient-reversed"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "Apple Music White (#FFFFFF) on Apple Music Black (#000000) gives ~21:1 — well clear of WCAG 2.1 Level AA. This rule encodes the floor any new role pairing must clear on the dark canvas.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contrastRatio",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Apple Music Pink (#FF4E6B) on the dark canvas must remain perceptible at interactive sizes. Falling below 3:1 (AA-large) breaks the affordance of primary CTAs and the play button the brand depends on.\n",
      "against": "background",
      "minRatio": 3,
      "standard": "WCAG-AA-large"
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "The pink gradient terminus is reserved for the mark, hero typographic moments, and the primary play / subscribe action. Reusing it for body text or validation-failure states conflicts with its established positive-action meaning and dilutes the gradient identity.\n",
      "forbiddenContexts": [
        "body-text",
        "secondary-link",
        "validation-failure"
      ]
    },
    {
      "type": "enumMembership",
      "target": "typography.heading.fontWeight",
      "severity": "recommendation",
      "rationale": "Apple's HIG type ramp uses SF Pro Medium (500) and Semibold (600) for most heading sizes, with Bold (700) reserved for hero typography. Apple Music's marketing headlines lean into the heavier end of this ramp for editorial impact while staying within the HIG-approved weight set.\n",
      "allowed": [
        "500",
        "600",
        "700"
      ]
    },
    {
      "type": "fontPairing",
      "target": "typography.heading",
      "severity": "recommendation",
      "rationale": "Apple Music inherits Apple's HIG convention of using one family (SF Pro, substituted here by Inter) for both heading and body, distinguished by a meaningful size differential. A 1.3× floor preserves hierarchy when one family does both jobs.\n",
      "requires": "body",
      "minSizeRatio": 1.3
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "error",
      "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Apple Music inherits the Apple HIG Accessibility floor: 4.5:1 for body text, 3:1 for large text and interactive controls.\n",
      "standard": "WCAG-AA",
      "criterion": "1.4.3"
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "The pink-to-red gradient reads cleanest against the deep black canvas or against pure white. Pairing the gradient against the mid-grays produces a muddy adjacency that fights the gradient's saturation rather than supporting it as a focal accent.\n",
      "pairsWith": [
        "apple-music-black",
        "apple-music-surface",
        "apple-music-white"
      ],
      "doesNotPairWith": [
        "apple-music-gray",
        "apple-music-gray-light"
      ]
    }
  ]
}