PHPackages                             mskocik/tracy-reloader - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. mskocik/tracy-reloader

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

mskocik/tracy-reloader
======================

Automatic page refresh - watching changes with SSE or connect your LiveReload server

v2.0.0(4y ago)1681MITJavaScript

Since Mar 22Pushed 4y ago1 watchersCompare

[ Source](https://github.com/mskocik/tracy-reloader)[ Packagist](https://packagist.org/packages/mskocik/tracy-reloader)[ Docs](https://github.com/mskocik/tracy-reloader)[ RSS](/packages/mskocik-tracy-reloader/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (2)Dependencies (3)Versions (6)Used By (0)

Tracy Reloader
==============

[](#tracy-reloader)

Tracy extension for automatic page live update or refresh through LiveReload

Installation
------------

[](#installation)

```
composer require --dev mskocik/tracy-reloader

```

Add to Tracy
------------

[](#add-to-tracy)

```
tracy:
	bar:
		- Mskocik\TracyReloader\ReloaderPanel(, , )

```

Config
------

[](#config)

Extension supports 2 modes: `LiveReload` or `Server Sent Events`

### LiveReload

[](#livereload)

```
// minimal setup
Mskocik\TracyReloader\ReloaderPanel('LR', [
    'https' => false,       // when accessing LiveReload server from https host
    'host' => null,         // when NULL, pick visited hostname
    'port' => 35729,
    'path' => 'livereload',
    // internal
    'excludeHeaders' => [], // additional header definition for AJAX requests exclusion
]);
```

### Filter ajax requests

[](#filter-ajax-requests)

It is not desired to render Reloader panel for AJAX requests. Because you want only ONE active instance, which should happen only on full page load/reload. Basic AJAX requests are filtered out automatically, but if you send some additional AJAX requests, you can filter them out by specifying headers that are related to these requests.

These headers should be specified in `excludedHeaders` property of `$config` as `$key: $value` pairs.

Example of `local.neon`, when app is using [swup.js](https://swup.js.org/) for app navigation:

```
tracy:
	bar:
		- Mskocik\TracyReloader\ReloaderPanel(mode: 'LR', config: [
			https: true,
			excludeHeaders: [
				x-requested-with: swup
			]
		])

```

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~63 days

Total

5

Last Release

1626d ago

Major Versions

v0.1.1 → v1.0.02021-03-22

v1.1.0 → v2.0.02021-11-29

### Community

Maintainers

![](https://www.gravatar.com/avatar/e9ec054f28406f467db852e61df704d93f9a72901f760233d6d8c6a8dc9d9f59?d=identicon)[mskocik](/maintainers/mskocik)

---

Top Contributors

[![mskocik](https://avatars.githubusercontent.com/u/25513620?v=4)](https://github.com/mskocik "mskocik (11 commits)")

---

Tags

sselivereloadtracyserver sent events

### Embed Badge

![Health badge](/badges/mskocik-tracy-reloader/health.svg)

```
[![Health](https://phpackages.com/badges/mskocik-tracy-reloader/health.svg)](https://phpackages.com/packages/mskocik-tracy-reloader)
```

###  Alternatives

[symfony/mercure

Symfony Mercure Component

43915.1M28](/packages/symfony-mercure)[qruto/laravel-wave

Painless Laravel Broadcasting with SSE.

87048.4k](/packages/qruto-laravel-wave)[hhxsv5/php-sse

A simple and efficient library implemented HTML5's server-sent events by PHP, is used to real-time push events from server to client, and easier than Websocket, instead of AJAX request.

452178.0k3](/packages/hhxsv5-php-sse)[mvanduijker/laravel-mercure-broadcaster

Mercure broadcaster

16866.5k](/packages/mvanduijker-laravel-mercure-broadcaster)[igorw/event-source

A PHP 5.3 library for creating an EventSource stream.

10488.7k2](/packages/igorw-event-source)[tonyhhyip/sse

An easy-to-use, object-oriented library for Server-Sent Events

24165.9k2](/packages/tonyhhyip-sse)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
