Search by

ernestdefoe / broadsheet

ernestdefoe

Broadsheet — a newspaper front-page theme for Flarum 2. A nameplate, a section nav built from your tags, a lead story with three ruled columns, discussions that read like articles and a Night edition.

Package info

github.com/ernestdefoe/broadsheet

Type:flarum-extension

pkg:composer/ernestdefoe/broadsheet

Fund package maintenance!

Buy Me A Coffee

Statistics

Installs: 19

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.0.5 2026-11-16 19:36 UTC

This package is auto-updated.

Last update: 2026-11-16 20:17:02 UTC


README

Floxum code review

A newspaper front-page theme for Flarum 2, for news and writing communities.

  • A nameplate — your paper's name set large across the top, with a tagline and today's date.
  • A section nav built from your tags — pick the tags, or leave it to your primary tags.
  • A front page — a lead story (the newest, the newest sticky or the most-liked discussion), the week's most discussed in serif numerals, and three stories in ruled columns. Core's discussion list stays below it as "The rest of the paper", with its sorting, sidebar and every extension's list items.
  • Discussions that read like articles — a headline and byline, a drop cap, quotes pulled out between rules, and replies under "Letters in reply".
  • A Night edition — Flarum's dark mode, set in ink and newsprint.

The front page

The Night edition

A discussion, set as an article

Phone Phone, Night edition A discussion on a phone

Typeset in Newsreader and IBM Plex Sans Condensed, served from your own forum (no Google Fonts).

Install

composer require ernestdefoe/broadsheet

Then enable Broadsheet in your admin panel. Settings: nameplate, tagline, the date line, how the lead story is picked, the section tags, the accent color and the fonts.

Works with

Tags, Sticky, Likes, Mentions, fof/upload, Scribe and Wardrobe (members choose their theme). Widgets placed with fof/forum-widgets-core show in all five of its areas around the front page (Homecoming, Latest Replies and Testimonials below).

Widgets around the front page

API

Broadsheet adds one read-only endpoint, GET /api/broadsheet/front. It returns the front page as one computed payload: the lead story, the three columns and the week's most discussed, each with its title, excerpt, section, author and reply count. It is a custom handler rather than a JSON:API resource because there is no model behind it to list, create or update; the stories are picked by rules across many discussions. Every story passes the reader's own visibility (restricted tags, private and hidden discussions, and opening posts the reader may not see are left out), and a forum that guests cannot view returns 403 to a guest. A full page load of the front page receives the same payload in the page, so it never waits on this request.

Licence

MIT. Fonts: SIL Open Font License (see assets/fonts).

☕ Buy me a coffee