Skip to content
pubscout

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.

$ flutter pub add v_story_viewer
Source repository

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.

Works with

Packages commonly used together with v_story_viewer: ones it builds on, ones built on it, and its own family.