Telegram Mobile — decoded design system

telegram.org · light · consumer · deep decode — measured live

Telegram Mobile's design system, decoded live by Mozaika: measured color roles, type scale, buttons with real hover/focus states, motion and the brand's own tokens.

Open in Mozaika →

This is a static, crawlable rendering for search & AI engines. The interactive version — filters, live decode console, copy & export — is at https://mozaika.design/decode/telegram.org.

Decoded design system

Telegram Mobile's decoded design system: background #FFFFFF, text #333333, accent #192F40, link #0088CC, primary #192F40; type scale h1 26px / h2 23px / body 15px; 5px spacing base; 12px base radius. The single interactive/action color is #192F40 — used only on interactive or must-notice elements (buttons, links, key highlights), never on large fills.

Color roles

Using these colors

• Action color #192F40 — the single interactive color; only on things you click or must notice, never large fills.
• primary, accent, button_bg are all #192F40 — one role, not several (the action color).
• accent #192F40 — THE accent / action color — interactive & must-notice only (buttons, links, focus, one key highlight); never large fills or backgrounds. Scarcity is what makes it read as designed.
• link #0088CC — inline text links and link-styled controls.

Typography

• Heading: -apple-system
• Body: -apple-system
• h1: 26px
• h2: 23px
• body: 15px

Spacing

• base unit: 5px
• scale: 5px, 9px, 10px, 14px, 15px, 16px, 17px, 20px, 28px, 34px

Radii

• base: 12px
• button: 0px

Shadows (elevation)

• subtle: rgba(0, 0, 0, 0.1) 1px 1px 3px 1px

Motion

Micro-interactions run at 100ms (dominant) with ease-in-out.

• durations: 100ms · 200ms · 150ms
• easings: ease-in-out · ease
• animated properties: opacity, box-shadow, transform

Native design tokens

Layout (measured)

• container max-width: 925px

Motion choreography (measured)

Load order: div.tl_main_logo

Responsive (measured)

• breakpoints: 480px · 640px · 768px · 992px · 1200px
• mobile (390px): nav inline

Install it

Drop this measured system into any shadcn/Tailwind project in one command:

npx shadcn add mozaika.design/r/decode/telegram.org

Or as a Meta Astryx theme — a ready defineTheme file with the measured hover/press states baked in:

curl -o src/themes/telegram.theme.ts https://mozaika.design/api/astryx/decode/telegram.org.ts

registry item · astryx theme · or query it over MCP: get_design_system("Telegram Mobile")

Export: DESIGN.md

# Telegram Mobile — Design System

> light, consumer, high — deep decode (measured live)

## Colors

| Role | Value |
|------|-------|
| bg | `#FFFFFF` |
| surface | `#F2F2F2` |
| border | `#E0E0E0` |
| text | `#333333` |
| text_muted | `#808080` |
| primary | `#192F40` |
| accent | `#192F40` |
| link | `#0088CC` |
| button_bg | `#192F40` |
| button_text | `#0088CC` |

**Using these colors**

- **Action color** `#192F40` — the single interactive color; it appears only on things you click or must notice (buttons, key highlights), never on large fills or backgrounds.
- `primary`, `accent`, `button_bg` are all `#192F40` — one role, not several (your action color).
- **accent** `#192F40` — THE accent / action color — interactive & must-notice only (buttons, links, focus, one key highlight); never large fills or backgrounds. Scarcity is what makes it read as designed.
- **link** `#0088CC` — inline text links and link-styled controls.
- **Page coverage** (full-page screenshot pixels): `#FFFFFF` 85.9% · `#B8D9DE` 2.7% · `#B2B1C4` 2.7% · `#242630` 2.4%

## Typography

- Heading: **-apple-system**
- Body: **-apple-system**

| Role | Size / weight · line-height · tracking |
|------|------------------------------------------|
| hero | 26px / 600 · lh 29px |
| h2 | 23px / 600 · lh 25px |
| h3 | 20px / 300 · lh 30px |
| body | 15px / 400 · lh 24px |
| small | 14px / 400 · lh 23px |

- Weight ladder: 300 · 400 · 500 · 600 · 700 — use these exact measured weights, not the 400/600 defaults.

> **Fonts —** -apple-system — system font, no web load needed.

## Spacing
- base unit: 5px (inferred from the measured scale)
- measured scale: 5px, 9px, 10px, 14px, 15px, 16px, 17px, 20px, 28px, 34px — snap all gaps/padding to these

## Radius
- base: 12px
- button: 0px
- pill: 9999px

## Buttons

| Button | Fill / text | Border | Radius | Padding | Font | Shadow |
|--------|-------------|--------|--------|---------|------|--------|
| primary | `rgba(0, 0, 0, 0)` / `#0088CC` | none | 0px | 15.5px 15px 15.5px 15px | 500 15px | none |

## Shadows (elevation)
- subtle: `rgba(0, 0, 0, 0.1) 1px 1px 3px 1px`

## Motion
- durations: 100ms (dominant) · 200ms · 150ms
- easings: `ease-in-out` (dominant) · `ease`
- animated properties: opacity, box-shadow, transform

Micro-interactions use the dominant duration + easing; nothing on the page animates slower than the longest duration above — don't invent springier motion.

## Their own tokens (verbatim from :root)

| Token | Value |
|-------|-------|
| `--bullet-color` | `#0088cc` |
| `--native-font` | `-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif` |
| `--native-mono-font` | `ui-monospace, "SFMono-Regular", "SF Mono", Consolas, "Liberation Mono", Menlo, monospace` |
| `--doc-font-size` | `15px` |
| `--doc-space` | `16px` |
| `--side-nav-font-size` | `13px` |
| `--side-nav-width` | `240px` |
| `--side-nav-top` | `72px` |
| `--side-nav-right` | `16px` |

Prefer these names when extending their system — it's the brand's actual vocabulary.

## Layout (measured)
- container max 925px

| Section (y) | Height | Cols | Gap | Pad y | Split |
|---|---|---|---|---|---|
| 748 | 291 | — | — | 0/0 | — |

## Motion choreography (measured)
Load order: `div.tl_main_logo` @0ms

Rebuild the timeline, not just the durations — order, delays and staggers above are the choreography.

## Responsive (measured)
- breakpoints: 480px · 640px · 768px · 992px · 1200px
- mobile (390px): body 12px · nav: inline

## How to apply
Paste the Tailwind `@theme` (or CSS variables) as your base, then build each
section to its spec — verify every color, radius, and font against these tokens.
Hover/focus states, shadows and motion timings above are measured from the live page — match them exactly, don't re-guess them.

---

> **Decoded with Mozaika** — measured live, not guessed. Full decoded design system + one-command install: mozaika.design/decode/telegram.org

← All decoded design systems

An automated reading of Telegram Mobile's publicly-visible CSS (colors, fonts, spacing, motion) — not affiliated with telegram.org. No screenshots stored. Removal requests: hello@mozaika.design.