Integrations
ReCharge Subscriptions
NPM Package
Package: @rechargeapps/storefront-client v1.17.3
The ReCharge storefront client is used to manage subscription flows directly from the Vue frontend. It powers:
- Subscribe & save options on product pages
- Trial subscription flows
- Subscription plan selection (Fully Fresh, Half Fresh, Topper)
Account Portal
The account system defaults to ReCharge-only login (only_recharge: true in Account Settings). When enabled, the login redirects to the ReCharge customer portal at /recharge/ where customers manage:
- Active subscriptions
- Delivery frequency
- Payment methods
- Order history
Configuration
Relevant settings in settings_schema.json under Account Settings:
| Setting | Purpose |
|---|---|
storeidentifier | Store name for ReCharge API (myperfectpetfood) |
storetoken | Storefront access token |
only_recharge | Bypass Shopify native account, use ReCharge portal |
select_plan | Default meal plan ratio (1 = Fully Fresh, 0.5 = Half Fresh, 0.15 = Topper) |
plan_type | Default purchase type: subscribe (standard) or trial |
Vue Components
ProductSelectPlan-- Plan selector on PDP (subscribe vs. one-time)Orders-- Customer order managementAccount-- Account portal wrapper
PDP Integration
The main-product.liquid section hides the ReCharge discount display element via a DOM script that monitors for .rc-option__discount and sets display: none.
Theme app embed and bundle
- The ReCharge theme app embed is enabled in
settings_data.jsonwith MPP colors (brand#5babb5, background#fbf7f5, square corners). theme.liquidoverrides one ReCharge button class (._1sdo9a25) to the coral brand color with white text.- The
accountVue component — the only code that imports@rechargeapps/storefront-client— is registered as an async component insrc/entrypoints/main.js, so the ReCharge client is split into its own chunk and only downloaded oncustomers/account.
Klaviyo
NPM Package
Package: klaviyo-subscribe v1.0.0
Newsletter Forms
The <Newsletter> Vue component wraps Klaviyo subscription. It is used in section-newsletter.liquid and accepts a listid prop tied to the global klaviyo_id setting.
Current list ID: XTs3NV
Where configured: Theme Settings > Klaviyo Email List > klaviyo_id
Where the forms are
| Form | File | Fields |
|---|---|---|
| Footer "Stay up to date" (every page) | shopify/sections/layout-footer.liquid | Email only (first/last name sent empty) |
| Newsletter section (page templates) | shopify/sections/section-newsletter.liquid | First name, last name, email (all required). Also renders headline, subheadline, description, closing message and a side image |
Both use the Newsletter Vue component with listid = klaviyo_id.
Klaviyo app embed
The Klaviyo onsite app embed (klaviyo-email-marketing-sms) is enabled in settings_data.json. theme.liquid also pushes an "Added to Cart" event to _learnq when the PDP add-to-cart button is clicked, for abandoned-cart flows.
Junip Reviews
Junip is integrated via script injection (not NPM). It provides two main features:
Product Reviews on PDP
Section: shopify/sections/junip-reviews.liquid
Renders the Junip review section widget with configurable layout:
| Setting | Options | Default |
|---|---|---|
layout | list / grid | list |
reviewsType | all / product_reviews / store_reviews | all |
showSummary | checkbox | true |
reviewsCount | range 2-20 | 10 |
Review Slider
Section: shopify/sections/section-reviews-junip.liquid
A custom Vue slider (<slider-reviews-junip>) that displays Junip reviews in a carousel. Configured with:
- Headline and subheadline
- Optional "More Happy Pet Parents" link button
- Pulls reviews by
product-idon PDP pages
Star Ratings on PLP
The collection page (main-collection.liquid) and related products section call window.__theme.junip.junipRating() on page load to render star ratings beneath product cards.
"Be the first to review" stars (fewer than 3 reviews)
When product.metafields.junip.rating_count is below 3, junip-product-plp.liquid (cards) and junip-product-summary.liquid (PDP) render snippets/junip-new-badge.liquid instead of the rating: five greyed-out stars linking to the Junip review form. The threshold is the min_reviews variable in those two snippets.
The review form needs Junip's own product ID. snippets/junip-new-badge-script.liquid, rendered once at the bottom of theme.liquid, swaps Shopify product IDs for Junip IDs through api.juniphq.com/v1/products. It batches up to 25 badges as they scroll into view, and looks one up on click if it hasn't been resolved yet. It uses the shop's Junip store key metafield; there is nothing to configure in the theme.
Write-a-Review Link
On the PDP, a "Write A Review" link dynamically fetches the product's Junip internal ID via the Junip API (api.juniphq.com/v1/products) and constructs the review submission URL.
Octane AI Quiz
The recipe recommendation quiz is embedded via Octane AI:
Section: shopify/sections/section-recipe-recommendation.liquidQuiz ID: 9Y7cgWSBZBVAHHvl (basic version)
Styled version: shopify/sections/section-recipe-recommendation-styled.liquidQuiz ID: 4s0A2eQ3iaBHxlLJ (custom-styled version with branded CSS overrides)
Script source: https://app.octaneai.com/4eb6fnio1y2zuz38/quiz.js
The styled version includes extensive CSS overrides for:
- Multiple choice grid layout (3 columns desktop, 2 mobile)
- Custom back button with SVG arrow
- Branded dropdown selects with dark blue borders
- Email capture step with background images (configurable via image_picker settings)
- Result page product card styling
Intelligems (A/B testing)
MPP runs A/B tests with Intelligems, including a theme split between Theme A (master) and Theme B (staging) — see Overview → Branches and themes.
- The Intelligems script is hard-coded in
theme.liquidhead(cdn.intelligems.io/esm/…/bundle.js, loaded as a render-blocking module withdata-em-disable). The Intelligems app embed insettings_data.jsonis disabled, so don't enable both. theme.liquidalso exposes data Intelligems uses for targeting, before the script loads:window.__productIdFromTemplateandwindow.__plpCollectionIdFromTemplatewindow.igProductData— on collection and product templates, one entry per product: ID, handle, tags, collection IDs, total inventory and lowest variant price.
Tests on Theme B
Anything described as "Theme B only" in these docs (for example the green "You save" savings in the cart and on the PDP) is an experiment running on the staging theme. It is not on the production branch (master, Theme A); it reaches Theme A only when the matching change is merged into master.
Pinpoint Store Locator
The store locator page uses the Pinpoint Store Locator app block (shopify://apps/pinpoint-store-locator/blocks/locator/…) in templates/page.custom-store-locator.json (map ID m_a8b3mndxgy). Locations are managed in the app. Setup, settings and the rest of the page: Vet & Quiz → Store Locator and the Pinpoint app docs.
Checkout Savings (checkout UI extension)
A custom checkout extension that shows subscription savings (free shipping per subscription unit + subscription price savings) at the first checkout step. The MPP theme doesn't write the _theme_id cart attribute, so the extension's Theme ID filter must stay blank on this store. The theme's shipping_cost setting and the extension's custom.shipping_cost shop metafield must be kept equal by hand. Details: Cart & Checkout → Checkout Savings extension · Checkout Savings app docs.
Pet Profile (customer accounts)
The Pet Profile customer-account extension (pet name, species, breed, birthday, photo stored as customer metafields) is not configured for My Perfect Pet — the app repo has no MPP app config (see the Pet Profile store table). The MPP theme has no Pet Profile code: the extension lives in Shopify's customer account pages, not in the theme, and no template reads the pet metafields. MPP login goes through the ReCharge-only flow (only_recharge), so check which account pages customers actually reach before relying on it.
Other scripts in theme.liquid
| Script | Purpose |
|---|---|
| Hotjar | Session recordings / heatmaps |
Google Ads tag (gtag.js) | Conversion tracking |
| Accessibility modal | Theme-native accesibility Vue component (footer button). No third-party accessibility app embed is used. |
Support contact links (footer Contact Us) go to the Gorgias help center.