Skip to content

Ark Naturals Theme ​

Overview ​

PropertyValue
Theme NameArk Naturals Pet Theme
Version2.0.0
Store URLarknaturals.com
BaseCustom (Shopify Foundation Theme / Theme Lab)

Ark Naturals is a brand under Alpine Pet Holdings focused on natural dental care for dogs — most notably the Brushless Toothpaste chew line and the clinically-proven Protection+ dental supplement.

The theme is built on the Shopify Foundation Theme framework (Vue 3 + Tailwind + Vite). It is a custom, single-brand storefront — not a marketplace umbrella like Antelope Pets — and is the public DTC site at arknaturals.com.

For content managers

Almost everything visible on the site can be edited from Shopify Admin → Online Store → Themes → Customize. The pages in this guide map one-to-one with what you see in the theme editor: every section has its own page here, and every editable field is listed with its label, where to find it, and what it does.

Architecture ​

Tech stack ​

  • Liquid templates rendered server-side by Shopify
  • Vue 3 reactive components mounted via vue directive on container divs (cart drawer, product form, carousels, modals, ingredient sliders, etc.)
  • Tailwind CSS 3.4 for styling, with custom font families (font-degular, font-avenirnext, font-avantgarde), see Fonts
  • Vite 6 for asset bundling (src/ → assets/)
  • Vuex for cart and product form state management
  • Keen Slider for carousels and rotating content
  • Fancybox for lightbox/modal galleries

Fonts ​

