flutter_story_kit library
Lightweight Instagram-style stories for Flutter.
Supports images, native videos, YouTube links, Facebook embeds, media preload, a horizontal story tray, and callback-based call-to-action buttons. The host app owns networking and navigation.
Classes
- FacebookLink
- Helpers for Facebook video, watch, and reel URLs.
- Story
- One story ring: a title, thumbnail, seen state, and one or more media slides.
- StoryAction
- A call-to-action attached to a Story or a single StoryMedia slide.
- StoryCircle
- Instagram-like avatar ring used in a horizontal story tray.
- StoryController
- Programmatic control for a StoryViewer.
- StoryMedia
- A single slide inside a Story (image, video, YouTube, or Facebook).
- StoryPreloader
- Preloads images and native videos so the viewer opens instantly.
- StoryStyle
- Visual tokens for StoryViewer, StoryTray, and StoryCircle.
- StoryTray
- Horizontal list of StoryCircle avatars, similar to Instagram's tray.
- StoryViewer
- Full-screen Instagram-style story player.
- YoutubeLink
- Helpers for YouTube watch, share, shorts, live, and embed URLs.
Enums
- StoryMediaKind
- Kind of media shown on a single story slide.
- YoutubeThumbnailQuality
- YouTube thumbnail size presets.
Extensions
- StoryMediaKindDetect on StoryMediaKind
- Detects StoryMediaKind from an optional type string and a media URL.
- YoutubeThumbnailQualityX on YoutubeThumbnailQuality
- File name used by YoutubeLink.thumbnailUrl.
Functions
-
storiesFromResponse(
Map< String, dynamic> json) → List<Story> -
Parses a list of stories from a typical
{ "stories": [ ... ] }payload. -
storyFromLegacyUrl(
{required String id, required String title, required String url, int duration = 5000, String? thumbnailUrl, bool seen = false, StoryAction? action}) → Story - Convenience used by older single-url stories.