{
  "$description": "Brand: Gmail (gmail@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette gmail@1.0.0",
      "gmail-red": {
        "$value": "#EA4335",
        "$type": "color",
        "$description": "Right downstroke of the Gmail \"M\" envelope. Google Red / Material Red 500 — the canonical Google four-color red.\n"
      },
      "gmail-crimson": {
        "$value": "#C5221F",
        "$type": "color",
        "$description": "Deeper red used for the envelope interior fold in the 2020 Gmail icon. Provides depth between the outer Red and the inner envelope face.\n"
      },
      "gmail-yellow": {
        "$value": "#FBBC04",
        "$type": "color",
        "$description": "Right-of-center valley of the \"M\". Google Yellow / Material Yellow 600 — used for highlight and starred states inside the Gmail UI.\n"
      },
      "gmail-green": {
        "$value": "#34A853",
        "$type": "color",
        "$description": "Left-of-center valley of the \"M\". Google Green / Material Green 500 — used as the canonical success / send-confirmed hue in Gmail product chrome.\n"
      },
      "gmail-blue": {
        "$value": "#4285F4",
        "$type": "color",
        "$description": "Left downstroke of the \"M\". Google Blue / Material Blue 500 — Gmail's primary action color (Compose button, link affordance).\n"
      },
      "gmail-grey-900": {
        "$value": "#202124",
        "$type": "color",
        "$description": "Primary text on light surfaces; near-black drawn from Material Grey 900 to match the Google parent.\n"
      },
      "gmail-grey-700": {
        "$value": "#5F6368",
        "$type": "color",
        "$description": "Secondary text and inactive icons (Material Grey 700)."
      },
      "gmail-grey-200": {
        "$value": "#E8EAED",
        "$type": "color",
        "$description": "Divider and subtle surface tint (Material Grey 200)."
      },
      "gmail-grey-100": {
        "$value": "#F1F3F4",
        "$type": "color",
        "$description": "Page-level background — Gmail's product chrome uses this warm light-grey as the inbox canvas.\n"
      },
      "gmail-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Base background and reversed surface fill."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Google Sans",
          "Roboto",
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Google Sans (google-sans@1.0.0)"
      },
      "weight": {
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Roboto",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Roboto (roboto@1.0.0)"
      },
      "weight": {
        "100": {
          "$value": 100,
          "$type": "fontWeight"
        },
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$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.envelope-mark",
        "severity": "error",
        "rationale": "The 2020 Gmail envelope mark uses exactly five colors — Blue, Green, Yellow, Red, and Crimson Dark — declared in the public Gmail icon SVG. Monochromatic Gmail marks are reserved for special contexts (favicons at extreme small sizes) that Google's brand guidance calls out explicitly.\n",
        "allowed": [
          "gmail-red",
          "gmail-crimson",
          "gmail-yellow",
          "gmail-green",
          "gmail-blue"
        ],
        "forbidden": [
          "gmail-grey-900",
          "gmail-grey-700"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "Gmail's 2020 refresh replaced the pre-2020 solid-red envelope. Reverting to the legacy mark, recoloring the strokes, or altering proportions all conflict with current Google brand guidance. The mark requires generous clearspace and an unbusy background.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "on-busy-photo",
          "reverted-to-old-red-envelope",
          "reordered-colors"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "WCAG 2.1 Level AA contrast requirement for body text. Gmail Grey 900 (#202124) on Gmail White clears AA at ~16:1, matching the Google parent's accessibility floor for Material surfaces.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "Gmail Blue (#4285F4) on Gmail White must remain perceptible as the Compose-button and primary-link affordance. Below 3:1 the \"clickable\" signal collapses on the inbox canvas.\n",
        "against": "background",
        "minRatio": 3,
        "standard": "WCAG-AA-large"
      },
      {
        "type": "colorChoice",
        "target": "roles.colors.error",
        "severity": "error",
        "rationale": "Gmail uses Google Red (#EA4335) as the canonical error / destructive color across the product UI (delete-thread, send-failed). Other reds dilute the signal and break parity with the Google parent.\n",
        "allowed": [
          "gmail-red"
        ]
      },
      {
        "type": "colorChoice",
        "target": "roles.colors.success",
        "severity": "recommendation",
        "rationale": "Gmail uses Google Green (#34A853) as the canonical success color — \"Message sent,\" \"Recipient added,\" conversation-marked labels. Other greens are acceptable for illustration but should not appear in confirmation chrome.\n",
        "allowed": [
          "gmail-green"
        ]
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "recommendation",
        "rationale": "Gmail's marketing surfaces pair Google Sans (display / titles) with Roboto (body / UI), inheriting the Google parent's typographic pairing. A 1.5× minimum size ratio preserves the geometric-vs-neogrotesque hierarchy when the two families appear together.\n",
        "requires": "body",
        "minSizeRatio": 1.5
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.primary",
        "severity": "recommendation",
        "rationale": "The five envelope hues belong together as the brand mark. Pairing Gmail Blue with a single sibling hue (without the full five-color set) reads as a brand-identity conflict rather than a coordinated palette — same pattern as the Google parent.\n",
        "pairsWith": [
          "gmail-white",
          "gmail-grey-100",
          "gmail-grey-900"
        ],
        "doesNotPairWith": [
          "gmail-red",
          "gmail-green",
          "gmail-yellow"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://about.google/brand-resource-center/",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Gmail, the Gmail envelope mark, and Google Sans are trademarks of Google LLC. Brand colors and identity guidance documented here are derived from the Google Brand Resource Center (about.google/brand-resource-center/), the public 2020 Gmail icon SVG hosted on Wikimedia Commons, and the live Gmail product surface at mail.google.com.\n",
      "importedDate": "2026-05-18",
      "notes": "Gmail inherits typography and brand voice from the Google parent (see brands/google/1.0.0). Identity role uses the Gmail envelope mark colors specifically. This atom is brand-atoms' read of public Gmail brand surfaces; it is not an official Google brand document. Gmail's logo and envelope mark are among the most-protected trademarks on the internet; no asset files are bundled here. The proprietary Google Sans / Product Sans typefaces are referenced via the google-sans@1 atom and Inter@1 is the open-source rendering substitute when Google Sans is unavailable.\n"
    },
    "com.brand-atoms.references": {
      "palette": "gmail@1.0.0",
      "fonts": {
        "heading": "google-sans@1.0.0",
        "body": "roboto@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}