About Telegram DESIGN.md
Curated by Dov AzencotUpdated Source telegram.org
- Communication & Messaging
Telegram's marketing site is the loudest argument against the past decade of brand-system inflation. The page is pure white. The paper-airplane mark sits at the top in cyan. The wordmark "Telegram" sits in cyan at 26px, the dek "a new era of messaging" in graphite below at 20px Helvetica Neue Light, and that is the entire above-fold composition — no hero illustration, no gradient, no shadow, no rounded CTA pill. Below the fold the page lists nine product principles in a 3-by-3 grid of cartoon ducks, each label rendered in the same single cyan, each sentence in the same single graphite. Where WhatsApp paints its hero in jade green and pushes a download-app CTA, where Signal leans on an indigo gradient and animated illustrations, Telegram refuses every convention of the category — there is no CTA above the fold, no app-store badge in the hero, no scroll-driven motion, no captured email field. The restraint is the position: a Dubai-based messenger that has shed Western design tropes alongside Western advertising tracking.
The DESIGN.md file packages the system into a machine-readable spec for React tooling. Inside: 5 color tokens — a single cyan voltage, four neutral inks — drawn from the seven colors the page renders at all; 7 typography tokens running the platform Lucida Grande stack (with one Helvetica Neue Light moment for the dek); zero declared border-radius tokens because the captured surface has no rounded chrome (the input field on the search overlay rounds to 0px, the news cards have no radius, the icons are circular only because they are SVGs); 8 spacing values on a 4px base; and 14 component definitions covering the cyan link, the cyan heading, the graphite body, the cartoon-duck principle tile, the news card, and the footer columns.
Feed this file to an AI coding tool and it reproduces Telegram's specific moves: a single saturated cyan instead of a hero-friendly indigo, the system Lucida Grande stack instead of Inter or Geist, zero corner-radius tokens, zero shadow tier, and a 3-by-3 product-principle grid where the labels share the same color and weight rather than tiering visually. Borrow the move only if your positioning is willing to read as anti-design — Telegram gets away with it because the brand's central promise is the absence of the chrome (no algorithmic feed, no ad inventory, no engagement-metric pressure). Most teams need at least one rounded surface to look "real" in 2026.
What makes it distinct
- Single cyan voltage#0088cc covers every link, heading, brand mark, and product-principle label, never reserved for one CTA the way most SaaS systems hold accents
- Lucida Grande system stackno web font, no Inter, no Helvetica Neue Display; the page renders in whatever the OS ships, which keeps page-weight near-zero
- Anti-design as positioningno rounded chrome, no shadow tier, no hover states declared; the visual restraint is a privacy posture against the Meta family
- 26px / weight 400 / -1px tracking displayevery principle label uses the same tight setting, making the 3-by-3 mascot grid scan as one editorial unit
- Cartoon-duck mascots as iconographyTelegram's signature illustration style replaces the gradient-icon convention every messaging peer leans on
Live at telegram.org
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
telegram.orgExplore Telegram
Pick what you want to see — mockups, colors, typography, layout, or the full component list.
Brand & Accent
Sparing, CTA-only voltage.
Surface
Page and card backgrounds.
Text
Headlines, body, captions, muted.
Other
Specialty colors.
Telegram design system FAQ
Common questions about Telegram's tokens, components, and how to use this DESIGN.md in your project.
Related reading
Specs, directories, and component libraries that pair with this design system.
Browse all design systems
The full directory of DESIGN.md files on shadcn.io, with live mockups for each.
Telegram — official site
Telegram's public marketing site — the source of truth for the live tokens captured in this file.
The DESIGN.md specification
Google Labs' open spec for machine-readable design system files — the format this page is built on.