Logo Configuration

The Ryder theme supports two logo styles: a text mark (the default) and a custom image. Both are configured entirely in hugo.toml — no template edits required.

Text logo (default)

The default logo renders two coloured words side-by-side. The first word is displayed in sky-blue and the second in lime-green.

[params]
  logo_firstWord = "my"
  logo_lastWord  = "site"
  logo_tagline   = "FOR HUGO WEBSITES"

If neither logo_firstWord nor logo_lastWord is set, the theme automatically splits title on the first space and uses those two words.

Optional text-logo params

ParamTypeDescription
logo_fontClassstringTailwind CSS font-family class applied to the logo text (e.g. "font-titillium")
logo_collapseboolWhen true the logo collapses to initials only on small screens
logo_taglinestringSmall all-caps label below the words
[params]
  logo_firstWord = "ryder"
  logo_lastWord  = "theme"
  logo_tagline   = "FOR HUGO WEBSITES"
  logo_fontClass = "font-titillium"
  logo_collapse  = true

To replace the text mark with your own image:

  1. Copy your logo file into your site’s static/images/ directory:

    your-sstiatteii/cm/agelsgo.png
  2. Add logo_png to [params] in config/_default/hugo.toml:

    [params]
      logo_png = "/images/logo.png"
    

The image is rendered at a maximum height of 4 rem; width scales automatically. Any web-safe format works — .png, .svg, .webp, .jpg.

Combining an image with a tagline

logo_tagline still appears below the image when logo_png is set:

[params]
  logo_png     = "/images/logo.svg"
  logo_tagline = "YOUR TAGLINE HERE"

Wrapper chrome

The grey rounded box (background, hover state, padding) around the logo exists to frame the generated text mark. It’s usually unwanted chrome around a real image, so it’s dropped automatically the moment logo_png is set — no separate opt-out needed. This very page demonstrates it: its front matter sets logo_png, so its header shows a plain image with no box around it, while every other page on this site keeps the boxed text mark.

To keep (or add back) some wrapper styling either way, set logo_wrapperClass explicitly — it always wins over the default:

[params]
  logo_wrapperClass = "bg-white/80 rounded-lg p-2"

logo_png itself is read via .Param, so it — like logo_wrapperClass — is page-overridable: front matter wins over site config, exactly as used here.

Summary of logo params

ParamDefaultDescription
logo_firstWordfirst word of titleFirst word of the text mark
logo_lastWordsecond word of titleSecond word of the text mark
logo_tagline(none)Small label shown below words or image
logo_fontClass(none)Tailwind font class for the text mark
logo_collapsefalseCollapse text to initials on mobile
logo_png(none)Path to a logo image (page-overridable via .Param); hides the text mark when set, and drops the wrapper chrome unless logo_wrapperClass is also set
logo_wrapperClassboxed text-mark chrome, or none with logo_pngExplicit override for the wrapper <div>’s classes