Troubleshooting
The following guide documents workarounds to issues some users may experience during installation or running of the Web Starter Kit tools. If you find that your error is not documented below, please open up an issue and we will be happy to discuss how it can be solved.
During installation if you notice the following message appear in your terminal, your system may have experienced an issue installing some of our image optimization tools:
✗ pre-build test failed, compiling from source...
libpng-dev is installed
{ [Error: Command failed: In file included from pngquant.c:59:
./rwpng.h:35:10: fatal error: 'png.h' file not found
#include "png.h" /* libpng header; includes zlib.h */
^
1 error generated.
make: *** [pngquant.o] Error 1
] killed: false, code: 2, signal: null }
This can usually be solved by going to the terminal and running npm cache clear. Next, re-install the Web Starter Kit tooling by running sudo npm install inside the root directory of the download (e.g /web-starter-kit). If you find that this doesn't solve the error and you are a Mac user, try installing Homebrew - a package manager for OSX, and then run brew install libpng.