resofire/mini-blog

Mini Blog card layout for Flarum – displays discussions as image cards using only the first post image.

v0.5.7 2026-03-11 21:18 UTC

Requires

• flarum/core: ^1.0
• flarum/tags: ^1.0

MIT

• Resofire

• blog
• extension
• cards
• flarum
• mini-blog

README

A lean, image-first discussion card layout for Flarum.

What it does

Replaces the standard discussion list with a responsive card grid:

• Primary cards – large hero cards at the top of the page (configurable count & width)
• List cards – compact thumbnail-left rows below the primary cards
• Hero image is pulled from the first post only (firstPost relationship) – no extra posts or posts.user data is fetched, keeping the API fast
• Falls back to a per-tag default image, then a global default image if no image is found in the post

Requirements

• Flarum ^1.0
• flarum/tags ^1.0

Installation

composer require resofire/mini-blog
php flarum migrate
php flarum cache:clear

Then build the JS assets:

cd extensions/resofire/mini-blog/js
npm install
npm run build

Admin Settings

Setting	Description
Activate on Index Page	Show cards on the all-discussions page
Number of primary cards	How many large cards appear first (0 = all list style)
Desktop / Tablet card width	% width of primary cards
Preview text	Show first-post excerpt below the title
Reply count	Show reply / unread count
Badges	Show sticky / locked badges
Mark read discussions	Dim title & text of already-read discussions

Key differences from walsgit/flarum-discussion-cards

Feature	discussion-cards	Resofire Mini Blog
API includes	firstPost, posts, posts.user	firstPost only
Last-reply avatars	✔	✗ (removed)
Author info on card	Optional	✗ (removed)
Blog extension support	✔	✗ (out of scope)
Repost extension support	✔	✗ (out of scope)

License

MIT