v_story_viewer
3.0.0, released 2 weeks ago by vchatsdk.com
A high-performance Flutter story viewer package inspired by Instagram and WhatsApp stories.
What it does
A Flutter story viewer package that supports images, videos, text, voice, and custom content with synchronized background music and 3D cube transitions. It includes features like auto-progress, gesture controls, caching, and 24-hour expiry.
AI-written summary of version 3.0.0, based on the package's README and metadata. Report an inaccuracy
Use it when
- You need to display Instagram or WhatsApp-style stories in your Flutter application.
- You need support for multiple content types like images, videos, text, voice messages, and custom widgets.
- You require synchronized background audio, 3D cube transitions, and auto-advancing progress bars.
Skip it when
- You only need a basic video player or a generic image carousel without story navigation logic.
- You are looking for a state management or dependency injection library.
Strengths
- Supports multiple built-in story types including images, videos, text, voice, and custom content.
- Includes smooth 3D cube transitions and vertical/horizontal group paging.
- Built-in background music support with clipping, looping, mixing, and sync features.
Weaknesses
- Tied specifically to a story viewing paradigm, making it difficult to adapt for non-story UI patterns.
- Heavy reliance on multiple media and UI dependencies.
Setup
- Kind
- Flutter widgets
- Effort
- Low
- Code generation
- No
- Direct dependencies
- 7
Add the dependency to pubspec.yaml and import the package. Web playback requires user interaction to enable sound per browser guidelines.
VStoryCircleList(
storyGroups: storyGroups,
onUserTap: (group, index) {
Navigator.push(
context,
MaterialPageRoute(
builder: (_) => VStoryViewer(
storyGroups: storyGroups,
initialGroupIndex: index,
onClose: (_, __) => Navigator.pop(context),
onComplete: (_, __) => Navigator.pop(context),
),
),
);
},
)Alternatives
Packages that do the same job and could replace v_story_viewer.
- video_player_android
Android implementation of the video_player plugin
88Compare - video_player_avfoundation
iOS and macOS implementation of the video_player plugin
86Compare - flutter_voximplant
Voximplant Flutter SDK for voice and video calls
83Compare - flutter_tts
A Flutter plugin for text-to-speech support across multiple platforms.
69Compare
Works with
Packages commonly used together with v_story_viewer: ones it builds on, ones built on it, and its own family.
- flutter_cache_managerv_story_viewer depends on itGeneric cache manager for saving web files and cache info on device storage.
- video_playerv_story_viewer depends on itFlutter plugin for displaying inline video on Android, iOS, macOS, and web.
- audioplayersv_story_viewer depends on itA Flutter plugin to play multiple audio files simultaneously
- timeagov_story_viewer depends on itHumanize dates into fuzzy timestamps like "15 minutes ago"
- extended_imagev_story_viewer depends on itExtended image library with caching, placeholders, zoom/pan, slide-out, and crop editor.
- emoji_picker_flutterv_story_viewer depends on itAn emoji picker widget for Flutter with multiple categories, search, and skin tone support.
- v_video_compressorSame familyFlutter plugin for video compression and thumbnail generation using native APIs.
- v_chat_voice_playerSame familyVoice message playback widget with animated waveform, speed controls, and user avatars.