flatrate / flarum-live-chat

v1.2.0 2026-09-27 08:12 UTC

Requires

• php: ^8.1
• firebase/php-jwt: ^7.0
• flarum/core: ^1.8.19
• flarum/markdown: ^1.0
• guzzlehttp/guzzle: ^7.8

Requires (Dev)

• phpunit/phpunit: ^9.6

Conflicts

• xelson/flarum-ext-chat: *

MIT

• Juan
• Guillem Pascual
• Xelson
• FlatRate.wiki

• chat
• flarum
• push-edx
• live-chat
• Xelson
• flatrate
• neon-chat

Published on Packagist.org on 2026-09-27 18:53 UTC

README

FlatRate.wiki-owned Flarum 1.x live-chat package.

Derived from xelson/flarum-ext-chat (Neon Chat) v1.1.5 under MIT. Upstream attribution for Push-EDX / Xelson is preserved in LICENSE and UPSTREAM.md.

Identity	Value
Composer	flatrate/flarum-live-chat
Extension ID	flatrate-live-chat
Namespace	FlatRate\LiveChat\
Upstream pin	a7489ac183764eef12969135d6b665ac5eb18272 (v1.1.5)
Rollout	general-live-first (General Live member-visible; brands staff-preview)
Release tag	v1.2.0 (authority on main; commit 46cd51243446025c3da0fe1997fdbaa2636669dd)
Requires	flarum/core ^1.8.19, PHP ^8.1
Transport	Centrifugo self-hosted (1.1.0 stable; 1.1.1 source adds PikaPods file-backed secrets + egress probe)

Not an official Neon / Xelson release. Stock Packagist xelson/flarum-ext-chat must not be installed on FlatRate production.

Canonical routes: /live/{roomKey}.

Install

Target a Flarum 1.8.x app with flarum/core ^1.8.19 and PHP ^8.1 (see composer.json).

Install from GitHub (current path for v1.2.0) — Packagist currently lists only 1.0.0 / 1.1.0; add the VCS repository and require the tagged line (not dev-main#<sha>):

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/mrkcntrmn/flatrate-flarum-live-chat"
        }
    ],
    "require": {
        "flatrate/flarum-live-chat": "^1.2"
    }
}

Exact tag pin: "flatrate/flarum-live-chat": "1.2.0".

After 1.2.0 is published to Packagist:

composer require flatrate/flarum-live-chat:^1.2

Deployment models

1. Generic env / secret-mount — set Centrifugo URL/secret env vars (or *_FILE mounts) as usual.
2. FlatRate / PikaPods canonical /data secrets — PikaPods does not inject arbitrary custom env. With no realtime env vars, the package defaults websocket/publish URLs to the pinned FlatRate hosts and loads secrets from:

/data/flatrate-live-chat/secrets/centrifugo-edge-key
/data/flatrate-live-chat/secrets/centrifugo-api-key
/data/flatrate-live-chat/secrets/centrifugo-jwt-private-key.pem

Operator-provisioned only. See REALTIME.md.

Admin-only egress probe (after install/enable): GET /api/flatrate-live-chat/realtime/egress-probe.

Release boundary: annotated tag v1.2.0 is the current version authority on main. Immutable Packagist stables 1.0.0 / 1.1.0 remain; 1.1.1 tags/Packagist/production deploy are not claimed by earlier source work.

See UPSTREAM.md, SECURITY.md, ARCHITECTURE.md, ROLLOUT.md, and REALTIME.md.

composer validate --strict
composer update --no-interaction
vendor/bin/phpunit
cd js && npm ci && npm test && npm run build
php flarum flatrate:live-chat:doctor   # inside a Flarum app with the extension enabled