In this section, we are going to talk about the key points of deployments to avoid most problems during deployment.

Build Tools§

As Prerequisites mentioned, you’ll need to set up those tools on your deployment environment.

Installing Dependencies§

We use NPM for managing the theme’s dependencies, it’s necessary to install the dependencies on deployment environment, since we SHOULD NOT commit the node_modules folder.

1$ npm i

npm i is the shortcut of npm install.

The package.json and package-lock.json MUST be committed, npm relies on the former, the later will save the installation time.

Building Site§

It’s time to build the site after installing the dependencies.

1$ hugo --gc --minify
  • --minify minify the final HTML.

You can change the baseURL via the -b flag.

The command generated the site and save it under the public directory by default.

Deploying Site§

This step depends on the which deployment methods you use.

Deployment Methods§

  1. Docker
  2. GitHub Pages
  3. Netlify
  4. Cloudflare Pages
  5. GitLab Pages
  6. Find more on Hosting & Deployment

Further Reading§