{"id":13683854,"url":"https://github.com/ertgrulll/advstory","last_synced_at":"2025-10-23T01:34:33.028Z","repository":{"id":42497059,"uuid":"495846803","full_name":"ertgrulll/advstory","owner":"ertgrulll","description":"An advanced, complete story viewer for Flutter. Has support for images, videos, custom widget contents, gestures, interceptors, listeners, manipulators and much more.","archived":false,"fork":false,"pushed_at":"2023-11-15T12:46:25.000Z","size":23183,"stargazers_count":43,"open_issues_count":11,"forks_count":34,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-23T01:34:20.647Z","etag":null,"topics":["android","dart","flutter","ios","story"],"latest_commit_sha":null,"homepage":"https://advstory.sourcekod.com","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ertgrulll.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-24T13:57:02.000Z","updated_at":"2025-10-16T08:04:56.000Z","dependencies_parsed_at":"2024-01-14T15:25:54.750Z","dependency_job_id":"f6ea4a11-baba-4d88-b4a3-d55d5fa12301","html_url":"https://github.com/ertgrulll/advstory","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/ertgrulll/advstory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertgrulll%2Fadvstory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertgrulll%2Fadvstory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertgrulll%2Fadvstory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertgrulll%2Fadvstory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ertgrulll","download_url":"https://codeload.github.com/ertgrulll/advstory/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ertgrulll%2Fadvstory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280546397,"owners_count":26348721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-22T02:00:06.515Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","dart","flutter","ios","story"],"created_at":"2024-08-02T14:00:19.446Z","updated_at":"2025-10-23T01:34:32.998Z","avatar_url":"https://github.com/ertgrulll.png","language":"Dart","funding_links":["https://www.buymeacoffee.com/ertgrulll"],"categories":["Dart"],"sub_categories":[],"readme":"\u003cimg src=\"https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLZoq1vLHUTwBd2vqtB84%2Fuploads%2FanFNgKBQRGFKJQ7HK2It%2Fanimated_tray_cover.gif?alt=media\u0026token=7e42ec27-fcec-48d5-8d97-6250d60b5b23\"\u003e\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/ertgrulll) [![pub package](https://img.shields.io/pub/v/advstory.svg)](https://pub.dev/packages/advstory) [![GitHub issues-closed](https://img.shields.io/github/issues-closed/ertgrulll/advstory)](https://github.com/ertgrulll/advstory/issues)\n\n## AdvStory 📸\n\n#### _Quite simple \u0026 Quite advanced_\n\n___\n\n🚀 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.\n\n## _Features_\n\n➡️ High performance, minimum delays, preload and cache enabled. Works using builders, provides flexibility and lazy loading.\n\n➡️ Story view can be in any shape, size and position or full-screen.\n\n➡️ 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.\n\n➡️ Gestures for skip story, skip content, pause, resume and close.\n\n➡️ Interceptors that block events and manipulate the story flow without being noticed by the app user.\n\n➡️ A functional controller for listening interactions and skip stories/contents, pause, play and more...\n\n➡️ 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.\n\n➡️ Header and footer areas for predefined stories with customization option specific to a predefined story content.\n\n➡️ Object based, you can create as many story views as you want within the same application.\n\n➡️ Well documented, go to docs:\n\n* [![docs](https://img.shields.io/badge/AdvStory-Documentation-9cflogo=gitbook?color=7395de)](https://advstory.sourcekod.com)\n\n___\n\n## _What can I do using AdvStory?_\n\n- _Quite simple:_ when you don't need much customization, a fully functional story view is just **8 lines of code**.\n\n```dart\nAdvStory(\n  storyCount: 5,\n  storyBuilder: (storyIndex) =\u003e Story(\n    contentCount: 10,\n    contentBuilder: (contentIndex) =\u003e const ImageContent(url: \"\"),\n  ),\n  trayBuilder: (index) =\u003e AdvStoryTray(url: \"\"),\n);\n```\n- _Quite advanced:_ when you need more you can,\n    - create stories asynchronously in `storyBuilder`, send some requests to your server!\n    - create different story trays and tray animations for each story, trays can be any widget you want.\n    - create different footer \u0026 header areas for each story contents.\n    - create contents with different skip durations.\n    - create your own contents, `AdvStory` provides ways to you for caching media and handling story logic.\n    - disable gestures, jump to a position, hide and show header/footer areas, pause and resume story via controller.\n    - block events and call your own callbacks instead default story flow actions via interceptor.\n    - create story view using `AdvStory.player` to define opening animations, custom shape, size...\n    - customize tray list, story progress indicator, loading screen.\n\n\u003e If you find `AdvStory` useful, you can hit the like button and give a star to project on [Github](https://github.com/ertgrulll/advstory) to motivate me or treat me with [coffee](https://www.buymeacoffee.com/ertgrulll) to help me take time to develop this package.\n\n___\n\n### 🤝🏼 _Supporters \u0026 Sponsors_\n\n- [jtkeyva](https://github.com/jtkeyva) ☕️ x 5\n\n___\n\n### Roadmap\n\n| Status | Goal | \n| :---: | :--- | \n| 🚀 | Custom advanced contents\n| ❌ | [Custom gestures](https://github.com/ertgrulll/advstory/issues/4)\n| 🚀 | Decouple trays \u0026 player\n| ❌ | [Web \u0026 Windows \u0026 MacOs \u0026 Linux support](https://github.com/ertgrulll/advstory/issues/6)\n\n___\n\n#### _Some screenshots:_\n\n\u003cp align=\"left\"\u003e\n    \u003cimg src=\"https://github.com/ertgrulll/advstory/blob/master/github_images/story_view_demo.gif?raw=true\" height=\"400\" hspace=\"1%\"/\u003e\n    \u003cimg src=\"https://github.com/ertgrulll/advstory/blob/master/github_images/adv_story_tray_customizations.gif?raw=true\" height=\"400\" hspace=\"1%\"\u003e\n\u003c/p\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fertgrulll%2Fadvstory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fertgrulll%2Fadvstory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fertgrulll%2Fadvstory/lists"}