Watchers

If you are either working on the storefront or the administration you might want to use the watchers for it.
These will make sure to compile everything as soon as new changes and file modifications have been recognized.
You only need to reload your browser and all changes are visible immediately.

Because the watchers are not very dev-friendly sometimes, we've prepared a small little makefile for you.
It's outside the DocRoot in the directory /var/www
cd /var/www
make
watch-storefront               #Starts watcher for storefront at http://localhost
stop-watch-storefront          #Reverts everything back to normal operation
        
watch-admin                    #Starts watcher for admin at http://localhost:8888
Administration Watcher
If you want to start the watcher for the administration, run the corresponding makefile command.
This takes a bit, but not that long.
Afterwards please open the administration with this URL:

http://localhost:8888

As soon as you modify any files in the administration and upload them to the container, the watcher will recognize the changes, and compile the app again. In addition to this, it will also automatically refresh your browser (Hot Module Replacement).

To stop the watcher, simply cancel the command / process.
​
Storefront Watcher
The watcher for the storefront requires a few things to be set.
Follow this simple guide to get started.
1.Ports
You need to expose the correct ports of your Docker container.
Please expose the ports "9999" and "9998".
The easiest way is to just expose them directly with "9999:9999" and "9998:9998" in your Docker setup.

2.Start Make Command
Connect into your container and navigate to the folder "/var/www".
This prepared makefile contains a command to start the storefront watcher.

3.Open Browser
If the make command has finished, your watcher should be ready.
Just open the URL in your browser and you should see that the CSS styles are loaded in a lazy way. That means it is working.
Please keep in mind, that different Shopware versions require different URLs to be used.
Shopware < 6.4: http://localhost
Shopware >= 6.4: http://localhost:9998​
The storefront watcher requires a special Request Header to be set.
We know this is annoying, so we've injected it automatically for you when starting the watcher using our make command.
This command creates a new .htaccess file that automatically sets the required header.
So there's no need to do anything on your side! Just code!

Please consider, due to this, there's a separate "stop" command in the make file to remove it again and get back to the original storefront without the watcher.

Development - Previous

Debugging

Next - Development

App Development

Last modified 1yr ago

Copy link

On this page

Administration Watcher

Storefront Watcher