README

A gaming theme for Flarum 2: chamfered surfaces, neon accents, mono typography, hex-clipped avatars, hero with blinking cursor, level/XP sidebar widget, and a stats footer.

Features

Dark + Light mode — admin-configurable default, per-user toggle in the header (☾ / ☀)
Branded hero — replaces the default IndexPage hero with a panel showing an eyebrow line, big mono headline ("Welcome to {forum}"), tagline, and an optional row of tag-shortcut chips
Server-status footer — four chamfered stat cards (Posts · Discussions · Members · Online Now) rendered at the bottom of the index page, cached server-side at 60s
Player Card — sidebar widget for the logged-in user with hex avatar, derived LVL N · {posts} POSTS, and a cyan→magenta XP bar
Rarity Legend — sidebar panel mapping the four tag-color tiers (Legendary / Epic / Rare / Common) so newcomers learn the vocabulary
Post styling — chamfered post cards, mono usernames in cyan, post-number pills, accent-bordered blockquotes, mono code blocks
Composer + Scrubber — restyled to match the theme

The theme is a pure CSS/LESS skin layered on top of stock Flarum — no Mithril components replaced or routes added beyond the small components above. Anything that uses Flarum's CSS variables (--primary-color, --secondary-color, etc.) is remapped, so most extensions skin for free.

Requirements

Flarum 2.x
PHP 8.3+

Installation

composer require ernestdefoe/respawn
php flarum cache:clear

Then enable Respawn in Admin → Extensions.

Configuration

All settings are in Admin → Extensions → Respawn.

Setting	Description	Default
Theme Mode	Default colour mode for new visitors (`Dark` or `Light`). Users can toggle with the moon/sun button in the header.	`Dark`
Hero Tagline	Subtitle shown under the welcome headline. Leave blank to hide.	`Drop in, level up, and join the discussion.`
Hero Eyebrow	Small accent line above the headline.	`▸ Player Connected`
Hero Tag Chips	Comma-separated list of tag slugs to feature as quick-jump chips (e.g. `halo, elden-ring, deals`). Leave blank to hide.	(blank)

The hero headline reads from Flarum's standard Forum Title setting (Admin → Basics).

How the stats are computed

ForumStatistics queries the posts, discussions, users, and users.last_seen_at tables and caches each count for 60 seconds. The "Online Now" tile uses a 5-minute activity window matching Flarum's stock indicator. Any DB error renders the affected tile as — rather than a misleading 0.

Player Card level formula

Currently: level = floor(posts / 100) + 1, progress to next level = posts % 100.

It's a deliberately simple linear ramp. If you want a non-linear curve (exponential, custom thresholds, Bronze/Silver/Gold ranks instead of a number), open an issue.

Customising

The theme exposes its tokens as --r-* CSS variables. Respawn follows Flarum 2's own data-theme attribute on <html>: the dark set lives on :root, [data-theme^="dark"] and the light set on [data-theme^="light"]. An extension or custom CSS can override any of them without touching Respawn itself:

/* Dark mode */
:root,
[data-theme^="dark"] {
  --r-accent:  #50ff8a;    /* lime instead of cyan */
  --r-magenta: #ff6b35;    /* orange instead of magenta */
}

/* Light mode */
[data-theme^="light"] {
  --r-accent:  #1a9e4b;
  --r-magenta: #d9531e;
}

A rule on plain :root alone also lands in light mode (custom CSS loads after Respawn's), so use the two selectors above when the modes need different colours.

Every component reads through these variables.

Support

Support forum: Respawn on ernestdefoe.online
Flarum community: Respawn on discuss.flarum.org
Bug reports: GitHub issues

Discuss

Questions, ideas and release notes: Respawn on discuss.flarum.org.

License

Respawn is released under the MIT License.

ernestdefoe / respawn

Package info

Security

Fund package maintenance!

Statistics