Gunis

Static site for Gunis built with Hugo extended v0.145.0 (Hugo Narrow requires ≥0.146.0; see version switching below).

Fresh setup (first clone)

• Clone with submodules so the theme is present: git clone --recursive <repo-url> (or run git submodule update --init --recursive after cloning).
• Verify Hugo extended is installed and at least v0.145.0 (Hugo Narrow needs ≥0.146.0; see below if you switch).
• From the repo root, start the dev server (shows drafts): hugo server -D and open the printed localhost URL.

Add new content

• From the repo root run hugo new content/portfolio/<slug>.md to scaffold a page with front matter.
• Drop product images in static/img/portfolio/<slug>/ and point the image field in the new file at the hero asset.
• Update title/description as needed and set draft = false when the page is ready to publish.

Preview before deploy

• Quick start: ./view.sh (runs hugo server -D --buildFuture --disableFastRender and auto-fetches theme submodules).
• Manual: start the live server (includes drafts) with hugo server -D.
• Open the localhost URL Hugo prints (default http://localhost:1313/); it hot-reloads on save. Stop with Ctrl+C.

Deploy (GitHub Pages)

• Deployment is automated via GitHub Actions: every push to main triggers .github/workflows/hugo.yaml (“Deploy Hugo site to Pages”) which builds with Hugo extended v0.145.0 and publishes to the github-pages environment.
• Custom domain: Settings ▸ Pages is configured to www.gunis.ai with “Enforce HTTPS” enabled (keep baseurl in hugo.toml as https://www.gunis.ai/). DNS must point www to GitHub Pages; allow time for the DNS check to turn green.
• Manual build (optional sanity check before pushing): ./deploy.sh or hugo --gc --minify --cleanDestinationDir; output lands in public/ but usually you don’t push public/—the action generates it for you.

Theme toggle

• Theme cascade is set to ["creative-portfolio", "hugo-narrow"] in hugo.toml. Default is Creative Portfolio; switch order if you want to preview Hugo Narrow.
• hugo-narrow lives at themes/hugo-narrow (submodule). It requires Hugo extended ≥0.146.0.

Hugo versions (side-by-side)

• Local binaries are vendored in bin/:
  • ./bin/hugo-145 (default; works with Creative Portfolio)
  • ./bin/hugo-146 (use when testing Hugo Narrow)
• Pick a version per command by setting HUGO_BIN, e.g.:
  • HUGO_BIN=./bin/hugo-145 ./view.sh # preview with 0.145.0 (default)
  • HUGO_BIN=./bin/hugo-146 ./view.sh # preview with 0.146.0 (for Hugo Narrow)
• ./view.sh defaults to ./bin/hugo-145 and falls back to system hugo if the binary is missing.

Notes

• Keep baseurl in hugo.toml pointing at https://www.gunis.ai/ so links and assets resolve correctly.
• Run all commands from the project root.