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:
| Branch | Shopify theme | Theme ID | Role |
|---|---|---|---|
master | Theme A | 186668712300 | Production branch. |
staging | Theme B | 190113481068 | Test variant. Carries experiments that aren't on Theme A. |
- Deploy:
.github/workflows/shopify-deploy-ant.ymlbuilds (npm ci,npm run vite:build) and pushesshopify/to the matching theme on every push tomasterorstaging, 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 runsshopify theme pullinto the matching branch and commits "Sync Theme A/B dashboard changes". To do the same by hand, runshopify theme pull --path shopify/ --theme <theme ID>on the matching branch and commit the result. - Ticket branches come in pairs:
antNNN→ PR intomaster(Theme A) andantNNNb→ PR intostaging(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
| Layer | Technology |
|---|---|
| Build tool | Vite 4 (vite-plugin-shopify) |
| CSS | Tailwind CSS 3 + PostCSS + Sass |
| JS framework | Vue 3 + Vuex 4 |
| Slider | Keen Slider 6 |
| Lightbox | Fancyapps UI 5 |
| Linting | ESLint + Stylelint + Prettier |
| Pre-commit | Husky + pretty-quick |
| Package manager | Yarn 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 configurationBuild Commands
| Command | Description |
|---|---|
yarn start | Dev mode -- runs Shopify CLI + Vite watcher in parallel |
yarn vite:build | Production build |
yarn deploy | Build + push to store |
yarn shopify:pull | Pull live theme |
yarn shopify:pull:content | Pull only JSON content files |
yarn lint | Run all linters |
yarn plop | Scaffold 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
/cartpage: upsell, discount code, plan switching, instant (optimistic) updates via thecartVuex 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
| Template | Purpose |
|---|---|
product.json | Canonical PDP (V2 layout) — used by most products |
product.pdp-cost-per-day.json | Adds cost-per-day display + AI Product Insight |
product.pdp-v3.json / v4 / v5 | A/B test PDP variants (run by brand/marketing) |
product.small-sku.json | Compact layout for trial-size SKUs |
collection.json | Canonical PLP with isotope filter |
collection.cats.json | Cat-only collection variant |
collection.variety-packs.json | Variety packs page |
index.json | Homepage (see Homepage Sections) |
cart.json | Cart page (Vue CartPage) — see Cart & Checkout |
search.json | Search results — see Layout Sections → Search |
page.custom-store-locator.json | Store locator page: Pinpoint app block + Other Brands — see Store Locator |
page.for-veterinarians.json | Password-gated vet portal — see Vet & Quiz Pages |
page.recipe-recommendation.json | Octane AI quiz page |
page.landing-page*.json (6 variants) | Marketing landings (conversion, sales, promo, trial-bars, etc.) |
page.subscribe-now.json | Subscription landing page |
page.subscription-login.json | Account / 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.json | Static 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.