Data DisplayContent SurfacesReadable UI

Present information with structure and clarity.

Data display primitives shape hierarchy, communicate state, and improve scan speed. Combine them to build dashboards, profiles, tables, and rich content regions that remain consistent across breakpoints.

Avatar
identity
Icon
signals
Table
structured data
Scroll
large content
Identity Tokens

Avatar

Avatars represent users with image, initials, or fallback icon. They support shape, size, status badges, and group stacking.

Sizes + Shapes

JDJDJDJDJD
JDJDJD
JJJJJJJ

Image + Group

ABCO
ABCD+

Notification Marks

Badge

Badges overlay counts and status dots on avatars and icons for quick attention cues.

Counts + Dot

J55J1212DM99+99+

Placement + Visibility

T11T22B33B44
00

Compact Labels

Chip

Chips are concise status and metadata tokens for tags, filters, and category markers.

Variants + Size

SolidSoftOutlineSurface
XSSMMDLG

Color + Icon

PrimarySecondaryAccentSuccessError
FeaturedVerifiedIssue

Symbol Language

Icon

Icons reinforce intent and improve scanning. Use size, color, and context to keep them clear.

Gallery

menu
search
mail
phone
calendar
clock
star
heart
check
alert-circle
info
share
download
filter
user
users
tag
package
refresh
chevron-right

Sizing + Color


Visual Media

Image

Image wraps `next/image` with ergonomic defaults for sizing, fit modes, radius, and decorative use.

Fixed Dimensions

LandscapeSquareRound

Fill + Object Fit

Fill preview
Contain
Cover
Fill

Separation Rhythm

Divider

Dividers create visual boundaries between related content blocks with horizontal and vertical modes.

Horizontal




Vertical + Semantics

Home


About


Contact

decorative true
decorative false

Completion Signals

Progress

Progress communicates task status with linear and circular variants, determinate and loading states.

Linear

Circular + Color


Loading Placeholders

Skeleton

Skeleton placeholders preserve structure during loading and reduce content shift.

Shapes

Animation + Composition


Context Hints

Tooltip

Tooltips provide supplemental hints on hover/focus without changing primary layout flow.

Basic + Position

Rich Variant


Interactive Overlay

Popover

Popover opens contextual panels for actions, forms, and richer inline interaction flows.

Content Panel

Positions


Rich Preview

HoverCard

HoverCard surfaces richer contextual previews for people, links, and content snippets.

Flat API

@alice_chen

v0.1.4

Compound API

Hover for preview


Typography System

Text

Text provides semantic typography variants, weight controls, alignment, truncation, and color token mapping.

Scale

Heading 3

Heading 4

Heading 5
Subtitle 1
Subtitle 2

Body 1 for longer readable content blocks.

Body 2 for supporting content and metadata.

ButtonMenuCaptionOverline

Color + Clamp

Primary

Secondary

Accent

Success

Warning

Error

This is a long line that truncates with ellipsis when it exceeds available width.

Multi-line clamping helps keep cards and list previews aligned. It limits text overflow while preserving a clean and consistent rhythm across dense layouts.


Structured Rows

Table

Tables present structured datasets with semantic cells, density modes, striping, and sticky headers.

Basic + Striped

NameRoleStatus
Alice ChenEngineerActive
Bob SmithDesignerActive
Carol DavisPMOn Leave
Dan LeeEngineerActive
QuarterUnitsRevenue
Q11,200$48,000
Q21,450$58,000
Q31,380$55,200
Q41,610$64,400

Bordered + Sticky

FeatureFreePro
Pages5Unlimited
Storage1 GB100 GB
#ProductCategory
1Item 1Core
2Item 2Extension
3Item 3Core
4Item 4Extension
5Item 5Core
6Item 6Extension
7Item 7Core
8Item 8Extension
9Item 9Core
10Item 10Extension

Collection Rows

List

Lists provide compact, scan-friendly row layouts for tasks, settings, and navigational sets.

Basic + Divided

  • Inbox
  • Drafts
  • Sent
  • Inbox
    3 unread messages
  • Drafts
    2 drafts saved

Actions + Ordered

  • Notifications
    Push and email alerts
    On
  • Locked task
    Complete previous step
  1. Create account
    Sign up with email
  2. Choose template
    Pick a starter
  3. Publish
    Go live

Overflow Control

ScrollArea

ScrollArea provides themed scroll containers for tall and wide content with configurable orientation.

Vertical + Horizontal

Item 1 — Scroll to see more

Item 2 — Scroll to see more

Item 3 — Scroll to see more

Item 4 — Scroll to see more

Item 5 — Scroll to see more

Item 6 — Scroll to see more

Item 7 — Scroll to see more

Item 8 — Scroll to see more

Item 9 — Scroll to see more

Item 10 — Scroll to see more

Item 11 — Scroll to see more

Item 12 — Scroll to see more

Item 13 — Scroll to see more

Item 14 — Scroll to see more

Item 15 — Scroll to see more

Card 1

Card 2

Card 3

Card 4

Card 5

Card 6

Card 7

Card 8

Card 9

Card 10

Both Directions

IDNameDepartmentLocationStatus
1Alice ChenEngineeringNew YorkActive
2Bob SmithDesignSan FranciscoActive
3Carol DavisMarketingLondonOn Leave
4Dan LeeEngineeringTokyoActive
5Eve TorresSalesSydneyActive
6Frank WuDesignBerlinInactive