πŸ“˜ Vesperia documentation

Theme docs

Storefront identity

Logo & typography

How to upload a logo that renders sharp on every device, and how Vesperia handles fonts.

Logo

Where to set it

Customize β†’ Header section β†’ Logo. You can also use plain text as the logo via Theme settings β†’ Logo β†’ logo_text.

Recommended sizes

  • File width β€” upload at minimum 1000px wide. Vesperia downscales to fit, never upscales.
  • File format β€” PNG with transparent background is ideal. SVG works too. JPG only if you have a colored background to match.
  • Logo width (desktop) β€” typically 120-180px. The default is 140.
  • Logo width (mobile) β€” typically 90-120px. Default 100.

Retina handling

Vesperia automatically generates 1Γ— / 2Γ— / 3Γ— / 4Γ— versions for the device pixel density. You don’t need to provide retina assets manually β€” upload the largest file you have.

Invert logo

The Invert logo image checkbox flips your logo via a CSS filter: invert(1). Use it ONLY if your logo is a black monochrome PNG that needs to render white on a dark header. For colored logos (rose-gold, brand color, etc.) keep this OFF.

Typography

Heading and body font

Theme settings β†’ Typography. You can pick any font from the Shopify font library (Google Fonts plus the bundled system fonts).

  • Heading font β€” used on h1-h6 and the logo text fallback.
  • Heading scale β€” percentage to scale headings up or down (50-150%).
  • Heading transform β€” None / UPPERCASE / lowercase / Capitalize.
  • Body font β€” paragraphs and UI text.
  • Body scale β€” ditto for body text.

What works well

  • Editorial brands β€” a serif heading (Cormorant Garamond, Playfair Display) + a sans body (Inter, Lato).
  • Modern minimal β€” sans for both (Inter for headings, Inter for body).
  • Luxury β€” large serif at 130% heading scale with letter-spacing tightened naturally.
Vesperia’s presets are calibrated combinations β€” they’re an excellent starting point even if you customize from there.

Made with Emergent