Package selection guidance compiled from public package information, community data, and project usage.
Story_time is a Flutter package that provides an Instagram-style stories interface with smooth animations and enhanced customizability compared to its original counterpart. It enables developers to create interactive, full-screen story experiences with swipe navigation, timers, and rich media support across multiple platforms. The package supports Android, iOS, Web, macOS, Windows, and Linux, making it ideal for cross-platform applications requiring engaging story-like content displays. With extensive customization options, it allows fine-tuning of appearance and behavior to match diverse design needs.
Use cases
Interactive story feeds
Social media app features
User onboarding tutorials
Content highlight reels
Engaging marketing campaigns
Key features
Rich animations
Swipe navigation
Cross-platform support
Highly customizable UI
Timer-based story progression
Media-rich story cards
Suitable for
Mobile and web apps
Social networking features
Onboarding experiences
Marketing and promotions
Creative content platforms
Considerations
Requires careful handling of state management
May impact performance with heavy media
Custom styling requires familiarity with Flutter widgets
Limited documentation beyond basic setup
Not optimized for very long story sequences
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
story_time
A fork of story. Instagram stories like UI with rich animations and even more customizability than the original package.
Usage
StoryPageView needs at least three arguments: itemBuilder, pageLength, and storyLength.
/// Minimum example to explain the usage.returnScaffold(
body: StoryPageView(
itemBuilder: (context, pageIndex, storyIndex) {
returnCenter(
child: Text("Index of PageView: $pageIndex Index of story on each page: $storyIndex"),
);
},
storyLength: (pageIndex) {
return3;
},
pageLength: 4,
);
itemBuilder is necessary to build the content of story. It is called with index of pageView and index of the story on the page.
storyLength decides the length of story for each page. The example above always returns 3, but it should depend on the argument pageIndex
pageLength is just the length of StoryPageView
The example above just shows 12 stories by 4 pages, which is not practical.
This one is the proper usage, extracted from example.
gestureItemBuilder is the builder for the widgets which needs gesture actions.
In this case, IconButton to close the page is in the callback.
You CANNOT place the gesture widgets in itemBuilder because it is covered and disabled by default story gestures.
onPageLimitReached is called when the very last story is finished.
It is recommended to use data model with two layers. In this case, UserModel which has the list of StoryModel
/// Example Data ModelclassUserModel{
UserModel(this.stories, this.userName, this.imageUrl);
finalList<StoryModel> stories;
finalString userName;
finalString imageUrl;
}
classStoryModel{
StoryModel(this.imageUrl);
finalString imageUrl;
}
Controlling animations
My point of forking the original package was to add the ability to
control the duration of a specific index of a story. Look at the example to see how to use it if you are interested.
Callbacks for pausing and unpausing stories
The package also supports adding callbacks for pausing and unpausing a story to the StoryPageView widget. See the example project for more
details.
Callbacks for moving to a different page
The package also supports adding callbacks for going a page backwards and for going a page forwards to the StoryPageView widget. See the example project for more details.
Callbacks for moving to a different story
The package also supports adding a callback for whenever the story index changes to the StoryPageView widget. See the example project for more details.
Tips
This package is still under development. If you have any requests or questions, please ask on github