Skip to content
pubscout

story

1.1.0, released 3 years ago by bookm.me

Instagram stories like UI with animations and customizability.

WASM-ready
$ flutter pub add story
Source repository

What it does

Provides a StoryPageView widget that mimics Instagram stories UI, complete with progress indicators, image loading coordination, custom story lengths per page, and animation controllers.

AI-written summary of version 1.1.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to implement Instagram-style stories in your app.
  • You want built-in indicators and gesture handling for timed story views.

Skip it when

  • You need complex video streaming or multi-platform native story wrappers.
  • You want generic carousel or slider components without story behavior.

Strengths

  • Includes StoryImage widget that pauses indicators while images load.
  • Provides animation controllers to pause and resume indicators.
  • Supports gesture item builders for overlays like close buttons.

Weaknesses

  • Gesture widgets cannot be directly placed inside itemBuilder due to underlying default gestures.
  • Limited to custom story implementations via StoryPageView.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
1
Scaffold(
  body: StoryPageView(
    itemBuilder: (context, pageIndex, storyIndex) {
      return Center(
        child: Text("Index of PageView: $pageIndex Index of story: $storyIndex"),
      );
    },
    storyLength: (pageIndex) {
      return 3;
    },
    pageLength: 4,
  ),
)

Alternatives

Packages that do the same job and could replace story.

  • story_time

    Instagram‑style story UI with rich animations and high customizability.

  • nocterm

    Framework for building terminal user interfaces with Flutter‑like components and hot reload.

  • textf

    Drop-in Text and TextEditingController replacements for inline Markdown-like text formatting

  • new_loading_indicator

    Provides a collection of loading animations and indicators for Flutter applications.

Works with

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