A GitHub Action to quickly install Hugo (including extended version) and build static sites on Linux, macOS, and Windows runners.
peaceiris/actions-hugo is a GitHub Action that automates the installation and setup of Hugo for continuous integration and deployment workflows. It allows developers to quickly install Hugo (including the extended version) on GitHub Actions runners across Linux, macOS, and Windows, enabling fast static site builds. The action solves the problem of manually managing Hugo versions and dependencies in CI/CD pipelines.
Developers and teams using Hugo to build static websites who want to automate their build and deployment process with GitHub Actions. It's particularly useful for those managing documentation sites, blogs, or portfolios with Hugo.
Developers choose this action because it's faster than Docker-based alternatives, supports all major platforms and Hugo features out of the box, and comes with extensive documentation and examples for real-world workflows.
GitHub Actions for Hugo ⚡️ Setup Hugo quickly and build your site fast. Hugo extended, Hugo Modules, Linux (Ubuntu), macOS, and Windows are supported.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Works seamlessly on Ubuntu, macOS, and Windows GitHub Actions runners, as shown in the OS support table, ensuring flexibility for diverse environments.
Uses a JavaScript/TypeScript implementation to complete in seconds, avoiding the slower Docker-based approaches that took over a minute, as noted in the migration to v2.
Supports Hugo extended version and Hugo Modules out of the box with simple configuration options, enabling advanced site-building capabilities like SCSS.
Provides ready-to-use examples for real-world scenarios like PostCSS, Asciidoctor, and non-ASCII filenames, reducing setup time for common integrations.
Exclusively designed for GitHub Actions, making it unusable for projects on other CI/CD platforms and limiting portability.
Integrating features like PostCSS or Asciidoctor requires extra steps and dependencies, as shown in the tips section, adding complexity beyond basic Hugo setup.
Fetching the latest Hugo version depends on Homebrew formulae, which could introduce reliability issues if the source changes or becomes unavailable.