{
  "id": "kubernetes",
  "version": "1.0.0",
  "name": "Kubernetes",
  "description": "Kubernetes is the open-source container-orchestration platform originally designed by Google and now maintained by the Cloud Native Computing Foundation (CNCF). The brand identity is anchored on the seven-spoked helm-wheel mark — a reference to the Greek \"κυβερνήτης\" (kubernetes, \"helmsman\") — filled with the signature Kubernetes Blue (#326CE5). The visual voice is community-led and engineering-direct: documentation-forward, diagram-friendly, and committed to the open-source convention of primary-source clarity over marketing flourish. The mark and the blue together form one of the most recognizable identities in cloud-native infrastructure.\n",
  "provenance": {
    "source": "https://kubernetes.io/community/branding/",
    "license": "Apache-2.0",
    "attribution": "Kubernetes is a registered trademark of The Linux Foundation / Cloud Native Computing Foundation. The Kubernetes name and logo are used under the CNCF trademark usage guidelines (cncf.io/brand-guidelines). The Kubernetes project source is licensed under Apache License 2.0; brand colors and identity guidance documented here are derived from the project's branding page (kubernetes.io/community/branding/), the kubernetes/community repository, and the CNCF Style Guide. Copyright The Kubernetes Authors / Cloud Native Computing Foundation.\n",
    "importedDate": "2026-05-18",
    "notes": "Kubernetes is the only Apache-2.0-licensed brand atom in this initial cloud-and-devops set — the project itself is open-source and the brand assets are governed by the CNCF trademark policy. No asset files are bundled here; the helm- wheel mark must be retrieved directly from the Kubernetes branding page under the CNCF brand guidelines. Use of the Kubernetes name and mark must comply with the Linux Foundation / CNCF trademark usage policy.\n"
  },
  "tags": [
    "tech",
    "kubernetes",
    "k8s",
    "cncf",
    "open-source",
    "infrastructure"
  ],
  "palette": {
    "ref": "kubernetes@1.0.0",
    "swatches": [
      {
        "id": "k8s-blue",
        "name": "Kubernetes Blue",
        "value": "#326CE5",
        "description": "The Kubernetes signature blue — the fill of the helm-wheel mark and the principal accent across kubernetes.io.\n",
        "aliases": []
      },
      {
        "id": "k8s-blue-dark",
        "name": "Kubernetes Blue Dark",
        "value": "#2956B2",
        "description": "Pressed/active state for the primary CTA.",
        "aliases": []
      },
      {
        "id": "k8s-blue-light",
        "name": "Kubernetes Blue Light",
        "value": "#7493E0",
        "description": "Soft accent used on illustrations and tags.",
        "aliases": []
      },
      {
        "id": "k8s-navy",
        "name": "Kubernetes Navy",
        "value": "#0B132B",
        "description": "Dark-mode canvas color — the navy used on the kubernetes.io dark-theme hero and on CNCF presentation chrome.\n",
        "aliases": []
      },
      {
        "id": "k8s-navy-deep",
        "name": "Kubernetes Navy Deep",
        "value": "#050911",
        "description": "Darkest navy used as the page-level dark canvas.",
        "aliases": []
      },
      {
        "id": "k8s-ink",
        "name": "Kubernetes Ink",
        "value": "#303030",
        "description": "Primary text on light surfaces.",
        "aliases": []
      },
      {
        "id": "k8s-gray",
        "name": "Kubernetes Gray",
        "value": "#5F6368",
        "description": "Secondary text and metadata.",
        "aliases": []
      },
      {
        "id": "k8s-gray-light",
        "name": "Kubernetes Gray Light",
        "value": "#9AA0A6",
        "description": "Tertiary text and disabled UI.",
        "aliases": []
      },
      {
        "id": "k8s-surface",
        "name": "Kubernetes Surface",
        "value": "#F1F3F4",
        "description": "Quiet surface — card backgrounds on kubernetes.io.",
        "aliases": []
      },
      {
        "id": "k8s-border",
        "name": "Kubernetes Border",
        "value": "#DADCE0",
        "description": "Hairline borders and dividers.",
        "aliases": []
      },
      {
        "id": "k8s-white",
        "name": "Kubernetes White",
        "value": "#FFFFFF",
        "description": "Primary canvas on light surfaces.",
        "aliases": []
      },
      {
        "id": "k8s-success",
        "name": "Kubernetes Success",
        "value": "#0F9D58",
        "description": "Healthy / ready pod state.",
        "aliases": []
      },
      {
        "id": "k8s-warning",
        "name": "Kubernetes Warning",
        "value": "#F4B400",
        "description": "Pending / scheduling state.",
        "aliases": []
      },
      {
        "id": "k8s-error",
        "name": "Kubernetes Error",
        "value": "#DB4437",
        "description": "Failed / crash-loop state.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "k8s-white",
          "surface": "k8s-surface",
          "surface-elevated": "k8s-white",
          "text-primary": "k8s-ink",
          "text-secondary": "k8s-gray",
          "text-tertiary": "k8s-gray-light",
          "primary": "k8s-blue",
          "primary-hover": "k8s-blue-dark",
          "accent": "k8s-blue-light",
          "accent-hover": "k8s-blue",
          "warning": "k8s-warning",
          "warning-hover": "k8s-error",
          "error": "k8s-error",
          "success": "k8s-success",
          "border": "k8s-border"
        }
      },
      "dark": {
        "roles": {
          "background": "k8s-navy-deep",
          "surface": "k8s-navy",
          "surface-elevated": "k8s-blue-dark",
          "text-primary": "k8s-white",
          "text-secondary": "k8s-surface",
          "text-tertiary": "k8s-gray-light",
          "primary": "k8s-blue-light",
          "primary-hover": "k8s-blue",
          "accent": "k8s-blue",
          "accent-hover": "k8s-blue-light",
          "warning": "k8s-warning",
          "warning-hover": "k8s-error",
          "error": "k8s-error",
          "success": "k8s-success",
          "border": "k8s-blue-dark"
        }
      }
    }
  },
  "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": "k8s-blue",
      "on-identity": "k8s-white",
      "primary": "k8s-blue",
      "primary-hover": "k8s-blue-dark",
      "accent": "k8s-blue-light",
      "accent-hover": "k8s-blue",
      "background": "k8s-white",
      "surface": "k8s-surface",
      "surface-elevated": "k8s-white",
      "text-primary": "k8s-ink",
      "text-secondary": "k8s-gray",
      "text-tertiary": "k8s-gray-light",
      "chrome": "k8s-navy",
      "chrome-deep": "k8s-navy-deep",
      "mark": "k8s-blue"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "logo.helm-wheel.fill",
      "severity": "error",
      "rationale": "The Kubernetes helm-wheel renders in Kubernetes Blue (#326CE5) or reversed white per the CNCF trademark guidelines. The darker pressed-state and the lighter illustration accent are interactive-state tokens and never mark fills.\n",
      "allowed": [
        "k8s-blue",
        "k8s-white"
      ],
      "forbidden": [
        "k8s-blue-dark",
        "k8s-blue-light",
        "k8s-navy"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "The CNCF trademark guidelines explicitly prohibit altering the proportions, color, or arrangement of the Kubernetes helm-wheel mark. The seven spokes are a defined feature of the mark and must not be modified.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "on-busy-photo",
        "spokes-altered",
        "gradient-fill"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "Kubernetes Ink (#303030) on Kubernetes White gives ~13:1 — well above WCAG 2.1 Level AA. The kubernetes.io documentation surface targets AA as the accessibility floor; consumers must not reduce this contrast.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contrastRatio",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Kubernetes Blue (#326CE5) on Kubernetes White gives ~5.1:1 — clearing WCAG AA for body-sized interactive text. The documentation site relies on this contrast for link legibility.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "The Kubernetes Blue pairs cleanly against the white canvas and the navy dark-mode chrome. Pairing the brand blue directly with the warning amber or error red on the same surface creates a status-color conflict that competes with the brand voice.\n",
      "pairsWith": [
        "k8s-white",
        "k8s-navy",
        "k8s-surface"
      ],
      "doesNotPairWith": [
        "k8s-warning",
        "k8s-error"
      ]
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "error",
      "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The kubernetes.io documentation surface and CNCF project sites both target AA as the floor for accessibility on open-source documentation.\n",
      "standard": "WCAG-AA",
      "criterion": "1.4.3"
    },
    {
      "type": "contextRestriction",
      "target": "logo.helm-wheel",
      "severity": "error",
      "rationale": "The Linux Foundation / CNCF trademark usage policy requires explicit permission for commercial endorsement or co-branding uses of the Kubernetes mark. Use of the helm-wheel to imply endorsement of a commercial product requires written approval from the CNCF.\n",
      "forbiddenContexts": [
        "commercial-endorsement",
        "product-co-branding-without-permission"
      ]
    },
    {
      "type": "fontPairing",
      "target": "typography.heading",
      "severity": "recommendation",
      "rationale": "The kubernetes.io documentation surface uses a single family for heading and body, with hierarchy established through size. A 1.5× heading-to-body floor preserves the display-to-prose distinction across the long-form reference content.\n",
      "requires": "body",
      "minSizeRatio": 1.5
    }
  ]
}