Skip to main content Skip to docs navigation

Full-screen, immersive components that present sequential narrative content, typically featuring images or videos with interactive navigation.

This documentation is a work in progress and may contain incomplete or outdated information. If you have any feedback or suggestions, please open an issue on GitHub.

Variants

Different configurations and states available for story components to accommodate various content presentation requirements, interaction patterns, and visual engagement needs. These variants provide flexibility in appearance, content structure, and state management while maintaining design consistency across the system.

Story Button

Interactive elements that provide access to story content through compact, circular presentation formats. These components serve as the primary entry point for story experiences, adapting their appearance and behavior based on content type, viewing state, and visual presentation requirements to provide clear access patterns and maintain consistent user experience across all story scenarios.

Type Variants

Content structure configurations that determine the visual presentation format and content display approach of story button components. These variants control the content organization and interaction emphasis to match different story identification requirements.

Story variant example image Story variant example image

Avatar

Standard story button presentation with user avatar imagery for personal story identification. Use for user-generated story content, personal story feeds, social story interactions, or when providing clear user identification and personal content association.

Story variant example image Story variant example image

Icon

Simplified story button presentation with icon-based content for functional story access. Use for branded story content, feature stories, promotional story access, or when providing clear functional identification without personal user association.

State Variants

Visual presentation modes that communicate the story's viewing status and user interaction history. These variants determine the visual emphasis and user awareness approach for different story engagement states.

Story variant example image Story variant example image

Unread

Prominent story button styling with enhanced visual treatment to indicate new content that hasn't been viewed. Use for recently published stories, first-time story access, or when drawing user attention to fresh content that requires viewing priority.

Story variant example image Story variant example image

Read

Subdued story button styling with reduced visual emphasis to indicate previously viewed content. Use for stories that have been accessed by the user, completed story experiences, or when maintaining content availability while reducing visual prominence.

Story Card

Container elements that organize and present story content within structured visual boundaries through expanded presentation formats. These components serve as the primary content display interface for story experiences, adapting their appearance and content organization based on viewing state, content density, and contextual presentation to provide clear story access and maintain consistent user experience across all story scenarios.

State Variants

Visual presentation modes that communicate the story's viewing status and user interaction history within card-based layouts. These variants determine the visual emphasis and user awareness approach for different story engagement states in expanded format presentations.

Story variant example image Story variant example image

Unread

Prominent story card styling with enhanced visual treatment to indicate new content that hasn't been viewed. Use for recently published story content, first-time story access in expanded formats, or when drawing user attention to fresh story experiences that require viewing priority.

Story variant example image Story variant example image

Read

Subdued story card styling with reduced visual emphasis to indicate previously viewed content. Use for stories that have been accessed by the user, completed story experiences in card format, or when maintaining story availability while reducing visual prominence in expanded layouts.

Story Carousel

Sequential presentation elements that organize and display collections of story content through horizontal navigation patterns. These components serve as the primary story collection interface, adapting their appearance and content organization based on story type, presentation format, and contextual requirements to provide clear story browsing and maintain consistent user experience across all story carousel scenarios.

Type Variants

Content structure configurations that determine the story presentation format and layout approach within carousel contexts. These variants control the story organization and interaction emphasis to match different story collection requirements.

Story variant example image Story variant example image

Button

Story carousel presentation using circular story button components for efficient horizontal browsing. Use for story collections requiring space-efficient presentation, mobile story feeds, or when providing streamlined story access through compact circular interaction elements.

Story variant example image Story variant example image

Card

Story carousel presentation using rectangular story card components with icon and label for enhanced content identification. Use for story collections requiring clearer content labeling, desktop story experiences, or when providing comprehensive story identification through framed card elements.