# AT&T — Design System
> Official site for AT&T wireless, internet, and tech deals.
- **Canonical:** https://uiuxskills.com/library/at-t
- **Source:** https://www.att.com/
- **Category:** Media & Consumer Tech
- **Compatible tools:** claude, cursor, lovable, figma-make
- **Coverage:** 81%
- **License:** MIT
- **Last updated:** 2026-10-22T23:34:29.105Z

---

---
version: alpha
name: AT&T
tagline: Great connections start here
description: Official site for AT&T wireless, internet, and tech deals.
tone: professional
color-scheme: light
colors:
  primary: "#00388F"
  secondary: "#009FDB"
  accent: "#0072B2"
  background: "#FFFFFF"
  surface: "#FFFFFF"
  surface-dim: "#F2FAFD"
  surface-container: "#F7F9FA"
  on-primary: "#FFFFFF"
  on-surface: "#1D2329"
  outline: "#686E74"
  error: "#D32F2F"
  success: "#2E7D32"
typography:
  display-lg:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 48px
    fontWeight: 700
    lineHeight: "1.2"
    letterSpacing: "-0.02em"
  display-md:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 36px
    fontWeight: 700
    lineHeight: "1.25"
    letterSpacing: "-0.01em"
  headline-lg:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 34px
    fontWeight: 700
    lineHeight: "1.3"
    letterSpacing: 0em
  headline-md:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 24px
    fontWeight: 700
    lineHeight: "1.35"
    letterSpacing: 0em
  headline-sm:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 20px
    fontWeight: 700
    lineHeight: "1.4"
    letterSpacing: 0em
  body-md:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 15px
    fontWeight: 400
    lineHeight: "1.5"
    letterSpacing: 0em
  body-sm:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 13px
    fontWeight: 400
    lineHeight: "1.5"
    letterSpacing: 0em
  label-md:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 14px
    fontWeight: 600
    lineHeight: "1.4"
    letterSpacing: 0.02em
  label-sm:
    fontFamily: AT&T Aleck Sans, sans-serif
    fontSize: 12px
    fontWeight: 600
    lineHeight: "1.4"
    letterSpacing: 0.05em
rounded:
  sm: 4px
  md: 8px
  lg: 12px
  xl: 16px
  full: 9999px
spacing:
  xs: 4px
  sm: 8px
  md: 16px
  lg: 24px
  xl: 32px
  2xl: 48px
components:
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    borderColor: "{colors.primary}"
  button-primary-hover:
    backgroundColor: "#00225C"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    borderColor: "#00225C"
  button-secondary:
    backgroundColor: "{colors.surface-dim}"
    textColor: "{colors.primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    borderColor: "{colors.primary}"
  card:
    backgroundColor: "{colors.surface}"
    rounded: "{rounded.md}"
    padding: 24px
    borderColor: "{colors.outline}"
  card-elevated:
    backgroundColor: "{colors.surface-container}"
    rounded: "{rounded.md}"
    padding: 24px
  input-field:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.md}"
    padding: 12px 16px
    borderColor: "{colors.outline}"
  input-field-focus:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.md}"
    padding: 12px 16px
    borderColor: "{colors.primary}"
  link:
    textColor: "{colors.accent}"
    typography: "{typography.label-md}"
  link-hover:
    textColor: "{colors.primary}"
    typography: "{typography.label-md}"
  badge:
    backgroundColor: "{colors.secondary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.sm}"
    padding: 4px 8px
  badge-error:
    backgroundColor: "{colors.error}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.sm}"
    padding: 4px 8px
  badge-success:
    backgroundColor: "{colors.success}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.sm}"
    padding: 4px 8px
  divider:
    backgroundColor: "{colors.outline}"
    height: 1px
  swatch-background:
    backgroundColor: "{colors.background}"
    rounded: "{rounded.sm}"
    size: 32px
motion:
  duration-short: 150ms
  duration-medium: 300ms
  easing-standard: cubic-bezier(0.4, 0, 0.2, 1)
