Ark Naturals Theme
Overview
| Property | Value |
|---|---|
| Theme Name | Ark Naturals Pet Theme |
| Version | 2.0.0 |
| Store URL | arknaturals.com |
| Base | Custom (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
vuedirective 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 class | Font family | Where it comes from |
|---|---|---|
font-degular | degular | Adobe Typekit kit qre3ate, loaded in layout/theme.liquid (https://use.typekit.net/qre3ate.css) |
font-avantgarde | itc-avant-garde-gothic-pro | Same Typekit kit. Used for the text inside linked-product size pills. |
font-avenirnext | avenir-next | Self-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) | Dyslexic | Self-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.jsonSection naming conventions
| Prefix | Purpose | Examples |
|---|---|---|
layout-* | Global layout (header / footer / announcement) | layout-header, layout-footer, layout-announcement-bar |
main-* | Primary content of a template | main-product, main-cart, main-collection, main-blog |
section-home-* | Homepage modules | section-home-hero, section-home-target, section-home-comparison |
section-product-* | PDP add-on sections | section-product-ingredients, section-product-reviews, section-product-upgraded |
section-clinical-* | Protection+ clinical-trials page sections | section-clinical-hero, section-clinical-questions, section-clinical-why-red |
section-* | Reusable content blocks | section-banner, section-hero, section-newsletter, section-tabs, section-timer |
Snippet conventions
| Prefix | Purpose |
|---|---|
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:
| Template | Purpose |
|---|---|
product.json | Default product layout |
product.breath-bursts.json | Breath Bursts product line |
product.extreme-clean.json | Extreme Clean product line |
product.pro-plus.json | Protection+ (clinical) layout |
product.pro-plus-alt.json | Alternative Protection+ layout |
product.v2.json | Secondary product layout variant |
Collection templates:
| Template | Purpose |
|---|---|
collection.json | Default collection layout |
collection.shop-cat.json | "Shop" category collection |
collection.v2.json | Alternative collection layout |
Page templates:
| Template | Purpose |
|---|---|
page.json | Generic page |
page.about-us.json | About Us / brand story |
page.account-login.json | Subscription & account login portal |
page.contact.json | Contact page |
page.custom-store-locator.json | Store locator (/pages/store-locator): Pinpoint app block + "Other Brands" tiles. See Store Locator. |
page.protection-clinical-trials.json | Clinical evidence page for Protection+ |
page.waitlist.json | Product waitlist signup |
Blog & search templates:
| Template | Section | Purpose |
|---|---|---|
blog.json | main-blog | Blog listing with tag pills, 8 posts per page. See Collection Pages → Blog. |
article.json | main-article | Single blog post with 3 related posts |
search.json | main-search | Search 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
- Brushless Toothpaste flagship line — Multiple PDP layouts for different formulas (Original, Extreme Clean, Breath Bursts, Protection+)
- Subscribe & Save — ReCharge-powered subscription option on every PDP with a configurable benefits spoiler
- Mini cart with upsell & free-shipping bar — Vue.js slide-out cart, upsell products, "you are $X away from free shipping" progress bar
- Ingredients explorer — Dedicated section that renders product ingredients in a Slider or Spoiler (accordion) layout, linked to a Shopify menu of ingredient definitions
- Clinical trials page — Dedicated Protection+ evidence page with clinical hero, "Why Is It Red?" Astaxanthin explainer, and FAQ
- Comparison table — Side-by-side homepage comparison of Ark vs. Traditional chews
- Junip Reviews — Star ratings and review counts on PDP and PLP, populated from Junip metafields
- Klaviyo newsletter — Footer signup form, popup integration, and a countdown-timer section with email-notify form
- Countdown timer — Site-launch / restock timer with deadline and email capture (disabled on the homepage)
- Gorgias support — Help center linked from the footer and account pages
- 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. - Collapsed size families on the PLP — Products tagged
plp-hiddendon't get their own tile. They're reachable through the size pills of the family's main tile. See Collection Pages. - Built-in accessibility drawer — Text size, contrast, dyslexia font, reduced motion and focus highlight, opened from the footer. See Layout Sections.
- Store locator —
/pages/store-locatorruns on our own Pinpoint Store Locator app, with an "Other Brands" tile row. See Store Locator.
Third-party apps
| App | Purpose | Status |
|---|---|---|
| Junip Reviews | Product reviews on PDP and PLP | Active |
| Klaviyo | Email & SMS marketing, newsletter list VSYjCb | Active |
| ReCharge | Subscribe & Save subscriptions | Active |
| Gorgias | Customer support help desk | Active (link only) |
| Pinpoint Store Locator | Store 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/):
| Workflow | Trigger | What it does |
|---|---|---|
shopify-deploy.yml (Deploy to Shopify) | Every push to master | npm 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.