Skip to content

[CI] Migrate to npm-managed local Hugo and standardise Makefile targets#230

Open
hebypaul wants to merge 1 commit into
layer5io:masterfrom
hebypaul:feature/hebypaul/228
Open

[CI] Migrate to npm-managed local Hugo and standardise Makefile targets#230
hebypaul wants to merge 1 commit into
layer5io:masterfrom
hebypaul:feature/hebypaul/228

Conversation

@hebypaul

Copy link
Copy Markdown
Contributor

Notes for Reviewers
This PR updates the local development environment for the layer5-academy repository to use an npm-managed version of Hugo (extended) and standardizes the Makefile targets. This streamlines the setup process by removing the need for contributors to globally install Hugo on their local machines, ensuring version consistency between local environments and CI workflows.

Key Changes:

  • Makefile: Added a check-deps target to validate dependencies and rerouted standard commands (site, serve, build, clean) to trigger their respective local npm scripts.
  • package.json: Added dev:* scripts (e.g., dev:build, dev:site, dev:serve) to explicitly handle Hugo commands using the local node module.
  • Documentation: Updated README.md and CONTRIBUTING.md to remove references to a global Hugo installation and emphasize the unified make setup -> make site workflow.

Acceptance Tests:

  • make setup installs the local hugo-extended dependency cleanly.
  • make site successfully spins up the local development server using the NPM-managed binary.
  • make clean correctly wipes the build cache.
  • A user without a globally installed Hugo can build the site from a fresh clone.

This PR fixes #228

Signed commits

  • Yes, I signed my commits.

@github-actions

Copy link
Copy Markdown
Contributor

🚀 Preview deployment: https://layer5io.github.io/layer5-academy/pr-preview/pr-230/

Note: Preview may take a moment (GitHub Pages deployment in progress). Please wait and refresh. Track deployment here

@Bhumikagarggg Bhumikagarggg left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please resolve conflict and before asking for review please test your PR.

@hebypaul hebypaul force-pushed the feature/hebypaul/228 branch from c5e98e1 to 61315a9 Compare June 23, 2026 17:19

@Bhumikagarggg Bhumikagarggg left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested locally with make setup, make check-deps, make site, make build, and make build-preview. All commands completed successfully.

@hebypaul hebypaul force-pushed the feature/hebypaul/228 branch from 61315a9 to f05a281 Compare June 25, 2026 04:57
Signed-off-by: Heby T Paul <hebytpaul1111@gmail.com>
@hebypaul hebypaul force-pushed the feature/hebypaul/228 branch from f05a281 to 477220e Compare June 26, 2026 10:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[CI] Migrate to npm-managed local Hugo and standardise Makefile targets

2 participants