Skip to content

Custom Apps ​

Antelope Pets runs a small set of custom Shopify apps and services alongside the brand themes. Each page in this section covers what the app does, which stores and themes use it, where it is deployed, how merchants use it, and how developers update and deploy it.

At a glance ​

AppWhat it doesStoresDeployed toRepositoryUpdate with
Checkout SavingsCheckout UI extension: a green banner in the order summary that tells subscription buyers how much they save (free delivery + subscription price).My Perfect Pet, Super SnoutsShopify only (extension hosted by Shopify, no backend)crupko93/Checkout-Savings (master)npm run deploy
Pinpoint Store LocatorStore locator app used in place of Stockist: embedded admin (import/export, locations, settings), public JSON API, map widget as a theme app block.Ark Naturals, Bocce's Bakery, Super Snouts, My Perfect Pet, Poke's (Antelope Pets: installed, section disabled)Vercel store-locator (region cle1) + Supabase Postgres/PostGIS (us-east-2) + Shopify (theme app extension)crupko93/store-locator (main)Merge to main (Vercel); npm run deploy for widget/extension changes
Pet Profile"My pet" card on the customer account Profile page; saves name, species, breed, birthday and photo to customer metafields.Antelope PetsShopify (extensions) + Vercel pet-profilecrupko93/pet-profile (main)Push to main (Vercel); shopify app deploy --config <store> per store
Email Countdown TimerRenders animated countdown-timer GIFs for email campaigns (Klaviyo).Bocce's Bakery (bbv2, bb), My Perfect Pet (mpp)Vercel ant-timercrupko93/ant-timer (master)Merge to master (Vercel)
Recharge Account APIOne serverless endpoint that exchanges a Shopify customer-account session token for a Recharge customer session.Stores with credentials in the Vercel projectVercel recharge-account-api (region iad1)crupko93/recharge-account-api (master)Push to master (Vercel)

Architecture patterns ​

The apps follow three shapes. Knowing which one you are touching tells you what "deploy" means.

PatternAppsWhat ships where
Extension onlyCheckout SavingsCode is static frontend that Shopify hosts and runs sandboxed. There is no server. The only way to ship a change is shopify app deploy.
Stateless functions (+ extensions)Pet Profile, Recharge Account API, Email Countdown TimerServerless functions on Vercel with no database. Credentials live in Vercel environment variables. Shopify extensions (Pet Profile only) ship separately with shopify app deploy.
Full app with a databasePinpoint Store LocatorRemix app on Vercel with Postgres + PostGIS on Supabase. Admin and API ship with Vercel (git push). The storefront widget ships as a theme app extension with shopify app deploy.

Two ship pipelines exist, and they are independent:

  • Vercel deploys automatically from the production branch of each GitHub repo (main or master). Other branches get preview deployments.
  • Shopify (shopify app deploy) publishes extensions to the app record. It is never automatic. Run it from a developer machine with the Shopify CLI.

Which command do I run?

  • Changed something under extensions/? Run shopify app deploy (or npm run deploy).
  • Changed something under api/, app/, lib/ or prisma/ in a Vercel-hosted app? Merge to the production branch. Vercel redeploys.
  • Changed the Pinpoint widget (widget/src)? You need both. The widget is bundled into the theme extension.

Shopify app records ​

AppApp record nameHandleClient IDDistribution
Checkout SavingsCheckout Savings—c042c837a14ce46801cab5c8874f7eb5Custom distribution (Plus organization, multi-store install)
Pinpoint Store LocatorPinpoint Store Locatorpinpoint-locatorb1dfc7d10db437af215494874cbdbcf9Public (not listed on the App Store)
Pet Profile (Antelope)Antelope Pet Profile—a369f83585a7167a400a750f3eabcce9Custom distribution, one record per store
Pet Profile (dev)Antelope Pet Profile—4b650d1f153104e05f6f59642e18373fDevelopment store only

Email Countdown Timer and Recharge Account API have no Shopify app record.

Client IDs are public identifiers. Client secrets live only in the Shopify Dev Dashboard / Partner Dashboard and in Vercel environment variables. Never commit them.

Hosting overview ​

All four Vercel projects are in the Vercel team crupko93's projects.

ServiceVercel projectProduction URLProduction branchRegion
Pinpoint Store Locatorstore-locatorhttps://store-locator-eta.vercel.appmaincle1 (pinned in vercel.json)
Pet Profile functionspet-profilehttps://pet-profile-nine.vercel.appmainVercel default
Email Countdown Timerant-timerhttps://ant-timer.vercel.appmasterVercel default
Recharge Account APIrecharge-account-apihttps://recharge-account-api.vercel.appmasteriad1

Preview deployments of pet-profile, ant-timer and recharge-account-api are behind Vercel Authentication (log in to Vercel to open them). store-locator previews are public.

Antelope Themes Documentation

Enter the password to access this site.