Use when user asks about "performance", "SEO", "optimization", "page speed", "build", "deploy", mentions "Cloudflare", "Hugo build", "assets", "custom CSS", "favicon", or discusses site performance and deployment.
# Production build
hugo --gc --minify
# Development server (includes drafts)
hugo server -D
Cloudflare Pages auto-deploys on push to main.
Environment variable in Cloudflare dashboard:
HUGO_VERSION = 0.156.0
Build settings: hugo --gc --minify, output directory: public.
Blowfish provides these auto-loaded extension files:
assets/css/custom.css - loaded automatically by Blowfishlayouts/partials/extend-footer.html - injected at page bottomlayouts/partials/extend-head.html - injected in <head>Never modify theme files directly in themes/blowfish/. Use extension
points or layout overrides in layouts/.
Favicon generation (produces all sizes + ICO + webmanifest):
node scripts/generate-favicon.mjs
OG image generation:
node scripts/generate-og-image.mjs
Both scripts use the canvas npm package and output to static/.
All in config/_default/:
hugo.toml - Base site config (theme, taxonomies, outputs)params.toml - Theme parameters (color scheme, homepage layout, search)languages.en.toml - Language settings, author profile, social linksmenus.en.toml - Navigation menu structuremarkup.toml - Markdown rendering settingsBlowfish is a git submodule:
git submodule update --init --recursive
# Playwright E2E tests
npm test
# Markdown lint
npx markdownlint-cli2 'content/**/*.md'