Respawn

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

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 CSS variables on `:root` (and `[data-respawn="light"]`), so an extension or custom CSS can override any of them without touching Respawn itself:

```:root {
  --r-accent:  #50ff8a;    /* lime instead of cyan */
  --r-magenta: #ff6b35;    /* orange instead of magenta */
}```

Every component reads through these variables.

---

## Support

Questions, bug reports, and feature requests:

* **Support forum:** https://ernestdefoe.online
* **Issues:** https://github.com/ernestdefoe/respawn/issues

---

## License

Respawn is released under the [MIT License](https://github.com/ernestdefoe/respawn/blob/main/LICENSE).

Copyright © ernestdefoe.

respawn 2.0.0

No release notes provided.

View release on GitHub

Screenshots:

[upl-image-preview uuid=9b2211a3-da36-4b08-b725-a326dee31bc6 url=https://ernestdefoe.online/assets/files/2026-05-20/1779281973-465673-01-index-dark.png alt=01-index-dark.png thumbnail_url=https://ernestdefoe.online/assets/files/2026-05-20/1779281973-465673-01-index-dark.png]

[upl-image-preview uuid=d25bf094-8a89-4353-a870-ef47036e9b94 url=https://ernestdefoe.online/assets/files/2026-05-20/1779281974-748778-02-index-light.png alt=02-index-light.png thumbnail_url=https://ernestdefoe.online/assets/files/2026-05-20/1779281974-748778-02-index-light.png]

[upl-image-preview uuid=da262908-37a6-4a96-a4e3-fa9c319989f2 url=https://ernestdefoe.online/assets/files/2026-05-20/1779281975-532309-03-index-dark-above-the-fold.png alt=03-index-dark-above-the-fold.png thumbnail_url=https://ernestdefoe.online/assets/files/2026-05-20/1779281975-532309-03-index-dark-above-the-fold.png]

[upl-image-preview uuid=3875b487-0b27-4f74-8494-e957e299a1fe url=https://ernestdefoe.online/assets/files/2026-05-20/1779281976-453153-04-discussion-dark.png alt=04-discussion-dark.png thumbnail_url=https://ernestdefoe.online/assets/files/2026-05-20/1779281976-453153-04-discussion-dark.png]

[upl-image-preview uuid=4bb1238c-826c-4db4-9588-f7b4ab65b1f5 url=https://ernestdefoe.online/assets/files/2026-05-20/1779281977-354752-05-discussion-light.png alt=05-discussion-light.png thumbnail_url=https://ernestdefoe.online/assets/files/2026-05-20/1779281977-354752-05-discussion-light.png]

respawn 2.0.0

Initial release.

View release on GitHub

respawn 3.0.0

What's Changed

• Build changelog from commits when release body is a placeholder
• Replace release-drafter with commit-based draft-release workflow
• Add workflow_dispatch trigger to publish-to-flarum.yml
• Convert to TypeScript (audit fix)
• docs: add Floxum marketplace badges to README

Full Changelog: https://github.com/ernestdefoe/respawn/compare/2.0.0...3.0.0

View release on GitHub

respawn 3.0.1

Floxum audit hardening (→ ≥95). Full i18n wiring (zero hardcoded English), removed @ts-nocheck and properly typed the forum entry, and dropped dead code (the t stub + window.respawnToggleMode).

View release on GitHub

respawn 3.0.2

Fixes the discussion-row dropdown menu being hidden behind lower list items (z-index stacking). Reported via the support forum; reproduced in Safari + Firefox.

View release on GitHub

respawn 3.0.3

What's Changed

• Translate the player card and rarity tiers legend
• fix(tags): drive TagLabel outline + text from --tag-bg so labels stay readable on dark

Full Changelog: https://github.com/ernestdefoe/respawn/compare/3.0.2...3.0.3

View release on GitHub