PHPackages                             wyatts97/user-stories - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. wyatts97/user-stories

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

wyatts97/user-stories
=====================

User Stories for Flarum

v1.0.3(3w ago)02↓100%MITTypeScript

Since May 16Pushed 3w agoCompare

[ Source](https://github.com/wyatts97/user-stories)[ Packagist](https://packagist.org/packages/wyatts97/user-stories)[ RSS](/packages/wyatts97-user-stories/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (5)Used By (0)

Profile Stories — Instagram-Style Fork
======================================

[](#profile-stories--instagram-style-fork)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)

A modern, Instagram-style stories extension for [Flarum](https://flarum.org). This is a fork of [justoverclock/profile-stories](https://github.com/justoverclockl/profile-stories) rebuilt for **Flarum 2.x** with a completely redesigned user experience.

What's New
----------

[](#whats-new)

This fork transforms the original simple profile stories into a polished, Instagram-like stories system:

- **24-hour expiring stories** — Stories automatically expire after 24 hours and are hidden from the feed
- **Follow-based stories bar** — Logged-in users see a horizontal scrollable bar of circle avatars from users they follow, displayed on the home/index page
- **Instagram-style gradient rings** — Unseen stories get a colorful conic-gradient ring around the avatar (just like Instagram)
- **Full-screen story viewer** — Tap left/right to navigate, segmented progress bars at the top, auto-advance timer, caption overlay
- **Polished create modal** — Single-step story composer with live image preview, caption input, and optional link CTA
- **Removed global stories page** — Stories are now follow-based instead of a global listing
- **Flarum 2.x compatible** — Built on the new `ApiResource` architecture

Requirements
------------

[](#requirements)

- **Flarum `^2.0`**
- **[ianm/follow-users](https://github.com/imorland/follow-users)** *(optional)* — Enables the follow-based stories bar. Without it, the stories bar will be empty but the extension will still function for profile stories. > Note: `ianm/follow-users` currently requires Flarum `^1.8.3`. A Flarum 2.x compatible version is needed for full follow-based functionality.

Installation
------------

[](#installation)

Install with composer:

```
composer require wyatts97/user-stories:"*"
```

Updating
--------

[](#updating)

```
composer update wyatts97/user-stories:"*"
php flarum migrate
php flarum cache:clear
```

Features
--------

[](#features)

- Create stories with images, captions, and optional link CTAs
- Stories appear in a horizontal bar on the **index page** for logged-in users (when `ianm/follow-users` is installed)
- Only shows stories from **followed users** (via `ianm/follow-users`)
- Stories **expire after 24 hours** and are automatically filtered out
- Profile stories page (`/u/:username/stories`) is still available
- Notifications when someone creates a new story
- Permission-based story creation, editing, and deletion

Credits
-------

[](#credits)

- Original extension by [Marco Colia (justoverclock)](https://github.com/justoverclockl/profile-stories)
- Fork rebuilt for Flarum 2.x with Instagram-style UX

Links
-----

[](#links)

- [Original Repository](https://github.com/justoverclockl/profile-stories)

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance95

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

23d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/689be2bdef78b7a62c76d6e5833a797dd369e158b2a9482178ce645421c0c857?d=identicon)[wyatts97](/maintainers/wyatts97)

---

Top Contributors

[![wyatts97](https://avatars.githubusercontent.com/u/182544595?v=4)](https://github.com/wyatts97 "wyatts97 (9 commits)")

---

Tags

storiesUser stories

### Embed Badge

![Health badge](/badges/wyatts97-user-stories/health.svg)

```
[![Health](https://phpackages.com/badges/wyatts97-user-stories/health.svg)](https://phpackages.com/packages/wyatts97-user-stories)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12127.5k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

61112.4k10](/packages/fof-byobu)[flarum/tags

Organize discussions into a hierarchy of tags and categories.

38744.9k133](/packages/flarum-tags)[fof/gamification

Upvotes and downvotes for your Flarum community

4162.0k6](/packages/fof-gamification)[fof/polls

 A Flarum extension that adds polls to your discussions

25130.2k9](/packages/fof-polls)[fof/user-bio

Add a user bio to user profiles

21102.0k9](/packages/fof-user-bio)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)