{
  "id": "aws",
  "version": "1.0.0",
  "name": "Amazon Web Services",
  "description": "Amazon Web Services (AWS) is the cloud-computing subsidiary of Amazon.com, Inc., providing on-demand compute, storage, networking, databases, machine-learning, and developer-platform services. The AWS sub-brand carries Amazon Smile Orange forward — the same orange arrow that signs the Amazon wordmark — but operates against a deep- navy Squid Ink canvas (#232F3E) that defines the AWS Management Console and the AWS architecture-diagram visual language. The voice is engineering-direct, service-density forward, and welcoming to the long-form technical reader: AWS docs, AWS re:Invent slides, and AWS Architecture Center diagrams all share the same dark-canvas / orange-accent dialect.\n",
  "provenance": {
    "source": "https://aws.amazon.com/architecture/icons/",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "Amazon Web Services, AWS, the AWS logo, the AWS arrow-and-smile, Amazon, and Amazon Ember are trademarks of Amazon.com, Inc. or its affiliates. Brand colors and identity guidance documented here are derived from the AWS Architecture Icons toolkit (aws.amazon.com/architecture/icons/), the AWS Brand Guidelines, and the AWS Cloudscape Design System (cloudscape.design).\n",
    "importedDate": "2026-05-18",
    "notes": "AWS is documented separately from the Amazon parent brand because AWS carries its own canvas convention (dark-first navy), its own interactive-blue link color (Cloudscape #0972D3), and its own audience (developers and architects) distinct from the Amazon retail consumer brand. The shared Smile Orange and Amazon Ember typography preserve the Amazon family resemblance. No assets are bundled here — AWS marks are trademarked and must be retrieved from the AWS Architecture Icons toolkit under Amazon's stated terms.\n"
  },
  "tags": [
    "tech",
    "cloud",
    "aws",
    "amazon",
    "infrastructure",
    "dark-canvas",
    "parent-amazon"
  ],
  "palette": {
    "ref": "aws@1.0.0",
    "swatches": [
      {
        "id": "aws-smile-orange",
        "name": "AWS Smile Orange",
        "value": "#FF9900",
        "description": "The signature AWS orange — the arrow-and-smile that identifies the AWS sub-brand and the principal CTA color across aws.amazon.com.\n",
        "aliases": []
      },
      {
        "id": "aws-rind",
        "name": "AWS Rind",
        "value": "#EC7211",
        "description": "Deeper orange used on pressed/active states for the primary CTA and as the headline accent on dark canvases.\n",
        "aliases": []
      },
      {
        "id": "aws-squid-ink",
        "name": "AWS Squid Ink",
        "value": "#232F3E",
        "description": "The AWS Management Console chrome navy. The canonical dark-canvas color across AWS architecture diagrams and the Architecture Icons toolkit.\n",
        "aliases": []
      },
      {
        "id": "aws-anchor",
        "name": "AWS Anchor",
        "value": "#161E2D",
        "description": "Darker navy used on console mega-navigation surfaces and the dark-mode page canvas.\n",
        "aliases": []
      },
      {
        "id": "aws-navy-light",
        "name": "AWS Navy Light",
        "value": "#37475A",
        "description": "Secondary navigation band — sits one tone lighter than Squid Ink for layered chrome on the console.\n",
        "aliases": []
      },
      {
        "id": "aws-link",
        "name": "AWS Link",
        "value": "#0972D3",
        "description": "Console link / interactive blue. The AWS Cloudscape design system documents this hex as the link primary.\n",
        "aliases": []
      },
      {
        "id": "aws-link-hover",
        "name": "AWS Link Hover",
        "value": "#033160",
        "description": "Pressed/hovered state for the AWS console link blue.\n",
        "aliases": []
      },
      {
        "id": "aws-success",
        "name": "AWS Success",
        "value": "#037F0C",
        "description": "Cloudscape success green — used for confirmation states.",
        "aliases": []
      },
      {
        "id": "aws-error",
        "name": "AWS Error",
        "value": "#D13212",
        "description": "Cloudscape error red — destructive and validation-failure states.",
        "aliases": []
      },
      {
        "id": "aws-warning",
        "name": "AWS Warning",
        "value": "#B7740D",
        "description": "Cloudscape warning amber — caution / pending states.",
        "aliases": []
      },
      {
        "id": "aws-ink",
        "name": "AWS Ink",
        "value": "#16191F",
        "description": "Primary text on light surfaces — Cloudscape's neutral text.",
        "aliases": []
      },
      {
        "id": "aws-gray",
        "name": "AWS Gray",
        "value": "#545B64",
        "description": "Secondary text and metadata on light surfaces.",
        "aliases": []
      },
      {
        "id": "aws-gray-light",
        "name": "AWS Gray Light",
        "value": "#879596",
        "description": "Tertiary text and disabled UI on light surfaces.",
        "aliases": []
      },
      {
        "id": "aws-surface",
        "name": "AWS Surface",
        "value": "#F2F3F3",
        "description": "Quiet surface — Cloudscape page-level background tint.",
        "aliases": []
      },
      {
        "id": "aws-white",
        "name": "AWS White",
        "value": "#FFFFFF",
        "description": "Primary canvas on marketing surfaces and console cards.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "aws-white",
          "surface": "aws-surface",
          "surface-elevated": "aws-white",
          "text-primary": "aws-ink",
          "text-secondary": "aws-gray",
          "text-tertiary": "aws-gray-light",
          "primary": "aws-smile-orange",
          "primary-hover": "aws-rind",
          "accent": "aws-link",
          "accent-hover": "aws-link-hover",
          "warning": "aws-warning",
          "warning-hover": "aws-rind",
          "error": "aws-error",
          "success": "aws-success"
        }
      },
      "dark": {
        "roles": {
          "background": "aws-anchor",
          "surface": "aws-squid-ink",
          "surface-elevated": "aws-navy-light",
          "text-primary": "aws-white",
          "text-secondary": "aws-surface",
          "text-tertiary": "aws-gray-light",
          "primary": "aws-smile-orange",
          "primary-hover": "aws-rind",
          "accent": "aws-link",
          "accent-hover": "aws-link-hover",
          "warning": "aws-warning",
          "warning-hover": "aws-rind",
          "error": "aws-error",
          "success": "aws-success"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "amazon-ember@1.0.0",
      "family": "Amazon Ember",
      "classification": "sans-serif",
      "source": {
        "kind": "external",
        "family": "Amazon Ember",
        "notes": "Proprietary font, no public CDN. Distributed by Amazon to authorized agencies and vendors. Any @font-face declaration must reference internally hosted files under Amazon's licensing.\n"
      },
      "fallbackStack": [
        "Inter",
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        }
      ]
    },
    {
      "role": "body",
      "ref": "amazon-ember@1.0.0",
      "family": "Amazon Ember",
      "classification": "sans-serif",
      "source": {
        "kind": "external",
        "family": "Amazon Ember",
        "notes": "Proprietary font, no public CDN. Distributed by Amazon to authorized agencies and vendors. Any @font-face declaration must reference internally hosted files under Amazon's licensing.\n"
      },
      "fallbackStack": [
        "Inter",
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        }
      ]
    },
    {
      "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": "aws-squid-ink",
      "on-identity": "aws-smile-orange",
      "primary": "aws-smile-orange",
      "primary-hover": "aws-rind",
      "accent": "aws-link",
      "accent-hover": "aws-link-hover",
      "background": "aws-white",
      "surface": "aws-surface",
      "surface-elevated": "aws-white",
      "text-primary": "aws-ink",
      "text-secondary": "aws-gray",
      "text-tertiary": "aws-gray-light",
      "chrome": "aws-squid-ink",
      "chrome-deep": "aws-anchor",
      "chrome-light": "aws-navy-light",
      "mark-orange": "aws-smile-orange",
      "mark-canvas": "aws-squid-ink"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "logo.arrow.fill",
      "severity": "error",
      "rationale": "The AWS arrow-and-smile is canonical Smile Orange (#FF9900) — the same arrow as the Amazon parent wordmark. AWS Rind is a pressed CTA hover, not a mark fill. The Cloudscape Warning amber and Link blue carry semantic UI meanings and must not substitute for the brand mark.\n",
      "allowed": [
        "aws-smile-orange"
      ],
      "forbidden": [
        "aws-rind",
        "aws-warning",
        "aws-link"
      ]
    },
    {
      "type": "colorChoice",
      "target": "roles.colors.chrome",
      "severity": "error",
      "rationale": "AWS Management Console chrome and AWS architecture-diagram canvases use the Squid Ink navy family. Replacing the navy chrome with Smile Orange or pure White breaks the AWS visual contract — the orange is a signature accent, not the canvas.\n",
      "allowed": [
        "aws-squid-ink",
        "aws-anchor",
        "aws-navy-light"
      ],
      "forbidden": [
        "aws-smile-orange",
        "aws-white"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "The AWS arrow-and-smile is a registered Amazon trademark. The arrow must never be detached from the wordmark, recolored outside Smile Orange, or composed against a busy photographic surface that breaks its legibility. Gradient fills are not part of the AWS visual system.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "on-busy-photo",
        "arrow-detached",
        "gradient-fill"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "AWS Ink (#16191F) on AWS White gives ~17:1 — comfortably above WCAG 2.1 Level AA. Cloudscape's accessibility guidance specifies AA as the floor for any text-on-background pairing on the console and the docs site.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contrastRatio",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Smile Orange on AWS White sits around 3:1 — it clears AA-large for headlines and large interactive text but is unsafe for body-sized text. The rule encodes the AA-large floor so the orange CTA cannot be downsized into illegibility.\n",
      "against": "background",
      "minRatio": 3,
      "standard": "WCAG-AA-large"
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "The signature AWS composition is orange-on-navy or orange-on- white. Pairing Smile Orange directly with the Cloudscape link blue or warning amber creates a hue conflict that competes with the AWS brand signature.\n",
      "pairsWith": [
        "aws-squid-ink",
        "aws-anchor",
        "aws-white"
      ],
      "doesNotPairWith": [
        "aws-link",
        "aws-warning"
      ]
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "error",
      "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Cloudscape's published tokens are AA-compliant by construction; consumers must not derive intermediate stops that defeat that property.\n",
      "standard": "WCAG-AA",
      "criterion": "1.4.3"
    },
    {
      "type": "fontPairing",
      "target": "typography.heading",
      "severity": "recommendation",
      "rationale": "AWS marketing and console surfaces use Amazon Ember at a modest heading-to-body ratio — the dense technical-reference voice of the AWS docs favors a tighter hierarchy than marketing-led brands. A 1.4× floor preserves the display-to- prose distinction without overpowering the content density.\n",
      "requires": "body",
      "minSizeRatio": 1.4
    }
  ]
}
