Search packages, repositories and app categories

GitHub repositorysteevjames/stories-for-flutter

stories-for-flutter

Stories like Instagram or statuses like WhatsApp with the highly customizable stories for Flutter package.

stories-for-flutter project cover
Stars
41
Forks
15
Last push (UTC)
Aug 10, 2025
Project status
Active

Original README

English project snapshot. Visit GitHub for the latest content.

Stories for Flutter

Visit on pub.dev.

A customizable flutter package that allows you to use Instagram like stories, or WhastApp like statuses in your Flutter app easily, made without using external dependencies.

Screenshots

Using the package

Step 1: Import the package.

import  'package:stories_for_flutter/stories_for_flutter.dart';

Step 2: Call the stories plugin and use it. Can give Scaffold to each page, making it highly customizable.

  Stories(
    storyItemList: [
      // First group of stories
      StoryItem(
          name: "First Story", // Name of first story
          thumbnail: // Add icon to first story
          stories: [
            Page1(),
            Page2(),
          ]),
      // Second story group
      StoryItem(
          name: "Second Story", 
          thumbnail: // Add icon to first story
        stories: [
          Page1(),
          Page2(),
          Page3()
        ],
      ),
    ],
  );

Example:

Stories(
    displayProgress: true,
    storyItemList: [
      // First group of stories
      StoryItem(
          name: "First Story",
          thumbnail: NetworkImage(
            "https://assets.materialup.com/uploads/82eae29e-33b7-4ff7-be10-df432402b2b6/preview",
          ),
          stories: [
            // First story
            Scaffold(
              body: Container(
                decoration: BoxDecoration(
                  image: DecorationImage(
                    fit: BoxFit.cover,
                    image: NetworkImage(
                      "https://wallpaperaccess.com/full/16568.png",
                    ),
                  ),
                ),
              ),
            ),
            // Second story in first group
            Scaffold(
              body: Center(
                child: Text(
                  "Second story in first group !",
                  style: TextStyle(
                    color: Color(0xff777777),
                    fontSize: 25,
                  ),
                ),
              ),
            ),
          ]),
      // Second story group
      StoryItem(
        name: "2nd",
        thumbnail: NetworkImage(
          "https://www.shareicon.net/data/512x512/2017/03/29/881758_cup_512x512.png",
        ),
        stories: [
          Scaffold(
            body: Center(
              child: Text(
                "That's it, Folks !",
                style: TextStyle(
                  color: Color(0xff777777),
                  fontSize: 25,
                ),
              ),
            ),
          ),
        ],
      ),
    ],
  );
Steev James GitHub avatar
GitHub author

Steev James ↗

Engineer, Backend, AI

LanguagesC++DartCMakeSwiftCRubyKotlinHTMLObjective-C

Packages published by this repository

Dependencies used

Dependency list 6 items

  • flutter{"sdk":"flutter"}
  • flutter_web_plugins{"sdk":"flutter"}
  • web^1.1.1
  • plugin_platform_interface^2.0.2
  • flutter_testDevelopment{"sdk":"flutter"}
  • flutter_lintsDevelopment^5.0.0

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