PHPackages                             mvccore/ext-debug-tracy-refresh - 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. [Framework](/categories/framework)
4. /
5. mvccore/ext-debug-tracy-refresh

ActiveLibrary[Framework](/categories/framework)

mvccore/ext-debug-tracy-refresh
===============================

MvcCore - Extension - Debug - Tracy - Panel Refresh - automatic refresh of current browser tab on selected server directory changes.

v5.3.3(1mo ago)031BSD-3-ClausePHPPHP >=5.4.0

Since Apr 13Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/mvccore/ext-debug-tracy-refresh)[ Packagist](https://packagist.org/packages/mvccore/ext-debug-tracy-refresh)[ RSS](/packages/mvccore-ext-debug-tracy-refresh/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (13)Used By (0)

MvcCore - Extension - Debug - Nette Tracy - Panel Refresh
=========================================================

[](#mvccore---extension---debug---nette-tracy---panel-refresh)

[![Latest Stable Version](https://camo.githubusercontent.com/79d55e60ff45a9c51aa6325b5ea40709bde628b38ace3c9dc47395860424eee9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f537461626c652d76352e332e332d627269676874677265656e2e7376673f7374796c653d706c6173746963)](https://github.com/mvccore/ext-debug-tracy-refresh/releases)[![License](https://camo.githubusercontent.com/53baed538c1c87a033a212f6f4acce684d36137f8622307643ab25e08118452e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d425344253230332d627269676874677265656e2e7376673f7374796c653d706c6173746963)](https://mvccore.github.io/docs/mvccore/5.0.0/LICENSE.md)[![PHP Version](https://camo.githubusercontent.com/9e923690739211296a00adce5d359999dfa345f80fc1b2e2cfe72c49523ee334/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d2533453d352e342d627269676874677265656e2e7376673f7374796c653d706c6173746963)](https://camo.githubusercontent.com/9e923690739211296a00adce5d359999dfa345f80fc1b2e2cfe72c49523ee334/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d2533453d352e342d627269676874677265656e2e7376673f7374796c653d706c6173746963)

MvcCore Debug Tracy Extension to to automatic refresh of current browser tab on selected directory changes.

**THIS PACKAGE IS HIGHLY RECOMMENDED TO USE ONLY IN DEVELPMENT ENVIRONMENT!**

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

[](#installation)

```
composer require mvccore/ext-debug-tracy-refresh
```

#### Linux

[](#linux)

User used to execute composer.phar and php scripts over web server has to have:

- Execute privileges in Node.JS directory.
    If there is necessary to add those privileges into `/etc/sudoers`, you can use: `www ALL = NOPASSWD: /root/.nvm/versions/node/vXX.XX.XX/bin`
- Node.JS bin dir in `$PATH` environment variable or
    the dir could be in `system.ini` config in section `[debug]`:
    `refresh.nodePath = "/root/.nvm/versions/node/vXX.XX.XX/bin"`

#### Windows

[](#windows)

User used to execute composer.phar and php scripts over web server has to have:

- Execute privileges in Node.JS directory, but Windows mostly doesn't care about this.
- Node.JS bin dir in `%PATH%` environment variable or
    the dir could be in `system.ini` config in section `[debug]`:
    `refresh.nodePath = "/root/.nvm/versions/node/vXX.XX.XX/bin"`

How It Works
------------

[](#how-it-works)

##### Features

[](#features)

- When there is detected file change, page is automaticly refreshed.
- You can select only directories (with all subdirectories and files) you need to monitor file changes.
- You can configure exclude patterns to exclude huge directories like
    `.git`, `.hg`, `.svn`, `vendor`, `~/Var` or any other directories or files
    by path or JS regular expression definition.
- You can configure extensions to include only to detect file changes.
- More specific include/exclude filters causes faster monitoring start!
- Server side application with WebSocket connection ends itself automatically,
    if there are no WebSocket connection after one minute, so you don't care
    about to stop it somewhere.

##### Instalation

[](#instalation)

The extension executes command `npm install` durring instalation with `composer.phar`.
You can do it manually if it fails in extension root directory, where is `package.json`.
Npm instalation creates `./node_modules/` directory in extension root dorectory
and downloads a few packages (approx. 20). There is downloaded npm package
`@mvccore/ext-debug-tracy-refresh-js`, originaly written in TypeScript with prebuilded
Javascript files, used for Tracy debug panel and server side app in Node.JS.
When there is started file system monitoring from Tracy debug panel,
there is started via AJAX request a Node.JS application on server with WebSocket
connection on configurable adress (`$_SERVER['SERVER_NAME']` by default)
and port (9006 by default). You need to care about privileges for user
used to execute PHP scripts over web server to have execute privileges to run Node.JS.

Configuration
-------------

[](#configuration)

Configuration is possible in `system.ini` config with those properties:

```
...
[debug]
; there is always used server name by application request
refresh.address  = 127.0.0.1
; you need to open this port in server firewall
refresh.port     = 9006
; you need to have exeute privileges for user used
; to execute composer.phar and PHP scripts over web server:
refresh.nodePath = "/root/.nvm/versions/node/vXX.XX.XX/bin"
...
```

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance92

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

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 ~131 days

Recently: every ~210 days

Total

12

Last Release

40d ago

### Community

Maintainers

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

---

Top Contributors

[![tomFlidr](https://avatars.githubusercontent.com/u/1833722?v=4)](https://github.com/tomFlidr "tomFlidr (67 commits)")

---

Tags

pluginframeworkdebugnettechangesmvcextensionplug-inautoexttracyrefreshmvccore

### Embed Badge

![Health badge](/badges/mvccore-ext-debug-tracy-refresh/health.svg)

```
[![Health](https://phpackages.com/badges/mvccore-ext-debug-tracy-refresh/health.svg)](https://phpackages.com/packages/mvccore-ext-debug-tracy-refresh)
```

PHPackages © 2026

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