Country Cluster – Shopify Theme Extension

Show shoppers a short list of peer countries (same continent) using a Cloudflare-edge lookup.

Worker repo: https://github.com/ekimbasoglu/geo-locale-worker

Shopify Demo: https://country-cluster-demo.myshopify.com password: test

---

📸 Demo

Screen.Recording.2025-07-08.at.16.04.27.mov

---

🔧 What’s inside

Folder	Purpose
extensions/country-cluster/	Theme-app extension (Liquid + JS + locales)
shopify.app.toml	App manifest – client ID only (no secrets)

The Cloudflare Worker that powers the API lives in a separate repo (linked above) to keep secrets and deployment history isolated.

---

🚀 Quick start

git clone https://github.com/ekimbasoglu/country-cluster
cd country-cluster

# 1. Set up Shopify credentials
cp .env.example .env          # fill in API secret, scopes, etc.

# 2. Run the app in a dev store
shopify app dev --store <my-dev-store>.myshopify.com