Skip to content

My Perfect Pet -- Theme Overview ​

Theme: My Perfect Pet (v1.0.0) Owner: Alpine Pet Holdings LLC Package version: 4.5.0 Store: myperfectpetfoodLive site: https://www.myperfectpetfood.com

Homepage and PDP at a glance

The homepage hero is section-hero-video (the three section-main-home* variants are in the template but disabled), and the homepage content stack uses Better Bowls, New Look, Quiz V2, Store Locator V2, Section Blends, Switch Fresh — see Homepage Sections. Below the PDP buy box sit brand-pillar sections such as Section Block Bg and Headline Text Button — see Product Pages.

Files with an -old suffix (e.g. layout-header-old.liquid, section-blends-blocks-old.liquid) are legacy fallbacks — not used live.

Branches and themes (A/B setup) ​

MPP runs two live themes for Intelligems theme tests. Each has its own git branch and GitHub Actions deploy:

BranchShopify themeTheme IDRole
masterTheme A186668712300Production branch.
stagingTheme B190113481068Test variant. Carries experiments that aren't on Theme A.
  • Deploy: .github/workflows/shopify-deploy-ant.yml builds (npm ci, npm run vite:build) and pushes shopify/ to the matching theme on every push to master or staging, then posts to Slack.
  • Pull customizer edits back: run the Sync Shopify Dashboard Changes workflow (shopify-sync.yml, manual, choose All / Theme A / Theme B). It runs shopify theme pull into the matching branch and commits "Sync Theme A/B dashboard changes". To do the same by hand, run shopify theme pull --path shopify/ --theme <theme ID> on the matching branch and commit the result.
  • Ticket branches come in pairs: antNNN → PR into master (Theme A) and antNNNb → PR into staging (Theme B). A feature is only on both themes when both PRs are merged.

Differences between Theme A and Theme B

staging differs from master in the pricing-display experiments: green "You save" savings in the cart (Cart & Checkout) and on the purchase options, plus per-row cost-per-day figures (Product Pages). Everything else, including the PLP, is the same on both.

Tech Stack ​

LayerTechnology
Build toolVite 4 (vite-plugin-shopify)
CSSTailwind CSS 3 + PostCSS + Sass
JS frameworkVue 3 + Vuex 4
SliderKeen Slider 6
LightboxFancyapps UI 5
LintingESLint + Stylelint + Prettier
Pre-commitHusky + pretty-quick
Package managerYarn 1.22

Directory Structure ​

mpp/
├── src/                        # Source files (compiled by Vite)
│   ├── entrypoints/            # Vite entry points -> shopify/assets/
│   ├── css/                    # Global styles, Tailwind base
│   ├── fonts/                  # Custom font files
│   ├── img/                    # Static images
│   ├── utils/                  # JS utility helpers
│   └── vue/                    # Vue 3 application
│       ├── main.js             # Vue app bootstrap
│       ├── main.scss           # Vue global styles
│       ├── components/         # ~40 Vue component directories
│       ├── directives/         # Custom Vue directives
│       ├── mixins/             # Shared Vue mixins
│       └── store/              # Vuex store modules
├── shopify/                    # Shopify theme (deployed to store)
│   ├── assets/                 # Compiled output + static assets
│   ├── config/                 # settings_schema.json, settings_data.json
│   ├── layout/                 # theme.liquid, password.liquid, gift_card.liquid
│   ├── locales/                # Translation files
│   ├── sections/               # ~85 Liquid section files
│   ├── snippets/               # Reusable Liquid snippets
│   └── templates/              # JSON templates (~37 files)
└── vite.config.js              # Vite build configuration

Build Commands ​

CommandDescription
yarn startDev mode -- runs Shopify CLI + Vite watcher in parallel
yarn vite:buildProduction build
yarn deployBuild + push to store
yarn shopify:pullPull live theme
yarn shopify:pull:contentPull only JSON content files
yarn lintRun all linters
yarn plopScaffold new components

