{
  "$description": "Brand: Shopify (shopify@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette shopify@1.0.0",
      "shopify-green": {
        "$value": "#008060",
        "$type": "color",
        "$description": "Current corporate primary green — the modernized Shopify brand color on shopify.com primary CTAs and marketing."
      },
      "shopify-green-heritage": {
        "$value": "#95BF47",
        "$type": "color",
        "$description": "Heritage Shopify leaf-green — the original shopping-bag mark fill color, retained on the public mark."
      },
      "shopify-green-wordmark": {
        "$value": "#7AB55C",
        "$type": "color",
        "$description": "Mid-green historically used on the Shopify wordmark text in the dual-tone heritage logo."
      },
      "shopify-green-deep": {
        "$value": "#004C3F",
        "$type": "color",
        "$description": "Deep green used for hover/pressed states on the primary corporate green and for emphasis on text."
      },
      "shopify-ink": {
        "$value": "#1A1A1A",
        "$type": "color",
        "$description": "Near-black used for body copy and the wordmark on light surfaces."
      },
      "shopify-graphite": {
        "$value": "#303030",
        "$type": "color",
        "$description": "Authored elevated surface on the dark mode; matches Polaris gray-15."
      },
      "shopify-canvas-dark": {
        "$value": "#1A1A1A",
        "$type": "color",
        "$description": "Dark-mode canvas; matches Polaris gray-16."
      },
      "shopify-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Canonical light canvas; the marketing surface is light-first."
      },
      "shopify-fog": {
        "$value": "#F1F1F1",
        "$type": "color",
        "$description": "Authored surface tone for cards and panels on light backgrounds; matches Polaris gray-6."
      },
      "shopify-gray": {
        "$value": "#616161",
        "$type": "color",
        "$description": "Secondary text on light backgrounds; matches Polaris gray-13."
      },
      "shopify-gray-light": {
        "$value": "#8A8A8A",
        "$type": "color",
        "$description": "Tertiary text and metadata."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Inter (inter@1.0.0)"
      },
      "weight": {
        "100": {
          "$value": 100,
          "$type": "fontWeight"
        },
        "200": {
          "$value": 200,
          "$type": "fontWeight"
        },
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "600": {
          "$value": 600,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "800": {
          "$value": 800,
          "$type": "fontWeight"
        },
        "900": {
          "$value": 900,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Inter (inter@1.0.0)"
      },
      "weight": {
        "100": {
          "$value": 100,
          "$type": "fontWeight"
        },
        "200": {
          "$value": 200,
          "$type": "fontWeight"
        },
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "600": {
          "$value": 600,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "800": {
          "$value": 800,
          "$type": "fontWeight"
        },
        "900": {
          "$value": 900,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "mono": {
      "family": {
        "$value": [
          "JetBrainsMono Nerd Font",
          "JetBrains Mono",
          "Fira Code",
          "Menlo",
          "Monaco",
          "Consolas",
          "Liberation Mono",
          "monospace"
        ],
        "$type": "fontFamily",
        "$description": "mono role → JetBrainsMono Nerd Font (jetbrainsmono-nerdfont@1.0.0)"
      },
      "weight": {
        "100": {
          "$value": 100,
          "$type": "fontWeight"
        },
        "200": {
          "$value": 200,
          "$type": "fontWeight"
        },
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "600": {
          "$value": 600,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "800": {
          "$value": 800,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    }
  },
  "$extensions": {
    "com.brand-atoms.rules": [
      {
        "type": "colorChoice",
        "target": "logo.mark.fill",
        "severity": "error",
        "rationale": "The Shopify shopping-bag mark renders in the heritage leaf-green (#95BF47) or the modernized corporate green (#008060), or in monochrome white / ink reversal variants. The deep-green and gray tones are interactive-state or text values, not mark fills.\n",
        "allowed": [
          "shopify-green-heritage",
          "shopify-green",
          "shopify-white",
          "shopify-ink"
        ],
        "forbidden": [
          "shopify-green-deep",
          "shopify-gray",
          "shopify-gray-light"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "Shopify's brand-assets program forbids modifying the mark or wordmark. Apply only the Shopify-approved variants with respected clearspace; never render the green mark over busy photography where it loses legibility.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "on-busy-photo",
          "inverted-without-variant"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Shopify Ink (#1A1A1A) on Shopify White (#FFFFFF) gives ~17: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": "Shopify Green (#008060) on white reaches ~4.9:1 — clears AA for normal text. Buttons using the green fill with white text exceed 6:1; this rule guards link usage so the brand interactive color stays AA-compliant against the canvas.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "Shopify Sans headlines on shopify.com sit in the Medium (500), Semibold (600), and Bold (700) band. Lighter cuts read as body and compromise the confident merchant-facing voice; heavier cuts are outside the corporate kit.\n",
        "allowed": [
          "500",
          "600",
          "700"
        ]
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.mark",
        "severity": "error",
        "rationale": "The heritage leaf-green (#95BF47) is reserved for the shopping-bag mark fill. Using it inside body copy or for secondary links dilutes the dual-tone wordmark+mark relationship and degrades brand recognition.\n",
        "forbiddenContexts": [
          "body-text",
          "secondary-link"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The default verification on any new role pairing on Shopify surfaces.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.primary",
        "severity": "recommendation",
        "rationale": "The corporate green pairs cleanly with neutrals (white, fog, ink). Combining the corporate #008060 and the heritage #95BF47 on the same surface creates a muddy two-green composition that reads as inconsistency between modernized and heritage brand surfaces.\n",
        "pairsWith": [
          "shopify-white",
          "shopify-fog",
          "shopify-ink"
        ],
        "doesNotPairWith": [
          "shopify-green-heritage"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://www.shopify.com/brand-assets",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Shopify Inc. — Shopify, the Shopify wordmark, and the shopping-bag mark are registered trademarks of Shopify Inc. Hex values are documented across the Shopify brand-assets page and the public Polaris design-token source. Shopify Sans is the corporate proprietary typeface; Inter is referenced here as the open-source fallback because Shopify Sans is not publicly distributed.\n",
      "importedDate": "2026-05-18",
      "notes": "Shopify Sans (proprietary) is the corporate brand face. It is not publicly distributed, so this atom references Inter for both heading and body roles and notes Shopify Sans as the proprietary primary in provenance. The Polaris-system tokens are intentionally separate (palettes/polaris/1.0.0) — consumers building merchant admin surfaces should switch the palette reference to polaris@1.\n"
    },
    "com.brand-atoms.references": {
      "palette": "shopify@1.0.0",
      "fonts": {
        "heading": "inter@1.0.0",
        "body": "inter@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}