elevation:
  sm: 0 1px 2px rgba(0,0,0,0.05)
  md: 0 4px 6px rgba(0,0,0,0.1)
  lg: 0 10px 15px rgba(0,0,0,0.15)
---

## Overview

AT&T's visual identity is clean, corporate, and highly accessible, designed to appeal to a broad consumer and business audience. It leverages a crisp white background with vibrant blue accents to establish trust, clarity, and contemporary connectivity. The overall aesthetic is professional, minimal, and enterprise-focused, prioritizing readability and clear paths to action.

## Colors

The color strategy relies on a high-contrast palette dominated by deep blues and clean white surfaces. This combination ensures maximum readability and reinforces brand authority while utilizing vibrant secondary blues to draw attention to key promotional highlights and interactive elements.

* **Primary (`{colors.primary}` - #00388F)**: Deep Cobalt Blue used for primary buttons, high-contrast actions, and brand authority.
* **Secondary (`{colors.secondary}` - #009FDB)**: AT&T Globe Blue, used for brand accents, highlights, and secondary elements.
* **Accent (`{colors.accent}` - #0072B2)**: Medium blue used for inline links and active states.
* **Background (`{colors.background}` - #FFFFFF)**: Pure white background used for the main canvas to ensure high contrast.
* **Surface (`{colors.surface}` - #FFFFFF)**: Main surface color for cards and input fields.
* **Surface-dim (`{colors.surface-dim}` - #F2FAFD)**: Very light blue tint used for secondary button backgrounds and subtle container highlights.
* **Surface-container (inferred) (`{colors.surface-container}` - #F7F9FA)**: Light gray/blue container background for grouping content sections.
* **On-primary (`{colors.on-primary}` - #FFFFFF)**: White text used on primary blue backgrounds for maximum readability.
* **On-surface (`{colors.on-surface}` - #1D2329)**: Dark charcoal text for high readability on light surfaces.
* **Outline (`{colors.outline}` - #686E74)**: Medium gray for borders, dividers, and input outlines.
* **Error (inferred) (`{colors.error}` - #D32F2F)**: Standard red used for error states and alerts.
* **Success (inferred) (`{colors.success}` - #2E7D32)**: Standard green used for success states and positive confirmations.

## Typography

The typography suite is built around AT&T Aleck Sans, a highly legible sans-serif typeface designed to maintain clarity across digital screens. The type hierarchy scales from large, impactful display styles for promotions down to compact, highly readable body and label styles for technical specifications and legal disclaimers.

* **display-lg (inferred)**: Large display headings used for major promotional hero statements.
* **display-md (inferred)**: Medium display headings for secondary hero banners.
* **headline-lg**: Standard section headings for primary offers.
* **headline-md (inferred)**: Mid-sized headings for content cards and secondary promotions.
* **headline-sm (inferred)**: Small headings for minor content blocks and features.
* **body-md**: Standard body copy size for descriptions and legal disclaimers.
* **body-sm (inferred)**: Smaller body copy for secondary disclaimers and footnotes.
* **label-md (inferred)**: Interactive labels, button text, and navigation items.
* **label-sm (inferred)**: Small labels, badges, and overlines.

## Layout

The layout relies on a structured grid with generous container padding and clear section margins to separate promotional offers. Content is organized into distinct, scannable blocks with high-contrast headings and prominent call-to-actions. 

* **Grid & Spacing**: The spacing scale utilizes base units like `{spacing.sm}` (8px), `{spacing.md}` (16px), and `{spacing.lg}` (24px) to maintain a clean visual hierarchy.
* **Section Order**: The standard top-to-bottom page flow follows the sequence: `nav` → `hero` → `features` → `use-cases` → `footer`.
* **Hero Pattern**: Features a centered headline and subhead with a single primary CTA, accompanied by an asymmetric product screenshot offset to the right.
* **Responsive Behavior**: Layouts are mobile-first; the navigation collapses to a hamburger drawer below 768px, and multi-column grids stack vertically.

## Elevation & Depth

Subtle single-layer shadows are used sparingly across three levels to distinguish interactive elements from the flat canvas. The elevation values are observed directly from the design system's shadow tokens to maintain a flat, clean aesthetic.

* `elevation.sm` - Used for subtle card lift and small interactive elements.
* `elevation.md` - Applied to standard cards and dropdown menus to create soft depth.
* `elevation.lg` - Reserved for prominent modals, overlays, or drawer menus.

## Shapes

The brand utilizes a mix of sharp and highly rounded shapes to balance accessibility with a professional enterprise aesthetic. 

Interactive elements such as primary and secondary buttons employ a fully rounded pill shape (`{rounded.full}`) to invite interaction and feel approachable. Content containers, input fields, and cards employ a softer, clean corner radius (`{rounded.md}`) to maintain a structured appearance. Smaller elements like badges and color swatches use `{rounded.sm}` for subtle softening without losing their crisp edge.

## Components

> **Note:** This spec was generated from a website scrape and contains visual approximations.
> For production use, add a deep reference to each component pointing to its authoritative
> source (Storybook story, metadata file, or component spec):
> `→ Deep reference: src/components/Button/metadata.ts`

### button-primary
The primary call-to-action button. It features a solid `{colors.primary}` background, `{colors.on-primary}` text styled with `{typography.label-md}`, and a fully rounded `{rounded.full}` shape. Use this for the main action in a section, such as "Shop now" or "Check availability".

### button-secondary
A secondary action button designed to sit alongside the primary button. It uses a `{colors.surface-dim}` background with `{colors.primary}` text and a `{rounded.full}` shape. Use this for secondary paths like "Learn more" or "View details".

### card
A standard content container used to group promotional offers or product details. It features a `{colors.surface}` background, a `{rounded.md}` corner radius, and a subtle border defined by `{colors.outline}`. Use this to present distinct product options in a grid layout.

### card-elevated
An alternative content container that uses depth instead of a border. It features a `{colors.surface-container}` background, a `{rounded.md}` corner radius, and is typically paired with `{elevation.sm}` or `{elevation.md}`. Use this to highlight featured promotions or premium offers.

### input-field
The standard text input component. It features a `{colors.surface}` background, `{colors.on-surface}` text styled with `{typography.body-md}`, a `{rounded.md}` corner radius, and a `{colors.outline}` border. On focus, the border color transitions to `{colors.primary}`. Use this for search inputs, zip code checks, or form fields.

### link
An inline interactive text element. It uses `{colors.accent}` text styled with `{typography.label-md}`. On hover, the text color transitions to `{colors.primary}`. Use this for inline text links and navigation items.

### badge
A small status or promotional label. It features a `{colors.secondary}` background with `{colors.on-primary}` text styled with `{typography.label-sm}` and a `{rounded.sm}` corner radius. Use this to highlight new products, limited-time offers, or specific plan features.

### divider
A thin structural line used to separate content blocks. It has a height of 1px and uses the `{colors.outline}` background. Use this to break up long vertical flows of text or distinct sections.

### swatch-background
A small color preview element. It features a `{colors.background}` background, a `{rounded.sm}` corner radius, and a fixed size of 32px. Use this to display available device color options on product cards.

## Do's and Don'ts

| Do | Don't |
| --- | --- |
| Use `{colors.primary}` for primary call-to-action buttons like `{components.button-primary}`. | Never use `{colors.secondary}` for primary action buttons as it lacks sufficient contrast against white backgrounds. |
| Apply `{colors.surface-dim}` as a background for secondary buttons and subtle container highlights. | Avoid applying `{rounded.full}` to content cards; use `{rounded.md}` instead. |
| Ensure all body copy uses `{typography.body-md}` with `{colors.on-surface}` for optimal readability. | Do not use `{typography.display-lg}` for standard body paragraphs. |
| Use `{rounded.full}` exclusively for interactive pill buttons like `{components.button-primary}` and `{components.button-secondary}`. | Never pair `{colors.on-primary}` text with a `{colors.surface}` background. |
| Separate distinct content sections using a `{components.divider}` colored with `{colors.outline}`. | Avoid using heavy shadows; stick to `{elevation.sm}` or `{elevation.md}` for subtle depth. |
| Apply `{colors.accent}` for inline text links to maintain consistent interactive signifiers. | Do not style `{components.input-field}` with a border radius larger than `{rounded.md}`. |
| Style error states and validation badges using `{colors.error}` and `{typography.label-sm}`. | Do not use `{colors.success}` or `{colors.error}` for standard non-semantic labels. |
| Use `{colors.surface-container}` to group related promotional content sections. | Do not mix different corner radiuses like `{rounded.xl}` on standard `{components.card}` elements. |

## Content Style

* **CTA Style**: Call-to-action buttons must use imperative verbs, sentence case, and no exclamation points. They should be concise, typically limited to 2-3 words (e.g., "Shop now", "Learn more", "Check availability").
* **Heading Tone**: Headlines must focus on concrete benefit statements, highlighting direct savings, device offers, and value propositions (e.g., "Get the new iPhone 18 Pro for $0") without relying on excessive marketing superlatives or hype.
* **Copy Density**: Copy should be structured into short, highly scannable paragraphs of 1-3 sentences. Use bulleted lists and inline product links frequently to break up text and guide the user through complex offers and legal disclaimers.

## Imagery & Icons

The imagery style is strictly photographic, featuring high-quality product photography of the latest smartphones, smartwatches, and devices. Images must be cleanly cropped against neutral or subtly gradient backgrounds to emphasize the hardware. Icons and supporting graphics should remain minimal and clean, ensuring they do not compete with product photography or primary call-to-actions. Defer to the brand's existing asset library for official logo lockups and corporate iconography.

---

## Companion prompt

## Role
You are an AI assistant generating UI components and layouts for AT&T, a minimal, accessible, enterprise brand with a professional, trust-forward tone. Content, copy, and information architecture remain owned by the product team.

## How to use design.md
1. Reference every visual value by its token name — `{colors.primary}`, `{typography.body-md}`, `{spacing.lg}`, `{rounded.full}` — never by hardcoded hex, pixel, or font values.
2. Build only the components listed under `components:` (`button-primary`, `card`, `input-field`, etc.). Do not invent variants the spec does not define.
3. Follow `shapesNotes` strictly: pill shape (`{rounded.full}`) for all buttons; `{rounded.md}` for cards and inputs. No exceptions.
4. Consult the Do's and Don'ts as authoritative rules. If a user request conflicts — for example, using `{colors.secondary}` on a primary CTA — surface the conflict before proceeding.
5. Apply `layoutNotes` for all structural decisions: structured grid, generous container padding, single-column on mobile scaling to multi-column on desktop, with one breakpoint at 768px if the spec is silent.

## Output contract

**Must:**
- Use token names for every color, type, spacing, and radius decision.
- Render hover, focus, and disabled states for all interactive components when the spec defines them (`button-primary-hover`, `input-field-focus`, `link-hover`).
- Apply `{rounded.full}` to buttons and `{rounded.md}` to cards and inputs consistently.
- Write CTAs in imperative sentence case, 2–3 words, no exclamation marks, per `voiceAndContent`.
- Maintain body contrast using `{colors.on-surface}` on `{colors.surface}` or `{colors.background}`.
- Use `{colors.accent}` for all inline text links.

**Must NOT:**
- Invent colors, fonts, radii, or spacing values outside the spec.
- Apply generic utility defaults when a brand token exists.
- Use `{colors.secondary}` on primary action buttons.
- Apply `{rounded.full}` to cards or `{rounded.md}` to buttons.
- Add emoji, marketing superlatives, or filler copy.
- Rewrite, replace, or restructure existing page copy, headings, navigation items, or routes as a side effect of applying tokens.

## When in doubt
- If a value is not defined in the spec, ask the user before inventing one.
- Prefer composing existing components over introducing new tokens.
- For ambiguous backgrounds, default to `{colors.surface-container}`; for text on those surfaces, use `{colors.on-surface}`.
- For depth, use only subtle elevation; heavy shadows conflict with the brand's minimal aesthetic.
- Tokens noted as inferred approximations are superseded by any authoritative Figma token file or theme config the product team provides.
