{
  "$description": "Brand: Apache Software Foundation (apache@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette apache@1.0.0",
      "apache-red": {
        "$value": "#D22128",
        "$type": "color",
        "$description": "Primary brand color — the fill of the Apache feather mark. The single most-recognized Apache visual element.\n"
      },
      "apache-red-dark": {
        "$value": "#A81920",
        "$type": "color",
        "$description": "Pressed / active variant of Apache Red for hover states."
      },
      "apache-black": {
        "$value": "#0E1014",
        "$type": "color",
        "$description": "Wordmark color on light canvas; dark-mode page canvas."
      },
      "apache-charcoal": {
        "$value": "#1F232B",
        "$type": "color",
        "$description": "Elevated dark surface for cards and panels."
      },
      "apache-slate": {
        "$value": "#4A5568",
        "$type": "color",
        "$description": "Body text on light canvas; secondary copy."
      },
      "apache-gray": {
        "$value": "#7B8794",
        "$type": "color",
        "$description": "Tertiary text and quiet UI; muted divider tone."
      },
      "apache-light-gray": {
        "$value": "#D5D9DE",
        "$type": "color",
        "$description": "Hairline borders on light canvas."
      },
      "apache-off-white": {
        "$value": "#F4F5F7",
        "$type": "color",
        "$description": "Subtle layered surface on light canvas."
      },
      "apache-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Page canvas in light mode."
      }
    }
  },
  "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": [
          "Source Code Pro",
          "ui-monospace",
          "SFMono-Regular",
          "Menlo",
          "Consolas",
          "Liberation Mono",
          "monospace"
        ],
        "$type": "fontFamily",
        "$description": "mono role → Source Code Pro (source-code-pro@1.0.0)"
      },
      "weight": {
        "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"
      }
    }
  },
  "$extensions": {
    "com.brand-atoms.rules": [
      {
        "type": "colorChoice",
        "target": "roles.colors.mark",
        "severity": "error",
        "rationale": "The Apache feather is rendered in Apache Red (#D22128). Substituting a black feather, a darker red, or any other fill changes the canonical Foundation mark and conflicts with the ASF Trademark Policy's requirement that the logo not be presented in a \"confusingly similar\" derivative form.\n",
        "allowed": [
          "apache-red"
        ],
        "forbidden": [
          "apache-red-dark",
          "apache-black",
          "apache-slate",
          "apache-gray"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "The ASF Trademark Policy forbids using Apache marks \"in association with other companies' software or related services,\" and requires written approval from the VP, Brand Management for all non-hyperlink uses. Recoloring, rotation, gradient fills, and other ornamental treatments create confusingly similar derivatives that fall outside the policy's permitted scope.\n",
        "treatments": [
          "recolored",
          "rotated",
          "stretched",
          "skewed",
          "drop-shadow",
          "gradient-fill",
          "feather-detached-from-wordmark-without-approval",
          "associated-with-non-apache-software"
        ]
      },
      {
        "type": "contextRestriction",
        "target": "trademark.use",
        "severity": "error",
        "rationale": "The ASF Trademark Policy explicitly forbids using Apache marks alongside non-Apache software, implying ASF endorsement of a product or service, or using the marks in any non-hyperlink context without prior written approval from the VP, Brand Management. Project names (e.g., \"Apache Kafka\") must follow the ASF's specific naming guidance and cannot be prefixed onto third-party products.\n",
        "forbiddenContexts": [
          "associated-with-third-party-software",
          "implied-endorsement",
          "non-hyperlink-use-without-approval",
          "product-name-prefix-without-approval"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Apache Black (#0E1014) on Apache White exceeds 18:1 — decisively clears WCAG AAA. The Foundation's documentation-first surfaces (apache.org, project sites, mailing-list archives) benefit from the strongest readable contrast.\n",
        "against": "background",
        "minRatio": 7,
        "standard": "WCAG-AAA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "warning",
        "rationale": "Apache Red (#D22128) on Apache White sits around 5.0:1 — clears WCAG AA for body text. Apache Red Dark (#A81920) on White sits around 7.6:1 and clears AAA, making it the preferred fill for small-text interactive elements.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "recommendation",
        "rationale": "ASF project documentation surfaces typically use a single humanist sans for heading and body. Maintain at least a 1.5× heading-to-body ratio to preserve hierarchy in long-form release notes, ADR-style design docs, and mailing-list archive pages.\n",
        "requires": "body",
        "minSizeRatio": 1.5
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The Apache Foundation's project-documentation mission makes broad legibility a load-bearing brand attribute.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.identity",
        "severity": "recommendation",
        "rationale": "Apache Red reads cleanest as a feather on a white or off-white canvas, or reversed on the deep apache-black dark canvas. Placing it directly adjacent to Apache Red Dark muddies the mark; reserve the dark-red variant for hover states and interactive surfaces, not for the feather fill.\n",
        "pairsWith": [
          "apache-white",
          "apache-off-white",
          "apache-black"
        ],
        "doesNotPairWith": [
          "apache-red-dark"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://www.apache.org/foundation/marks/",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Apache, the Apache feather logo, the names of Apache projects, and associated marks are trademarks of The Apache Software Foundation. Brand-atoms' encoding draws from the ASF Trademark Policy and the canonical Apache Red value (#D22128) carried by the simple-icons project's \"Apache\" entry, matching the resolved fill in the official ASF feather logo distributed via apache.org/foundation/press/kit/.\n",
      "importedDate": "2026-05-19",
      "notes": "The ASF Trademark Policy (apache.org/foundation/marks/) is the primary source for the trademark redistribution rules encoded below. Per that policy: ASF graphic logos are licensed to the public under the Apache License and derivative works are permitted, BUT (1) derivative logos applied to software cannot be \"confusingly similar\" to the originals, (2) ASF logos cannot be used \"in association with other companies' software or related services\", and (3) all non-hyperlink uses require \"written approval\" from the VP, Brand Management. The Foundation does not publish formal brand-color hex values on the marks page; the #D22128 value is the SVG-resolved canonical.\n"
    },
    "com.brand-atoms.references": {
      "palette": "apache@1.0.0",
      "fonts": {
        "heading": "inter@1.0.0",
        "body": "inter@1.0.0",
        "mono": "source-code-pro@1.0.0"
      }
    }
  }
}