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
| App | What it does | Stores | Deployed to | Repository | Update with |
|---|---|---|---|---|---|
| Checkout Savings | Checkout 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 Snouts | Shopify only (extension hosted by Shopify, no backend) | crupko93/Checkout-Savings (master) | npm run deploy |
| Pinpoint Store Locator | Store 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 Pets | Shopify (extensions) + Vercel pet-profile | crupko93/pet-profile (main) | Push to main (Vercel); shopify app deploy --config <store> per store |
| Email Countdown Timer | Renders animated countdown-timer GIFs for email campaigns (Klaviyo). | Bocce's Bakery (bbv2, bb), My Perfect Pet (mpp) | Vercel ant-timer | crupko93/ant-timer (master) | Merge to master (Vercel) |
| Recharge Account API | One serverless endpoint that exchanges a Shopify customer-account session token for a Recharge customer session. | Stores with credentials in the Vercel project | Vercel 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.
| Pattern | Apps | What ships where |
|---|---|---|
| Extension only | Checkout Savings | Code 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 Timer | Serverless 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 database | Pinpoint Store Locator | Remix 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 (
mainormaster). 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/? Runshopify app deploy(ornpm run deploy). - Changed something under
api/,app/,lib/orprisma/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
| App | App record name | Handle | Client ID | Distribution |
|---|---|---|---|---|
| Checkout Savings | Checkout Savings | — | c042c837a14ce46801cab5c8874f7eb5 | Custom distribution (Plus organization, multi-store install) |
| Pinpoint Store Locator | Pinpoint Store Locator | pinpoint-locator | b1dfc7d10db437af215494874cbdbcf9 | Public (not listed on the App Store) |
| Pet Profile (Antelope) | Antelope Pet Profile | — | a369f83585a7167a400a750f3eabcce9 | Custom distribution, one record per store |
| Pet Profile (dev) | Antelope Pet Profile | — | 4b650d1f153104e05f6f59642e18373f | Development 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.
| Service | Vercel project | Production URL | Production branch | Region |
|---|---|---|---|---|
| Pinpoint Store Locator | store-locator | https://store-locator-eta.vercel.app | main | cle1 (pinned in vercel.json) |
| Pet Profile functions | pet-profile | https://pet-profile-nine.vercel.app | main | Vercel default |
| Email Countdown Timer | ant-timer | https://ant-timer.vercel.app | master | Vercel default |
| Recharge Account API | recharge-account-api | https://recharge-account-api.vercel.app | master | iad1 |
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.