The repo has both yarn.lock and package-lock.json. CI uses npm (npm ci, npm run vite:build), and the README also says to use npm.

Key Integrations ​

  • ReCharge Subscriptions -- @rechargeapps/storefront-client (NPM) + /recharge/ portal
  • Klaviyo -- klaviyo-subscribe (NPM) for newsletter forms + onsite app embed
  • Junip Reviews -- Script-based widget for product and store reviews
  • Octane AI -- Embedded quiz for recipe recommendations
  • Intelligems -- A/B testing (Theme A vs Theme B), script hard-coded in theme.liquid
  • Pinpoint Store Locator -- app block on the store locator page (docs)
  • Checkout Savings -- custom checkout extension showing subscription savings (docs)

See Third-Party Integrations for details.

Vue Components ​

The theme uses ~40 Vue component directories mounted via the vue attribute on Liquid elements. They are auto-registered by src/entrypoints/main.js. The exception is account, which is loaded asynchronously so the ReCharge client isn't in the main bundle. Key component families:

  • StoreCart / CartPage / CartItem -- Cart drawer and /cart page: upsell, discount code, plan switching, instant (optimistic) updates via the cart Vuex store
  • SiteNavigation / RightNavigation -- Mega-menu with nav banners, mobile hamburger menu, right nav
  • Search -- Header search dropdown (products + articles)
  • PdpGallery -- Product image gallery (multiple versions: default, v2-v5)
  • ProductOptions / ProductSelectPlan -- Variant selectors with subscription plans
  • Quantity / ResultTrialPeriod v1–v5 -- Weight input, purchase options, feeding / cost-per-day calculator
  • MobilePdpCta -- Mobile sticky "Build Your Cart" bar (controlled by pdp_sticky_cta)
  • ProductPopup -- PLP quick-shop popup
  • Filter -- PLP diet filter pills
  • Newsletter -- Klaviyo-powered email signup
  • AnnouncementBar -- Rotating promo banner (Keen Slider)
  • VetForm -- Password-gated veterinarian portal
  • SliderReviews / Junip -- Junip review widgets and custom carousels

Templates ​

TemplatePurpose
product.jsonCanonical PDP (V2 layout) — used by most products
product.pdp-cost-per-day.jsonAdds cost-per-day display + AI Product Insight
product.pdp-v3.json / v4 / v5A/B test PDP variants (run by brand/marketing)
product.small-sku.jsonCompact layout for trial-size SKUs
collection.jsonCanonical PLP with isotope filter
collection.cats.jsonCat-only collection variant
collection.variety-packs.jsonVariety packs page
index.jsonHomepage (see Homepage Sections)
cart.jsonCart page (Vue CartPage) — see Cart & Checkout
search.jsonSearch results — see Layout Sections → Search
page.custom-store-locator.jsonStore locator page: Pinpoint app block + Other Brands — see Store Locator
page.for-veterinarians.jsonPassword-gated vet portal — see Vet & Quiz Pages
page.recipe-recommendation.jsonOctane AI quiz page
page.landing-page*.json (6 variants)Marketing landings (conversion, sales, promo, trial-bars, etc.)
page.subscribe-now.jsonSubscription landing page
page.subscription-login.jsonAccount / subscription portal landing
page.feeding-guide.json, page.our-food.json, page.how-we-started.json, page.refunds.json, page.shipping.json, page.frequently-asked-question.json, page.meet-antelope.json, page.accessibility.json, page.contact.jsonStatic content pages. For the Shipping page layout see Content page sections

Don't change a product's template without coordination

product.json (V2) is the default, but the current PDP design — including the mobile purchase bar and the calorie-based feeding calculator — is the V5 layout (product.pdp-v5.json). Product ↔ template assignments live in Shopify Admin, not in git. Some templates are part of running A/B tests, and switching a product mid-test corrupts the results. See Product Pages.

Antelope Themes Documentation

Enter the password to access this site.