vite-plugin-full-reload v1.2.0
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:
npm i -D vite-plugin-full-reload # yarn add -D vite-plugin-full-reload
Usage 🚀
Add it to your plugins in vite.config.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:
root
Files will be resolved against this directory.
Default:
process.cwd()
FullReload('config/routes.rb', { root: __dirname }),
delay
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
FullReload('app/views/**/*', { delay: 100 })
always
Whether to refresh the page even if the modified HTML file is not currently being displayed.
Default:
true
FullReload('app/views/**/*', { always: false })
Acknowledgements
This is a nice plugin, I found it right before publishing this one.
I've made two PRs 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.