Peregrinedocs

Built for speed.
Designed to convert.

Peregrine is a high-performance Shopify theme that loads only what each page needs — modular sections, vanilla JavaScript, zero bloat, and structured data on every page.

See everything it does Read the docs

Measured, not claimed

Google Lighthouse, mobile profile, run against the populated demo store — a five-slide hero, fourteen homepage sections, real products.

96Performance
homepage
99Performance
collection page
100SEO
96Accessibility
1.0sLargest Contentful Paint
homepage, mobile
150msTotal Blocking Time
homepage, mobile
~200msVariant switch
server-rendered, 24-variant product
0jQuery, frameworks
or global bundles

Best Practices scores 77 on the password-protected demo store; every remaining deduction is Shopify's own staff preview bar, which does not exist on a live store. Total page weight on mobile, images included: homepage 220 KB, collection page 109 KB, product page 84 KB.

Performance first

Per-section CSS and JavaScript load on demand. No monolithic bundles, no jQuery, no framework weight — a shorter document and faster paint on every page.

A guaranteed H1 on every page

Merchant-controlled heading tags (H1–H6) on every section, automatic H1 assignment with merchant override, and a page-level fallback so no page ever ships without one.

How the H1 system works →

Art-directed mobile images

Every image picker pairs with an optional mobile image. Phones download only the mobile file — better LCP, no cropping compromises.

Homepage sections →

A header that earns its space

Nine logo/nav layouts, mega menus with promo images, transparent homepage mode, three sticky behaviours, utility bar with market pickers, and predictive search in a flyout.

Header & navigation →

A gallery that does the selling

Eight desktop gallery layouts and four mobile ones, video and 3D handled properly, and a full-screen zoom that isn't downloaded until a shopper actually zooms.

Product page →

Collections built to browse

Native filtering in three desktop layouts, quick add straight from the grid in four styles, and pagination, Load more or capped infinite scroll — your choice.

Collection page →

Structured data throughout

Organization, WebSite with sitelinks search box, Product with per-variant offers, and BreadcrumbList — rendered server-side on every relevant page.

Structured data →

Everything in the box

The full inventory. Every line links to the chapter that documents it, click by click — the docs are the evidence, not the small print.

Speed & engineering

  • CSS and JavaScript loaded per section, only on pages that use them
  • Vanilla JavaScript throughout — no jQuery, no framework, no global bundle
  • Variant switching rendered by the server: price, availability, SKU, gallery, URL and the sticky bar all update from one request
  • Lazy-loaded zoom, video and 3D players — nothing downloaded until a shopper asks
  • Responsive images with width-matched srcset, and a separate mobile image on every picker
  • Every form works without JavaScript — add to cart, contact, newsletter, search and login all have a plain-HTML path
  • Placeholder art that costs nothing: SVG placeholders are served as files, not inlined into the page
Getting started →

SEO & structured data

  • JSON-LD on every page: Organization, WebSite with sitelinks search, Product with per-variant offers and GTIN, BreadcrumbList, BlogPosting, FAQPage
  • Exactly one H1 on every page — merchant-chosen heading tags per section, automatic H1 arbitration, page-level fallback
  • Self-referencing canonicals and clean pagination URLs
  • HTML sitemap pages for products, collections and blogs
  • Art-directed mobile images for a faster Largest Contentful Paint on phones
  • Merchant-editable meta titles and descriptions on every template
SEO features →

Header & navigation

  • Nine logo and navigation layouts, with logo width and position controls
  • Mega menus with promo images, or simple dropdowns — per top-level item
  • Transparent header mode for the homepage hero
  • Three sticky behaviours: always, on scroll-up, or never
  • Announcement bar, and a utility bar carrying country and currency pickers and social links
  • Predictive search in a flyout: products, collections, articles and pages as you type
  • Cart drawer or cart page, with a cart count that updates without a reload
Header & navigation →

