{
  "id": "microsoft",
  "version": "1.0.0",
  "name": "Microsoft",
  "description": "Microsoft Corporation is a global technology company whose portfolio spans operating systems (Windows), productivity (Microsoft 365), cloud (Azure), developer tools (GitHub, Visual Studio), gaming (Xbox), and AI (Copilot). The corporate identity is anchored on the four-square logo — red, green, blue, and yellow quadrants — and on Communications Blue (#0078D4) as the Fluent system primary. The voice is enterprise-clear: confident, productivity-oriented, technically precise, and welcoming to both end users and developers.\n",
  "provenance": {
    "source": "https://www.microsoft.com/design/",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "Microsoft, the Microsoft logo, Windows, Office, Azure, Fluent, and related names and marks are trademarks of the Microsoft group of companies. Brand colors and identity guidance documented here are derived from microsoft.com/design/ and the Fluent 2 design system site at fluent2.microsoft.design.\n",
    "importedDate": "2026-05-17",
    "notes": "Brand-atoms' read of Microsoft's public Fluent and brand-resource guidance. This file is not an official Microsoft brand document. Microsoft's four-square logo is one of the most-protected marks on the internet; no asset files are bundled here.\n"
  },
  "tags": [
    "tech",
    "enterprise",
    "productivity",
    "microsoft",
    "fluent"
  ],
  "palette": {
    "ref": "microsoft@1.0.0",
    "swatches": [
      {
        "id": "microsoft-red",
        "name": "Microsoft Red",
        "value": "#F25022",
        "description": "Top-left quadrant of the Microsoft four-square logo. Used for Office, PowerPoint, and the warm corner of the corporate mark.\n",
        "aliases": []
      },
      {
        "id": "microsoft-green",
        "name": "Microsoft Green",
        "value": "#7FBA00",
        "description": "Top-right quadrant. Associated with Excel and the productivity side of the brand. (Sometimes also documented as #7CBB00.)\n",
        "aliases": []
      },
      {
        "id": "microsoft-blue",
        "name": "Microsoft Blue (Logo)",
        "value": "#00A4EF",
        "description": "Bottom-left quadrant of the logo — Windows blue, lighter than the Communications primary.\n",
        "aliases": []
      },
      {
        "id": "microsoft-yellow",
        "name": "Microsoft Yellow",
        "value": "#FFB900",
        "description": "Bottom-right quadrant. Often associated with Microsoft Build / developer surfaces.\n",
        "aliases": []
      },
      {
        "id": "communications-blue",
        "name": "Communications Blue",
        "value": "#0078D4",
        "description": "Microsoft's primary communications blue — the Fluent system primary used across Microsoft 365, the corporate site, and product UI chrome.\n",
        "aliases": []
      },
      {
        "id": "microsoft-black",
        "name": "Microsoft Black",
        "value": "#000000",
        "description": "Wordmark fill and primary text on light backgrounds.",
        "aliases": []
      },
      {
        "id": "microsoft-near-black",
        "name": "Microsoft Near-Black",
        "value": "#1F1F1F",
        "description": "Softer near-black for body text and dark surfaces.",
        "aliases": []
      },
      {
        "id": "microsoft-gray-160",
        "name": "Microsoft Gray 160",
        "value": "#605E5C",
        "description": "Secondary text and inactive UI (Fluent Neutral Foreground 2).",
        "aliases": []
      },
      {
        "id": "microsoft-gray-130",
        "name": "Microsoft Gray 130",
        "value": "#8A8886",
        "description": "Tertiary text and dividers (Fluent Neutral Foreground 3).",
        "aliases": []
      },
      {
        "id": "microsoft-gray-30",
        "name": "Microsoft Gray 30",
        "value": "#EDEBE9",
        "description": "Subtle surface tint (Fluent Neutral Background 3).",
        "aliases": []
      },
      {
        "id": "microsoft-gray-20",
        "name": "Microsoft Gray 20",
        "value": "#F3F2F1",
        "description": "Page-level background (Fluent Neutral Background 2).",
        "aliases": []
      },
      {
        "id": "microsoft-white",
        "name": "Microsoft White",
        "value": "#FFFFFF",
        "description": "Base background and reversed text on chromatic surfaces.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "microsoft-white",
          "surface": "microsoft-gray-20",
          "surface-elevated": "microsoft-white",
          "text-primary": "microsoft-near-black",
          "text-secondary": "microsoft-gray-160",
          "text-tertiary": "microsoft-gray-130",
          "primary": "communications-blue",
          "primary-hover": "microsoft-blue",
          "accent": "microsoft-blue",
          "accent-hover": "communications-blue",
          "warning": "microsoft-yellow",
          "warning-hover": "microsoft-red",
          "error": "microsoft-red",
          "success": "microsoft-green"
        }
      },
      "dark": {
        "roles": {
          "background": "microsoft-near-black",
          "surface": "microsoft-black",
          "surface-elevated": "microsoft-gray-160",
          "text-primary": "microsoft-white",
          "text-secondary": "microsoft-gray-30",
          "text-tertiary": "microsoft-gray-130",
          "primary": "microsoft-blue",
          "primary-hover": "communications-blue",
          "accent": "communications-blue",
          "accent-hover": "microsoft-blue",
          "warning": "microsoft-yellow",
          "warning-hover": "microsoft-red",
          "error": "microsoft-red",
          "success": "microsoft-green"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "segoe-ui@1.0.0",
      "family": "Segoe UI",
      "classification": "sans-serif",
      "source": {
        "kind": "system",
        "stack": [
          "Segoe UI Variable",
          "Segoe UI",
          "system-ui",
          "-apple-system",
          "BlinkMacSystemFont",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ]
      },
      "fallbackStack": [
        "system-ui",
        "Inter",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        }
      ]
    },
    {
      "role": "body",
      "ref": "segoe-ui@1.0.0",
      "family": "Segoe UI",
      "classification": "sans-serif",
      "source": {
        "kind": "system",
        "stack": [
          "Segoe UI Variable",
          "Segoe UI",
          "system-ui",
          "-apple-system",
          "BlinkMacSystemFont",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ]
      },
      "fallbackStack": [
        "system-ui",
        "Inter",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        }
      ]
    },
    {
      "role": "mono",
      "ref": "cascadiacode-nerdfont@1.0.0",
      "family": "CaskaydiaCove Nerd Font",
      "classification": "monospace",
      "source": {
        "kind": "external",
        "family": "CaskaydiaCove Nerd Font",
        "notes": "Nerd-Font-patched build of Cascadia Code (renamed CaskaydiaCove for distribution). 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": [
        "Cascadia Code",
        "JetBrains Mono",
        "Menlo",
        "Monaco",
        "Consolas",
        "Liberation Mono",
        "monospace"
      ],
      "availableStyles": [
        {
          "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"
        }
      ]
    }
  ],
  "roles": {
    "colors": {
      "identity": "communications-blue",
      "on-identity": "microsoft-white",
      "primary": "communications-blue",
      "primary-hover": "microsoft-blue",
      "accent": "microsoft-blue",
      "background": "microsoft-white",
      "surface": "microsoft-gray-20",
      "text-primary": "microsoft-near-black",
      "text-secondary": "microsoft-gray-160",
      "logo-quadrant-red": "microsoft-red",
      "logo-quadrant-green": "microsoft-green",
      "logo-quadrant-blue": "microsoft-blue",
      "logo-quadrant-yellow": "microsoft-yellow"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "logo.quadrants",
      "severity": "error",
      "rationale": "The Microsoft four-square logo uses the canonical quadrant hues (#F25022, #7FBA00, #00A4EF, #FFB900). Communications Blue (#0078D4) is the Fluent system primary for UI chrome, not a logo fill.\n",
      "allowed": [
        "microsoft-red",
        "microsoft-green",
        "microsoft-blue",
        "microsoft-yellow"
      ],
      "forbidden": [
        "communications-blue"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "Microsoft's brand guidelines explicitly prohibit altering the proportions, colors, or arrangement of the four-square mark, and require sufficient clearspace around the logo on any surface.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "on-busy-photo",
        "separated-quadrants"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "WCAG 2.1 Level AA contrast requirement for body text. Microsoft Near-Black (#1F1F1F) on Microsoft White clears AA at ~17:1, and Fluent's accessibility guidance specifies AA as the floor for text-on-background pairings.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contrastRatio",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Communications Blue on Microsoft White must remain perceptible at link / large-text sizes. Below 3:1, interactive affordance collapses — Fluent's color system relies on this contrast to signal \"clickable.\"\n",
      "against": "background",
      "minRatio": 3,
      "standard": "WCAG-AA-large"
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "The four logo-quadrant hues belong together as the brand mark. Pairing Communications Blue with one quadrant hue alone (without the full quadrant set) reads as a brand-identity conflict rather than a coordinated palette.\n",
      "doesNotPairWith": [
        "microsoft-red",
        "microsoft-green",
        "microsoft-yellow"
      ]
    },
    {
      "type": "fontPairing",
      "target": "typography.heading",
      "severity": "recommendation",
      "rationale": "Fluent uses Segoe UI for both heading and body. Maintain a meaningful size ratio (Fluent's type ramp goes from Caption at ~12px to Title at ~32px+) to preserve hierarchy when one family does double duty.\n",
      "requires": "body",
      "minSizeRatio": 1.4
    },
    {
      "type": "enumMembership",
      "target": "typography.body.fontWeight",
      "severity": "recommendation",
      "rationale": "Fluent's type ramp uses Segoe UI Regular (400) and Semibold (600) for the majority of UI surfaces. Other weights exist but are reserved for specific roles (Light for hero display, Bold for emphasis).\n",
      "allowed": [
        "400",
        "600"
      ]
    }
  ]
}