# peaceiris/actions-hugo

GitHub Actions for Hugo ⚡️ Setup Hugo quickly and build your site fast. Hugo extended, Hugo Modules, Linux (Ubuntu), macOS, and Windows are supported.

Repository: https://github.com/peaceiris/actions-hugo
Canonical: https://ross.abutalabs.com/products/actions-hugo
Homepage: https://github.com/marketplace/actions/hugo-setup
Language: TypeScript
License: MIT
License Family: permissive
Topics: github-actions, hugo, actions
Last push: 2026-08-24T02:06:14+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 83, longevity 100
- inputs: {"age_days": 2661, "days_push": 10, "days_rel": 115, "gap_med": 0.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1574, forks 95 (observed 2026-08-28T04:05:05.798056+00:00)

## What it is
A GitHub Action (written in TypeScript) that installs Hugo, including the extended version and Hugo Modules support, onto GitHub Actions runners. It enables fast automated builds and deployment of Hugo static sites, e.g., to GitHub Pages.

## Use cases
- set up hugo in a github actions workflow
- build and deploy my hugo site to github pages automatically
- install hugo extended version in ci
- cache hugo modules in a ci pipeline
- run hugo builds on ubuntu, macos, and windows runners
- automate static site publishing on every push

## When to choose
- you build a Hugo site with GitHub Actions CI/CD
- you need Hugo extended or Hugo Modules support in your pipeline
- you want a fast, maintained setup action instead of pulling Docker images
- you deploy static sites to GitHub Pages or similar hosts

## When to avoid
- your site is built with a different static site generator like Jekyll, Gatsby, or Next.js
- you don't use GitHub Actions for CI/CD
- you need to run Hugo outside of CI environments

## Facets
- artifact type: plugin
- maturity: active
- function: ci-cd, deployment, build-tool, developer-tools
- domain: web-development
- platform: windows, cloud
- tags: github-actions, hugo, static-site, github-pages, setup-action, devops, automation, static-site-generator, linux, macos, docker

## Member repositories
- peaceiris/actions-hugo (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:05.798056+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:57:41.600076+00:00, confidence not recorded.
  - readme: https://github.com/peaceiris/actions-hugo (fetched 2026-08-28T04:05:05.798056+00:00, sha 72049787c39f)
  - homepage: https://github.com/marketplace/actions/hugo-setup (fetched 2026-08-29T11:27:50.032888+00:00, sha f1d6db8accb4)
- Data as of 2026-08-30T08:39:29.467469+00:00.