{
  "id": "paypal",
  "version": "1.0.0",
  "name": "PayPal",
  "description": "PayPal Holdings, Inc. is the global online payments platform that established the modern consumer-payments category. The brand is light-first, trust-leaning, and disciplined: a deep navy-blue wordmark next to the two-tone \"PP\" monogram on a white canvas. The signature gold \"Pay with PayPal\" button is one of the most-deployed brand elements in commerce. The voice is direct and consumer-facing — \"fast, easy, secure\" — built around reliability rather than flourish.\n",
  "provenance": {
    "source": "https://newsroom.paypal-corp.com/Brand-Center",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "PayPal Holdings, Inc. — PayPal, the PayPal wordmark, and the two-tone \"PP\" monogram are registered trademarks of PayPal Holdings, Inc. The signature blue duotone (#003087 + #009CDE) and the merchant gold (#FFC439) are documented across PayPal's Brand Center press kit. PayPal Sans is the proprietary corporate typeface; Inter is referenced here as the open-source fallback.\n",
    "importedDate": "2026-05-18",
    "notes": "PayPal Sans is not publicly distributed. This atom references Inter for both heading and body roles and notes PayPal Sans as the proprietary primary in provenance. The signature gold button (\"Pay with PayPal\") is a regulated merchant-button color — its use in the wild is governed by PayPal's button-style spec.\n"
  },
  "tags": [
    "fintech",
    "payments",
    "paypal",
    "blue",
    "light-first",
    "consumer"
  ],
  "palette": {
    "ref": "paypal@1.0.0",
    "swatches": [
      {
        "id": "paypal-blue",
        "name": "PayPal Blue",
        "value": "#003087",
        "description": "Primary deep navy-blue — the back-facing \"P\" of the monogram and the wordmark color.",
        "aliases": []
      },
      {
        "id": "paypal-cobalt",
        "name": "PayPal Cobalt",
        "value": "#009CDE",
        "description": "Bright cobalt — the front-facing \"P\" of the duotone monogram.",
        "aliases": []
      },
      {
        "id": "paypal-blue-deep",
        "name": "PayPal Blue Deep",
        "value": "#001C64",
        "description": "Deeper navy used on hover/pressed states and emphasis text on the primary blue.",
        "aliases": []
      },
      {
        "id": "paypal-gold",
        "name": "PayPal Gold",
        "value": "#FFC439",
        "description": "Signature gold — the \"Pay with PayPal\" merchant-button fill across the web.",
        "aliases": []
      },
      {
        "id": "paypal-gold-hover",
        "name": "PayPal Gold Hover",
        "value": "#F2BB30",
        "description": "Authored darker gold for hover/pressed states on the gold merchant button.",
        "aliases": []
      },
      {
        "id": "paypal-ink",
        "name": "PayPal Ink",
        "value": "#2C2E2F",
        "description": "Near-black for body copy on light surfaces.",
        "aliases": []
      },
      {
        "id": "paypal-graphite",
        "name": "PayPal Graphite",
        "value": "#545D68",
        "description": "Secondary text on light backgrounds.",
        "aliases": []
      },
      {
        "id": "paypal-gray",
        "name": "PayPal Gray",
        "value": "#9DA3A6",
        "description": "Tertiary text and metadata.",
        "aliases": []
      },
      {
        "id": "paypal-white",
        "name": "PayPal White",
        "value": "#FFFFFF",
        "description": "Canonical light canvas.",
        "aliases": []
      },
      {
        "id": "paypal-fog",
        "name": "PayPal Fog",
        "value": "#F5F7FA",
        "description": "Authored surface tone for cards and panels.",
        "aliases": []
      },
      {
        "id": "paypal-divider",
        "name": "PayPal Divider",
        "value": "#CBD2D6",
        "description": "Authored hairline divider tone.",
        "aliases": []
      },
      {
        "id": "paypal-canvas-dark",
        "name": "PayPal Canvas Dark",
        "value": "#0F1419",
        "description": "Authored dark-mode canvas — PayPal is light-first; this is an authored inversion.",
        "aliases": []
      },
      {
        "id": "paypal-surface-dark",
        "name": "PayPal Surface Dark",
        "value": "#1C232B",
        "description": "Authored elevated surface on dark mode.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "paypal-white",
          "surface": "paypal-fog",
          "surface-elevated": "paypal-white",
          "text-primary": "paypal-ink",
          "text-secondary": "paypal-graphite",
          "text-tertiary": "paypal-gray",
          "primary": "paypal-blue",
          "primary-hover": "paypal-blue-deep",
          "accent": "paypal-cobalt",
          "accent-hover": "paypal-blue",
          "warning": "paypal-gold",
          "warning-hover": "paypal-gold-hover",
          "error": "paypal-blue-deep",
          "success": "paypal-cobalt"
        }
      },
      "dark": {
        "roles": {
          "background": "paypal-canvas-dark",
          "surface": "paypal-surface-dark",
          "surface-elevated": "paypal-surface-dark",
          "text-primary": "paypal-white",
          "text-secondary": "paypal-gray",
          "text-tertiary": "paypal-graphite",
          "primary": "paypal-cobalt",
          "primary-hover": "paypal-blue",
          "accent": "paypal-gold",
          "accent-hover": "paypal-gold-hover",
          "warning": "paypal-gold",
          "warning-hover": "paypal-gold-hover",
          "error": "paypal-blue",
          "success": "paypal-cobalt"
        }
      }
    }
  },
  "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": "paypal-blue",
      "on-identity": "paypal-white",
      "primary": "paypal-blue",
      "primary-hover": "paypal-blue-deep",
      "accent": "paypal-cobalt",
      "accent-hover": "paypal-blue",
      "mark": "paypal-blue",
      "mark-secondary": "paypal-cobalt",
      "success": "paypal-cobalt",
      "warning": "paypal-gold",
      "error": "paypal-blue-deep",
      "text-primary-light": "paypal-ink",
      "text-primary-dark": "paypal-white",
      "text-secondary-light": "paypal-graphite",
      "background-light": "paypal-white",
      "background-dark": "paypal-canvas-dark",
      "surface-light": "paypal-fog",
      "surface-dark": "paypal-surface-dark",
      "divider": "paypal-divider"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "logo.wordmark.fill",
      "severity": "error",
      "rationale": "The PayPal wordmark renders only in PayPal Blue (#003087), in reversed white on dark surfaces, or in monochrome ink for print/embossed use. Cobalt is the monogram's front-P, not the wordmark fill; gold is reserved for the merchant button only.\n",
      "allowed": [
        "paypal-blue",
        "paypal-white",
        "paypal-ink"
      ],
      "forbidden": [
        "paypal-cobalt",
        "paypal-gold",
        "paypal-blue-deep",
        "paypal-gray"
      ]
    },
    {
      "type": "colorChoice",
      "target": "logo.monogram",
      "severity": "error",
      "rationale": "The \"PP\" monogram is a duotone composition: PayPal Blue back-P paired with PayPal Cobalt front-P. Single-color or off-brand variants violate the published mark.\n",
      "allowed": [
        "paypal-blue",
        "paypal-cobalt"
      ],
      "forbidden": [
        "paypal-gold",
        "paypal-blue-deep"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "PayPal's brand-center program forbids modifying the marks. Apply only PayPal-approved variants with the documented clearspace.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "on-busy-photo",
        "inverted-without-variant"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "PayPal Ink (#2C2E2F) on PayPal White (#FFFFFF) gives ~13:1 — well above WCAG 2.1 Level AA. This rule guards the floor for any new foreground/background pairing.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contrastRatio",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "PayPal Blue (#003087) on white reaches ~13:1 — well above AA. The deep navy carries primary actions cleanly; this rule guards link usage so future palette additions cannot regress.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.warning",
      "severity": "error",
      "rationale": "PayPal Gold (#FFC439) is reserved for the merchant \"Pay with PayPal\" button per PayPal's button-style spec. Using it as body color, link color, or for error states conflicts with its established merchant-button semantics.\n",
      "forbiddenContexts": [
        "body-text",
        "secondary-link",
        "error-state"
      ]
    },
    {
      "type": "enumMembership",
      "target": "typography.heading.fontWeight",
      "severity": "warning",
      "rationale": "PayPal Sans headlines on paypal.com and Brand Center surfaces sit in the Medium (500), Semibold (600), and Bold (700) band. Lighter cuts compromise the confident, trust-leaning voice; heavier cuts are outside the documented marketing kit.\n",
      "allowed": [
        "500",
        "600",
        "700"
      ]
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "error",
      "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Fintech surfaces have an elevated trust requirement; AA is the floor on any new role pairing.\n",
      "standard": "WCAG-AA",
      "criterion": "1.4.3"
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "The blue duotone (Blue + Cobalt) pairs cleanly with neutrals. Mixing the brand blue with the merchant gold on the same surface conflicts with the published button-style separation between corporate identity and merchant CTA.\n",
      "pairsWith": [
        "paypal-cobalt",
        "paypal-white",
        "paypal-fog"
      ],
      "doesNotPairWith": [
        "paypal-gold"
      ]
    }
  ]
}