What is Instant Reload?
Local’s Instant Reload feature saves you time so you never have to click “refresh” in your browser again. Instant reload is helpful for:
- Working with your code and browser side-by-side: Maintain flow-state and streamline previewing your CSS changes.
- Debugging file changes: Local displays a log stream of your latest changes which helps make sure new changes are detected and displayed.
- Make edits in real-time: Changes are displayed immediately meaning you’ll never have to clear your cache again.
Where can I get Instant Reload?
The easiest way to get the Instant Reload is to install it from the Add-ons tab within Local.
Using Instant Reload
All of the Instant Reload functionality can be found within the “Instant Reload” section of the “Tools” tab in Local.
The general flow of using this tool looks like this:
- Enable Instant Reload for the site
- Open the site within a browser. You’ll know that Instant Reload is working correctly if you see the “Instant Reload Enabled” message in the upper-right corner of the browser.
- Edit a CSS file in your editor of choice. Once that file is saved, Instant Reload will automatically refresh those styles in the browser!
Local keeps a session log when a CSS file has changed. To view that log, navigate to the “Instant Reload” section of the “Tools” tab.
Instant Reload is enabled on a per-site basis. Once you’ve enabled Instant Reload, it will automatically start up when using Local in the future.
Instant Reload only watches
wp-content/themes for changes to .css files.
Changes that are made using page builders or other WordPress plugins which do not persist their changes to the filesystem will not be refreshed.
Why isn’t Instant Reload detecting my changes?
There could be a number of reasons for this. Here are some common things to check:
- Ensure that you are editing a CSS file within either the
themesfolder of the site.
- Make sure the styles are specific enough. Using the Browser’s developer tools, inspect the styles for the element you are working on and ensure the style that’s being written is specific enough.
- Disable any caching plugins on the Local site.
Still not working? Simplify the networking setup and try switching to localhost routing mode.