{
  "id": "telegram",
  "version": "1.0.0",
  "name": "Telegram",
  "description": "Telegram is the cloud-based messaging, voice-, video-, and channel- broadcast platform built by Telegram FZ-LLC / Telegram Messenger Inc., serving over 900 million monthly users with a posture oriented around speed, openness (a documented API), and optional end-to-end encryption (\"Secret Chats\"). The brand voice is technical, candid, and confident — \"simple. private. fast.\" Visually, Telegram is anchored on Telegram Blue (#0088CC), the saturated sky- blue used on the paper-plane mark, primary CTAs, links across the marketing site, and the outgoing-message bubble. Telegram is dual- mode by canonical identity: the desktop and mobile clients render the blue accent on a near-white canvas (light) or a deep slate canvas #212429 (dark), with the blue serving as the consistent primary across both surfaces.\n",
  "provenance": {
    "source": "https://telegram.org/",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "Telegram and the Telegram paper-plane logo are trademarks of Telegram FZ-LLC / Telegram Messenger Inc. Brand-asset distribution policy and the press-kit logo files are linked from telegram.org/brand; the signature Telegram Blue (#0088CC) is documented in the simple-icons brand database (citing telegram.org) and corroborated by the deployed telegram.org marketing surface, where every anchor link resolves to rgb(0,136,204). Supporting blue/neutral tones in the brand atom were captured from the same deployed CSS.\n",
    "importedDate": "2026-05-18",
    "notes": "Derived from live site CSS at https://telegram.org/ on 2026-05-18; the published telegram.org/brand page is policy- and asset-link only (no hex codes in the visible content), so the supporting scale was captured from the deployed marketing-site stylesheet. Telegram does not ship a proprietary type family — the marketing site uses Lucida Grande / Helvetica Neue system stacks, the Android client uses Roboto, and iOS / macOS use SF Pro. This atom references Roboto@1 as the open-source rendering substitute consistent with the Android client (Telegram's most-installed surface). The brand-asset policy expressly forbids re-distribution outside the documented press-kit channels, so `assets: []` is the correct posture for this catalog.\n"
  },
  "tags": [
    "telegram",
    "messaging",
    "blue",
    "communications",
    "mobile-first",
    "cloud",
    "open-api"
  ],
  "palette": {
    "ref": "telegram@1.0.0",
    "swatches": [
      {
        "id": "telegram-blue",
        "name": "Telegram Blue",
        "value": "#0088CC",
        "description": "Signature Telegram sky-blue — the brand's primary color, used on the paper-plane mark, primary CTAs, links across the marketing site, and the outgoing-message bubble.\n",
        "aliases": []
      },
      {
        "id": "telegram-blue-dark",
        "name": "Telegram Blue Dark",
        "value": "#006699",
        "description": "Pressed / active variant of Telegram Blue — used on the hover and pressed states of primary buttons.\n",
        "aliases": []
      },
      {
        "id": "telegram-blue-100",
        "name": "Telegram Blue 100",
        "value": "#E5F1FA",
        "description": "Pale tint — used as a hover wash and link-highlight surface.",
        "aliases": []
      },
      {
        "id": "telegram-blue-300",
        "name": "Telegram Blue 300",
        "value": "#3CA1EB",
        "description": "Mid-light blue — used in illustration and link-hover states.",
        "aliases": []
      },
      {
        "id": "telegram-blue-400",
        "name": "Telegram Blue 400",
        "value": "#30AAFD",
        "description": "Bright blue accent — the brightest blue used on the marketing surface.",
        "aliases": []
      },
      {
        "id": "telegram-blue-500",
        "name": "Telegram Blue 500",
        "value": "#2481CC",
        "description": "Telegram's \"Apple-app store\" blue tone — used in promotional iconography.",
        "aliases": []
      },
      {
        "id": "telegram-blue-600",
        "name": "Telegram Blue 600",
        "value": "#1C93E3",
        "description": "Deeper marketing accent blue.",
        "aliases": []
      },
      {
        "id": "telegram-blue-700",
        "name": "Telegram Blue 700",
        "value": "#1A8AD5",
        "description": "Header accent blue — used on the marketing-site nav highlight.",
        "aliases": []
      },
      {
        "id": "telegram-blue-800",
        "name": "Telegram Blue 800",
        "value": "#1482D1",
        "description": "Deep accent — used on the marketing-site button-hover.",
        "aliases": []
      },
      {
        "id": "telegram-white",
        "name": "Telegram White",
        "value": "#FFFFFF",
        "description": "Pure white — primary surface on the marketing site and light-mode chat canvas.",
        "aliases": []
      },
      {
        "id": "telegram-surface-light",
        "name": "Telegram Surface Light",
        "value": "#F7F7F7",
        "description": "Light-mode elevated surface — the chat-list rail on the iOS client.",
        "aliases": []
      },
      {
        "id": "telegram-border-light",
        "name": "Telegram Border Light",
        "value": "#E6E6E6",
        "description": "Quiet divider on the marketing-site surface.",
        "aliases": []
      },
      {
        "id": "telegram-text-on-light",
        "name": "Telegram Text on Light",
        "value": "#333333",
        "description": "Primary text on the marketing-site and light-mode chat canvas.",
        "aliases": []
      },
      {
        "id": "telegram-text-secondary-light",
        "name": "Telegram Text Secondary Light",
        "value": "#7D7F81",
        "description": "Secondary text on light-mode surfaces.",
        "aliases": []
      },
      {
        "id": "telegram-canvas-dark",
        "name": "Telegram Canvas Dark",
        "value": "#212429",
        "description": "Deep slate — Telegram's dark-mode chat canvas tone (the \"Night\" theme baseline), captured from the deployed telegram.org dark-mode stylesheet.\n",
        "aliases": []
      },
      {
        "id": "telegram-surface-dark",
        "name": "Telegram Surface Dark",
        "value": "#262A2E",
        "description": "Dark-mode elevated surface — chat-list rail and top bar.",
        "aliases": []
      },
      {
        "id": "telegram-surface-dark-elevated",
        "name": "Telegram Surface Dark Elevated",
        "value": "#33373D",
        "description": "Dark-mode deepest-elevated surface.",
        "aliases": []
      },
      {
        "id": "telegram-text-on-dark",
        "name": "Telegram Text on Dark",
        "value": "#FFFFFF",
        "description": "Primary text on the dark-mode canvas.",
        "aliases": []
      },
      {
        "id": "telegram-text-secondary-dark",
        "name": "Telegram Text Secondary Dark",
        "value": "#84888C",
        "description": "Secondary text and timestamps on the dark canvas.",
        "aliases": []
      },
      {
        "id": "telegram-surface-dark-deep",
        "name": "Telegram Surface Dark Deep",
        "value": "#1E1E1E",
        "description": "Deepest dark surface — used as the chat-input background.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "telegram-white",
          "surface": "telegram-surface-light",
          "surface-elevated": "telegram-white",
          "text-primary": "telegram-text-on-light",
          "text-secondary": "telegram-text-secondary-light",
          "text-tertiary": "telegram-text-secondary-light",
          "primary": "telegram-blue",
          "primary-hover": "telegram-blue-800",
          "accent": "telegram-blue",
          "accent-hover": "telegram-blue-700",
          "warning": "telegram-blue-400",
          "warning-hover": "telegram-blue-700",
          "error": "telegram-blue-dark",
          "success": "telegram-blue",
          "border": "telegram-border-light"
        }
      },
      "dark": {
        "roles": {
          "background": "telegram-canvas-dark",
          "surface": "telegram-surface-dark",
          "surface-elevated": "telegram-surface-dark-elevated",
          "text-primary": "telegram-text-on-dark",
          "text-secondary": "telegram-text-secondary-dark",
          "text-tertiary": "telegram-text-secondary-dark",
          "primary": "telegram-blue-300",
          "primary-hover": "telegram-blue-400",
          "accent": "telegram-blue-300",
          "accent-hover": "telegram-blue-400",
          "warning": "telegram-blue-400",
          "warning-hover": "telegram-blue-700",
          "error": "telegram-blue-dark",
          "success": "telegram-blue-300",
          "border": "telegram-surface-dark-elevated"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "roboto@1.0.0",
      "family": "Roboto",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Roboto",
        "url": "https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,100..900;1,100..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 100,
          "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": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 900,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "italic"
        }
      ]
    },
    {
      "role": "body",
      "ref": "roboto@1.0.0",
      "family": "Roboto",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Roboto",
        "url": "https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,100..900;1,100..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 100,
          "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": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "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": "telegram-blue",
      "on-identity": "telegram-white",
      "background": "telegram-white",
      "surface": "telegram-surface-light",
      "surface-elevated": "telegram-white",
      "text-primary": "telegram-text-on-light",
      "text-secondary": "telegram-text-secondary-light",
      "primary": "telegram-blue",
      "primary-hover": "telegram-blue-800",
      "accent": "telegram-blue",
      "accent-hover": "telegram-blue-700",
      "mark": "telegram-blue",
      "success": "telegram-blue",
      "warning": "telegram-blue-400",
      "error": "telegram-blue-dark"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "wordmark": "heading",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "logo.mark",
      "severity": "error",
      "rationale": "The Telegram paper-plane mark renders in Telegram Blue (#0088CC) on light surfaces and reverses to white on the dark canvas — the two approved color treatments documented in the press-kit assets linked from telegram.org/brand. Recoloring into a pale tint, the pressed-state dark blue, or any of the supporting surface neutrals violates the brand-mark policy.\n",
      "allowed": [
        "telegram-blue",
        "telegram-white"
      ],
      "forbidden": [
        "telegram-blue-100",
        "telegram-blue-dark",
        "telegram-canvas-dark"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "The Telegram brand-asset policy prescribes the paper-plane mark in its approved variants only. Recoloring the mark, flattening the paper-plane silhouette, applying decorative effects, or combining the mark with a third-party logo to imply partnership violates the brand-use license linked from telegram.org/brand.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "gradient-fill",
        "on-busy-photo",
        "flattened-paper-plane",
        "combined-with-other-logo",
        "used-as-verb"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "WCAG 2.1 Level AA contrast minimum for body text. Telegram Text on Light (#333333) on the white canvas reads at roughly 12.6:1, and Text on Dark (#FFFFFF) on Canvas Dark (#212429) reads at roughly 15.4:1 — both clear AA decisively. The rule encodes the floor for any new foreground/background pairing introduced on Telegram-skinned surfaces.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contrastRatio",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Telegram Blue (#0088CC) on the white canvas must remain perceptible at interactive sizes. Falling below 3:1 (AA-large) compromises the affordance of the primary CTA, the inline link color, and the paper-plane send button — all of which read as blue-on-white in the canonical product surface.\n",
      "against": "background",
      "minRatio": 3,
      "standard": "WCAG-AA-large"
    },
    {
      "type": "variantSelection",
      "target": "logo",
      "severity": "error",
      "rationale": "On the canonical Telegram Canvas Dark surface (#212429) the paper-plane mark renders in white for legibility. The blue-on-dark mark variant must not be used on the dark canvas where contrast against the surface drops below the AA-large floor for interactive elements.\n",
      "when": {
        "backgroundColorScheme": "dark"
      },
      "use": "mark-white"
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.identity",
      "severity": "error",
      "rationale": "Telegram's brand-asset policy prohibits use of the Telegram name, paper-plane mark, or signature blue in ways that imply official affiliation or endorsement, on unlicensed merchandise, or on a competing messaging app's surface. Encoding the policy as a context restriction lets consumers reject impermissible placements.\n",
      "forbiddenContexts": [
        "product-of-competitor",
        "merchandise",
        "endorsement-implication",
        "sponsorship-implication",
        "app-impersonation"
      ]
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "Telegram Blue reads cleanest against white, the deep slate dark canvas, or the very-dark text tone. Pairing the primary blue adjacent to the pale tint (#E5F1FA) or the mid-light blue-300 (#3CA1EB) collapses the primary-vs-secondary hierarchy and washes the brand's recognisable saturation.\n",
      "pairsWith": [
        "telegram-white",
        "telegram-canvas-dark",
        "telegram-text-on-light",
        "telegram-surface-light"
      ],
      "doesNotPairWith": [
        "telegram-blue-100",
        "telegram-blue-300"
      ]
    },
    {
      "type": "enumMembership",
      "target": "typography.heading.fontWeight",
      "severity": "warning",
      "rationale": "Roboto, the type family used by the Telegram Android client, ships across Thin (100) through Black (900) but Telegram's product UI sits in the Regular (400), Medium (500), and Bold (700) band — the same three weights surfaced in the Android client's typography spec. Lighter or heavier cuts drift from the brand's practical, technical voice.\n",
      "allowed": [
        "400",
        "500",
        "700"
      ]
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "error",
      "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Telegram's global user base and the dual light/dark canvas commitment make AA contrast checks the default verification on any new role pairing introduced on Telegram-skinned surfaces.\n",
      "standard": "WCAG-AA",
      "criterion": "1.4.3"
    },
    {
      "type": "fontPairing",
      "target": "typography.display",
      "severity": "warning",
      "rationale": "Telegram's marketing display runs substantially larger than the chat / prose copy on the telegram.org marketing site. A 1.5× minimum size ratio between display and prose preserves the announcement-style hierarchy the brand voice depends on when rendered through the Roboto substitute.\n",
      "requires": "prose",
      "minSizeRatio": 1.5
    }
  ]
}