The list of known issues and corresponding solutions.
1Error: Error building site: POSTCSS: failed to transform "hb/scss/index.css" (text/css). Check your PostCSS installation.
cobol
The error above will appear if there isn’t POSTCSS CLI installed on your environment.
1npm i postcss-cli
sh
Or
1sudo npm i -g postcss-cli
sh
1POSTCSS: failed to transform "hb/scss/index.rtl.css" (text/css): Plugin Error: Cannot find package 'rtlcss' imported from /usr/lib/node_modules/postcss-cli/index.js'
cobol
The error above will be reached if there isn’t RTLCSS installed on your machine.
1npm i rtlcss
sh
Or
1sudo npm i -g rtlcss
sh
1Error: Error building site: POSTCSS: failed to transform "hb/scss/index.css" (text/css): Error: Failed to parse runtime PurgeCSS config: Error: ENOENT: no such file or directory, open './public/.build/purgecss.json'.
2Please enable the "--renderToDisk" if you are using Hugo server.
cobol
It happens on the case of using Hugo server on production mode without the --renderToDisk
and --disableFastRender
flags.
1hugo server \
2 -e production \
3 --renderToDisk \
4 --disableFastRender \
5 -p 1313 \
6 -b http://localhost:1313
sh
1Error: Error building site: POSTCSS: failed to transform "hb/scss/index.css" (text/css): /home/hbstack/Projects/hbstack/hb/purgecss.config.js:5
2 throw new Error('Hugo stats file not found, please enable the "build.writeStats".')
3 ^
4Error: Hugo stats file not found, please enable the "build.writeStats".
cobol
hugo.toml
1[build]
2 writeStats = true
toml
hugo.yaml
1build:
2 writeStats: true
yaml
hugo.json
1{
2 "build": {
3 "writeStats": true
4 }
5}
json
1Error: Error building site: POSTCSS: failed to transform "hb/scss/index.css" (text/css): Error: Cannot find module '/usr/lib/node_modules/autoprefixer'
cobol
1npm i postcss-cli
sh
Or
1sudo npm i -g postcss-cli
sh
1Error: Error building site: POSTCSS: failed to transform "hb/scss/index.css" (text/css): Error: Cannot find module '@fullhuman/postcss-purgecss'
cobol
1npm i @fullhuman/postcss-purgecss
sh
Or
1sudo npm i -g @fullhuman/postcss-purgecss
sh
There are a number of factors that slow down site builds, here’s a list of some common ones.
We recommend building your sites on high performance disk, such as SSD. Building on Linux system is also recommended if possible, since it’s typically faster than other OSs like Windows.
WSL2 is a good choice for Windows users.