Admin

name	type	size	perms	modified	actions
[parent directory]
dist/	dir	-	0775	2026-09-15 05:27:52
node_modules/	dir	-	0775	2026-08-24 21:18:43
LICENSE.txt	file	1,072 B	0664	2026-01-12 07:55:29	edit
package.json	file	2,091 B	0664	2026-01-12 07:55:29	edit
README.md	file	3,031 B	0664	2026-01-12 07:55:29	edit

editing: README.md

<h2 align='center'><samp>vite-plugin-full-reload</samp></h2>

<p align='center'>Automatically reload the page when files are modified</p>

<br>

[vite-plugin-full-reload]: https://github.com/ElMassimo/vite-plugin-full-reload
[vite-plugin-live-reload]: https://github.com/arnoson/vite-plugin-live-reload
[Vite Ruby]: https://github.com/ElMassimo/vite_ruby
[JS From Routes]: https://github.com/ElMassimo/js_from_routes
[picomatch]: https://github.com/micromatch/picomatch#globbing-features

## Why? 🤔

When using _[Vite Ruby]_, I wanted to see changes to server-rendered layouts and templates without having to manually reload the page.

Also, in _[JS From Routes]_ path helpers are generated when Rails reload is triggered.

Triggering a page reload when `config/routes.rb` is modified makes the DX very smooth.

## Installation 💿

Install the package as a development dependency:

```bash
npm i -D vite-plugin-full-reload # yarn add -D vite-plugin-full-reload
```

## Usage 🚀

Add it to your plugins in `vite.config.ts`

```ts
import { defineConfig } from 'vite'
import FullReload from 'vite-plugin-full-reload'

export default defineConfig({
  plugins: [
    FullReload(['config/routes.rb', 'app/views/**/*'])
  ],
})
```

This is useful to trigger a page refresh for files that are not being imported, such as server-rendered templates.

To see which file globbing options are available, check [picomatch].

## Configuration ⚙️

The following options can be provided:

- <kbd>root</kbd>
  
  Files will be resolved against this directory.

__Default:__ `process.cwd()`

``` js
  FullReload('config/routes.rb', { root: __dirname }),
  ```

- <kbd>delay</kbd>

How many milliseconds to wait before reloading the page after a file change.
  It can be used to offset slow template compilation in Rails.

__Default:__ `0`
  
  ```js
  FullReload('app/views/**/*', { delay: 100 })
  ```

- <kbd>always</kbd>

Whether to refresh the page even if the modified HTML file is not currently being displayed.

__Default:__ `true`
  
  ```js
  FullReload('app/views/**/*', { always: false })
  ```

## Acknowledgements

- <kbd>[vite-plugin-live-reload]</kbd>

This is a nice plugin, I found it right before publishing this one.

I've made [two](https://github.com/arnoson/vite-plugin-live-reload/pull/3) [PRs](https://github.com/arnoson/vite-plugin-live-reload/pull/5) that were needed to support these use cases.

At this point in time they are very similar, except this library doesn't create another `chokidar` watcher.

## License

This library is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

cancel