Search packages, repositories and app categories

advstory cover
Package detailsv0.2.1

advstory

An advanced, complete story viewer. Has support for images, videos, custom widget contents, gestures, interceptors, listeners, manipulators and much more.

AndroidiOSmacOS
30-day downloads
2.9K
Likes
119
Pub points
130

Install package

flutter pub add advstory

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

advstory is a comprehensive story viewer for Flutter that supports images, videos, custom widgets, and interactive gestures. It offers advanced features like interceptors, listeners, and content manipulators, enabling developers to create rich, dynamic storytelling experiences. Designed for cross-platform use, it works seamlessly on Android, iOS, and macOS. The package provides fine-grained control over story flow and user interactions, making it ideal for apps requiring immersive narrative interfaces.

Use cases

  • Interactive story feeds
  • User-generated content displays
  • Educational multimedia presentations
  • Social media story features
  • In-app tutorials with rich media

Key features

  • Support for images and videos
  • Custom widget integration
  • Gesture recognition
  • Interceptors and listeners
  • Content manipulators
  • Cross-platform compatibility

Suitable for

  • Developers building story-based apps
  • Apps needing rich media storytelling
  • Projects requiring gesture-driven navigation
  • Teams wanting customizable story flows
  • Educational or social platforms

Considerations

  • Requires careful handling of large media assets
  • May need optimization for performance with complex content
  • Dependent on proper asset management
  • Limited documentation beyond basic setup
  • Potential complexity in managing multiple story layers

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

"Buy Me A Coffee" pub package GitHub issues-closed

AdvStory 📸

Quite simple & Quite advanced

🚀 Advanced Story viewer for Flutter. Create and customize slideshow presentations similar to Instagram, TikTok and Snapchat stories. Supports image, video and custom story contents. Full control over stories for developer and smooth experience for users.

Features

➡️ High performance, minimum delays, preload and cache enabled. Works using builders, provides flexibility and lazy loading.

➡️ Story view can be in any shape, size and position or full-screen.

➡️ Predefined story types for images, videos and simple contents. But not limited to these types, allows you to use base class of predefined widgets. This literally makes the options endless.

➡️ Gestures for skip story, skip content, pause, resume and close.

➡️ Interceptors that block events and manipulate the story flow without being noticed by the app user.

➡️ A functional controller for listening interactions and skip stories/contents, pause, play and more...

➡️ Predefined highly customizable story tray. But you are not limited to that, you can create your own non-animated or animated trays, AdvStory handles animation.

➡️ Header and footer areas for predefined stories with customization option specific to a predefined story content.

➡️ Object based, you can create as many story views as you want within the same application.

➡️ Well documented, go to docs:

  • docs

What can I do using AdvStory?

  • Quite simple: when you don't need much customization, a fully functional story view is just 8 lines of code.
AdvStory(
  storyCount: 5,
  storyBuilder: (storyIndex) => Story(
    contentCount: 10,
    contentBuilder: (contentIndex) => const ImageContent(url: ""),
  ),
  trayBuilder: (index) => AdvStoryTray(url: ""),
);
  • Quite advanced: when you need more you can,
    • create stories asynchronously in storyBuilder, send some requests to your server!
    • create different story trays and tray animations for each story, trays can be any widget you want.
    • create different footer & header areas for each story contents.
    • create contents with different skip durations.
    • create your own contents, AdvStory provides ways to you for caching media and handling story logic.
    • disable gestures, jump to a position, hide and show header/footer areas, pause and resume story via controller.
    • block events and call your own callbacks instead default story flow actions via interceptor.
    • create story view using AdvStory.player to define opening animations, custom shape, size...
    • customize tray list, story progress indicator, loading screen.

If you find AdvStory useful, you can hit the like button and give a star to project on Github to motivate me or treat me with coffee to help me take time to develop this package.


🤝🏼 Supporters & Sponsors

Roadmap
Status Goal
🚀 Custom advanced contents
❌ Custom gestures
🚀 Decouple trays & player
❌ Web & Windows & MacOs & Linux support

Some screenshots:

Categories

Dependencies

Dependency list 3 items

Source repository

Projects using this package

No data available yet.