Kona

Toute boutique Shopify en ligne publie son catalogue en JSON brut, sur le même hôte que sa vitrine et sans authentification : /products.json, /collections.json, /collections/rayon/products.json. Ce sont les fichiers que lisent déjà les thèmes Liquid officiels, servis depuis dix ans. Kona les lit au moment du build, depuis un serveur, et produit du HTML statique.

Donc aucune application à installer, aucun jeton Storefront, aucune requête GraphQL, aucune permission à accorder, aucun thème Liquid à modifier. La seule valeur dont Kona a besoin est SHOPIFY_STORE_URL, l'adresse de votre vitrine. Vous vendez le site à un client sans jamais demander son admin. Collez par erreur l'adresse de l'admin et le thème la convertit : cette erreur répond 200 en HTML, donc rien d'autre ne la rattrape.

Les collections deviennent les rayons, les options deviennent les filtres, et chaque déclinaison garde son prix et sa disponibilité. Les photographies viennent du CDN Shopify, redimensionnées par lui. Le panier vit dans le navigateur et retient trois choses par ligne : produit, déclinaison, quantité. Au paiement, ces lignes deviennent un lien de caisse Shopify natif, et l'acheteur arrive sur votre caisse avec vos moyens de paiement et vos applications. Kona n'encaisse rien, ne détient aucun secret et ne voit aucune carte.

Trois choses que le JSON public ne porte pas, et que Kona n'invente pas. La devise, réglée une fois dans le thème et confirmée auprès de la boutique par pnpm shopify:check. Les quantités exactes en stock : le thème dit disponible ou épuisé, jamais qu'il en reste deux. Les avis, qui vivent dans une application, donc aucune note agrégée n'est écrite.

Laissez SHOPIFY_STORE_URL vide et Kona sert son catalogue de démonstration hors ligne : huit produits qui couvrent des options croisées, un prix barré, une déclinaison épuisée dans un produit disponible, deux rayons qui se recoupent. On décompresse, on installe, on lance : la boutique est à l'écran avant tout branchement. Ensuite, pnpm shopify:check lit un vrai magasin en une commande et rapporte ce que son JSON public répond : produits, déclinaisons, lien de caisse, devise déclarée. Il ne construit rien et tourne en Node simple : un commerçant peut tester sa boutique avant d'acheter.

Le catalogue est figé au moment du build. Ajoutez un produit dans Shopify et il n'est sur la vitrine qu'après une reconstruction ; c'est vrai aussi d'un prix ou d'une déclinaison qui vient de s'épuiser. C'est le prix du HTML statique, et une page qui n'énumère que des avantages ne se lit pas.

La réponse est une reconstruction que personne n'a à déclencher : un crochet de déploiement chez votre hébergeur, appelé par un webhook Shopify quand un produit change, ou programmée. Kona ne fournit ni l'un ni l'autre : les deux appartiennent à l'hébergeur, pas à un thème. La disponibilité est le point à peser le plus sérieusement : entre deux builds, la vitrine peut encore proposer une déclinaison épuisée, et l'acheteur l'apprend à la caisse.