PHPackages                             fortephp/reload - 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. [Templating & Views](/categories/templating)
4. /
5. fortephp/reload

ActiveLibrary[Templating & Views](/categories/templating)

fortephp/reload
===============

Hot reload for Laravel Blade.

v0.2.0(3mo ago)44MITJavaScriptCI failing

Since Mar 8Pushed 3mo agoCompare

[ Source](https://github.com/fortephp/reload)[ Packagist](https://packagist.org/packages/fortephp/reload)[ GitHub Sponsors](https://github.com/johnathonkoster)[ RSS](/packages/fortephp-reload/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (2)Dependencies (9)Versions (4)Used By (0)

Reload
======

[](#reload)

Reload is an experimental package that adds hot reload functionality for Laravel Blade.

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

[](#installation)

To install Reload, run the following from the root of your project:

```
composer require fortephp/reload --dev
```

If you want to customize the package config, you may publish it by running:

```
php artisan vendor:publish --tag=reload-config
```

Vite Setup
----------

[](#vite-setup)

Import the plugin from Composer `vendor`:

```
// vite.config.js
import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import reload from './vendor/fortephp/reload/resources/js/vite-plugin.js';

export default defineConfig({
    plugins: [
        laravel({
            input: ['resources/js/app.js'],
            refresh: true,
        }),
        reload(),
    ],
});
```

Reload watches `resources/views/**/*.blade.php` by default.

If your Blade files live elsewhere, add more watch patterns:

```
reload({
    watch: [
        'resources/views/**/*.blade.php',
        'packages/**/resources/views/**/*.blade.php'
    ],
})
```

The plugin also injects the Reload runtime into `resources/js/app.js` and `resources/js/app.ts` by default. If your app uses different entry files, configure `entries`:

```
reload({
    entries: ['resources/js/admin.js'],
})
```

Available plugin options:

- `watch`: Additional Blade globs to watch.
- `log`: Set to `false` to silence Reload logs.

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

[](#configuration)

The package config lives at `config/reload.php`.

- `enabled`: `null` by default, which enables Reload automatically in the local environment. Set it to `true` or `false` to force the behavior.
- `constructs`: Controls which Blade constructs are instrumented. Available flags are `elements`, `components`, `directives`, `directive_blocks`, and `includes`.
- `include_vendor_views`: Includes vendor Blade views in instrumentation when set to `true`.
- `max_patches_before_reload`: The maximum number of incremental patches Reload will attempt before falling back to a full refresh.

Reporting Issues
----------------

[](#reporting-issues)

When reporting issues, please include all necessary steps to reproduce the issue. Linking to a small repository that contains the setup to reproduce the helps a lot. Include any dependencies required to reproduce the bug.

License
-------

[](#license)

Reload is free software, released under the MIT license.

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance81

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity26

Early-stage or recently created project

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

Total

2

Last Release

101d ago

### Community

Maintainers

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

---

Top Contributors

[![JohnathonKoster](https://avatars.githubusercontent.com/u/5232890?v=4)](https://github.com/JohnathonKoster "JohnathonKoster (7 commits)")

---

Tags

bladehmrlaravel

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fortephp-reload/health.svg)

```
[![Health](https://phpackages.com/badges/fortephp-reload/health.svg)](https://phpackages.com/packages/fortephp-reload)
```

###  Alternatives

[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135212.4k7](/packages/statamic-rad-pack-runway)[ecotone/laravel

Ecotone for Laravel — CQRS, Event Sourcing, Sagas, Durable Workflows, and Outbox on top of Laravel Queue, via PHP attributes.

21313.7k3](/packages/ecotone-laravel)[ycs77/inertia-laravel-ssr-head

Simple SSR Head for Inertia Laravel

3413.0k](/packages/ycs77-inertia-laravel-ssr-head)

PHPackages © 2026

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