Homepage sections

  • Slideshow with up to five slides, each with its own mobile image, eyebrow, heading, text and buttons, plus autoplay and size controls
  • Image with text, image banner, rich text, multicolumn, promo tiles, collection list, featured collection
  • Product recommendations, blog posts, testimonials, newsletter, contact form
  • FAQ accordion that emits FAQPage structured data automatically
  • Custom section that takes any block, so a merchant can compose layouts the theme never anticipated
  • Consistent spacing, colour and heading-tag controls on every section
Homepage sections →

Product page

  • Eight desktop gallery layouts, four mobile layouts, thumbnails, dots, video, 3D model and AR
  • Variant picker as swatches, buttons or a dropdown — chosen automatically per option, or set by the merchant
  • Unavailable combinations disabled, hidden or shown — merchant's choice, kept in step by the sticky bar
  • Sticky add-to-cart bar with its own picker, appearing when the main button scrolls away
  • Price with compare-at, "Up to x% off" and unit pricing; inventory as a traffic light with low-stock counts
  • SKU and barcode, size guide from any page, share, local pickup availability, delivery and returns rows pulled from your store policies
  • Trust icons, product badges, product description as a block or a full-width section
  • Dynamic checkout buttons in Shopify's own colours, Shop Pay Installments, gift-card recipient form
  • Subscriptions and complementary products supported when the matching Shopify apps are installed
  • Pre-order without an app — tag a product, get a Pre-order button, a ship date and an order you can find again
Product page →

Collections, filters & search

  • Native Shopify filtering in three desktop layouts — sidebar, drawer or horizontal — with sticky sidebar, open-by-default groups and show-more thresholds
  • Colour swatch, list, checkbox and price-range facets, with active-filter pills
  • Quick add from the grid in four styles, including variant selection in a modal
  • Pagination, Load more, or infinite scroll with a cap
  • Collection banners, description above or below the grid, per-device title alignment, sort menu
  • Search results page with the same filters and grid, and a list-collections page
Collection filters →

Cart & checkout

  • Cart page and cart drawer sharing one implementation — same rules, same look
  • Progress bar toward free shipping, a free gift, or a discount threshold
  • Order note, line-item properties, selling-plan lines, quantity rules and maximums honoured from Shopify
  • Express checkout buttons (Shop Pay, Google Pay, Apple Pay, PayPal) on both cart surfaces
  • Empty-cart state with a path back to shopping
Cart →

Merchandising

  • Product badges: New, Sale as text, percentage or amount, "Up to x%" for mixed discounts, and four custom badges driven by tags or metafields
  • Promo tiles, image banners and slideshows that all accept a mobile image
  • Per-product colour and button overrides through metafields — one product can look different without touching the theme
  • Testimonials, trust icons and policy rows to answer objections on the page
  • Recently viewed products, remembered in the shopper's own browser and never sent anywhere
Product badges →

Every other page

  • Blog index and article pages with related posts, author, date, comments and BlogPosting data
  • Customer accounts: login, register, orders, addresses
  • Contact page with an hCaptcha-protected form; gift card page with your brand logo; password page with newsletter capture; a 404 that helps
  • Markets and multi-currency ready — pickers in the utility bar
Blog & articles →

Design & accessibility

  • Colour tokens for every surface, with contrast-checked defaults and per-section overrides
  • Typography, button shape, corner radius and spacing controlled from one place
  • Focus rings, skip link and labelled controls throughout
  • Forms with inline, readable errors
  • Back to top button that steps aside for the sticky bar and honours reduce-motion
Theme settings →

Merchant control

  • Sections and blocks everywhere — add, remove, reorder from the theme editor with nothing lost
  • Metafield and metaobject support with a documented, opinionated set of definitions
  • App blocks on product and other templates for review and translation apps
  • A changelog for every release, and docs written as click-by-click guides in plain English
Metafields →

Proof, not promises

Support that answers

Faults, setup questions and Shopify compatibility are covered. Replies within two business days, critical faults ahead of everything else, and a changelog that tells you exactly what changed in every release.

Get started Support & contact Changelog