Tailwind classFont familyWhere it comes from
font-degulardegularAdobe Typekit kit qre3ate, loaded in layout/theme.liquid (https://use.typekit.net/qre3ate.css)
font-avantgardeitc-avant-garde-gothic-proSame Typekit kit. Used for the text inside linked-product size pills.
font-avenirnextavenir-nextSelf-hosted. src/fonts/AvenirNextCyr-{Regular,Medium,Demi,Bold}.woff2 (weights 400/500/600/700), declared in src/css/utils/typography.scss and bundled into assets/ by Vite
(accessibility only)DyslexicSelf-hosted src/fonts/open-dyslexic.ttf. Only applied when a visitor turns on Dyslexia-Friendly Font in the Accessibility drawer.

Directory structure ​

ark/
├── src/                     # Source JS, Vue components, CSS, fonts
│   ├── vue/components/      # Vue 3 components (Cart, ProductForm, IngredientsSlider, ...)
│   ├── entrypoints/         # Vite entry files
│   └── css/                 # Tailwind layers
├── assets/                  # Compiled CSS/JS bundles, images, SVGs
├── config/                  # settings_schema.json, settings_data.json
├── layout/                  # theme.liquid, password.liquid, gift_card.liquid
├── locales/                 # Translation files (en.default.json, ...)
├── sections/                # 50 section files
├── snippets/                # 115 snippets (blocks, helpers, icons, JSON-LD)
├── templates/               # JSON & Liquid templates per page type
│   └── customers/           # Liquid templates for account pages
├── vite.config.js
├── tailwind.config.js
└── package.json

Section naming conventions ​

PrefixPurposeExamples
layout-*Global layout (header / footer / announcement)layout-header, layout-footer, layout-announcement-bar
main-*Primary content of a templatemain-product, main-cart, main-collection, main-blog
section-home-*Homepage modulessection-home-hero, section-home-target, section-home-comparison
section-product-*PDP add-on sectionssection-product-ingredients, section-product-reviews, section-product-upgraded
section-clinical-*Protection+ clinical-trials page sectionssection-clinical-hero, section-clinical-questions, section-clinical-why-red
section-*Reusable content blockssection-banner, section-hero, section-newsletter, section-tabs, section-timer

Snippet conventions ​

PrefixPurpose
block-*Reusable UI blocks (badge, price, gallery, product form, breadcrumb)
brick-*Lower-level UI primitives composed inside blocks
helper-*Liquid/JS utility includes (menu rendering, ingredient ordering, theme JS bootstrap)
icon-*Inline SVG icons
json-*JSON-LD generators (product, variant, homepage, global) and JSON product feeds for Vue
junip-*Junip review summaries (PDP and PLP)
layout-*Page-level layout snippets (product, plp, blog article, account)
pf-*Product form sub-components (subscription selector, quantity, options)

Template architecture ​

Ark uses Shopify's JSON template system, which lets the theme editor build pages section-by-section. Several templates have named variants for product lines that need a different layout:

Product templates:

TemplatePurpose
product.jsonDefault product layout
product.breath-bursts.jsonBreath Bursts product line
product.extreme-clean.jsonExtreme Clean product line
product.pro-plus.jsonProtection+ (clinical) layout
product.pro-plus-alt.jsonAlternative Protection+ layout
product.v2.jsonSecondary product layout variant

Collection templates:

TemplatePurpose
collection.jsonDefault collection layout
collection.shop-cat.json"Shop" category collection
collection.v2.jsonAlternative collection layout

Page templates:

TemplatePurpose
page.jsonGeneric page
page.about-us.jsonAbout Us / brand story
page.account-login.jsonSubscription & account login portal
page.contact.jsonContact page
page.custom-store-locator.jsonStore locator (/pages/store-locator): Pinpoint app block + "Other Brands" tiles. See Store Locator.
page.protection-clinical-trials.jsonClinical evidence page for Protection+
page.waitlist.jsonProduct waitlist signup

Blog & search templates:

TemplateSectionPurpose
blog.jsonmain-blogBlog listing with tag pills, 8 posts per page. See Collection Pages → Blog.
article.jsonmain-articleSingle blog post with 3 related posts
search.jsonmain-searchSearch results: products and blog articles

Customer templates (Liquid):

The files in templates/customers/ (login.liquid, register.liquid, account.liquid, activate_account.liquid, reset_password.liquid, addresses.liquid, order.liquid) ship with the theme as a fallback but are not used live — Ark runs on Shopify's new customer accounts, which are hosted and rendered entirely by Shopify. See Account Pages.

Key features ​

  1. Brushless Toothpaste flagship line — Multiple PDP layouts for different formulas (Original, Extreme Clean, Breath Bursts, Protection+)
  2. Subscribe & Save — ReCharge-powered subscription option on every PDP with a configurable benefits spoiler
  3. Mini cart with upsell & free-shipping bar — Vue.js slide-out cart, upsell products, "you are $X away from free shipping" progress bar
  4. Ingredients explorer — Dedicated section that renders product ingredients in a Slider or Spoiler (accordion) layout, linked to a Shopify menu of ingredient definitions
  5. Clinical trials page — Dedicated Protection+ evidence page with clinical hero, "Why Is It Red?" Astaxanthin explainer, and FAQ
  6. Comparison table — Side-by-side homepage comparison of Ark vs. Traditional chews
  7. Junip Reviews — Star ratings and review counts on PDP and PLP, populated from Junip metafields
  8. Klaviyo newsletter — Footer signup form, popup integration, and a countdown-timer section with email-notify form
  9. Countdown timer — Site-launch / restock timer with deadline and email capture (disabled on the homepage)
  10. Gorgias support — Help center linked from the footer and account pages
  11. Cross-platform review totals — Stars and counts on the PDP, PLP cards and PLP header combine Junip with off-site reviews (Amazon, Chewy) from the reviews.* metafields. See Integrations → Blended reviews.
  12. Collapsed size families on the PLP — Products tagged plp-hidden don't get their own tile. They're reachable through the size pills of the family's main tile. See Collection Pages.
  13. Built-in accessibility drawer — Text size, contrast, dyslexia font, reduced motion and focus highlight, opened from the footer. See Layout Sections.
  14. Store locator — /pages/store-locator runs on our own Pinpoint Store Locator app, with an "Other Brands" tile row. See Store Locator.

Third-party apps ​

AppPurposeStatus
Junip ReviewsProduct reviews on PDP and PLPActive
KlaviyoEmail & SMS marketing, newsletter list VSYjCbActive
ReChargeSubscribe & Save subscriptionsActive
GorgiasCustomer support help deskActive (link only)
Pinpoint Store LocatorStore locator map on /pages/store-locator (our own app, see /apps/store-locator)Active

Deployment ​

The theme repo deploys itself through GitHub Actions (.github/workflows/):

WorkflowTriggerWhat it does
shopify-deploy.yml (Deploy to Shopify)Every push to masternpm ci --legacy-peer-deps → npm run build (Vite) → shopify theme push --allow-live to the store ark-naturals-pet, theme Live Theme (ID 160344473858). Posts a success/failure message to Slack.
shopify-sync.yml (Sync Shopify Dashboard Changes)Manual (workflow_dispatch)shopify theme pull from the live theme into master and commits "Sync Live Theme dashboard changes" if anything changed. Run it before merging so customizer edits made in the admin aren't overwritten.

Merging to master publishes to the live store

There is no staging step: a merged PR goes straight to the live theme. Theme-editor changes (template JSON, settings_data.json) made in the admin since the last sync will be overwritten unless you run the sync workflow first.

The live theme contains changes that are not in master

The live theme runs branch ant912: instant cart updates and the Other Brands tile links to each brand's store locator. master does not contain these changes. Merge ant912 into master before the next master deploy, otherwise the deploy overwrites them on the live theme.

Antelope Themes Documentation

Enter the password to access this site.