Pourquoi le headless ?
Quand Kafarnaom m'a contacté pour créer sa boutique en ligne, il y avait deux contraintes fortes : un site rapide avec un design 100% sur mesure, et un gérant non-technique qui devait pouvoir administrer ses produits, commandes et stocks seul au quotidien. Un site entièrement custom aurait été ingérable pour lui, et un WordPress classique limitait trop la performance et le design.
Le headless résolvait les deux problèmes d'un coup.
L'architecture choisie
Architecture headless : WordPress/WooCommerce en backend pour la gestion (interface familière, pas de formation nécessaire), et Next.js en frontend pour le site visiteur. Cette séparation offre :
- Autonomie du gérant : L'interface WooCommerce reste accessible — ajout de produits, suivi des commandes, gestion des stocks, sans toucher au code
- Performance : Le SSR/SSG de Next.js génère des pages ultra-rapides (score Lighthouse 98/100)
- Flexibilité design : Liberté totale sur le rendu, sans les contraintes des thèmes WordPress
- SEO natif : Next.js gère le rendu serveur et les balises meta nativement
Les défis rencontrés
Le principal défi a été l'intégration du panier et du checkout. En mode headless, WooCommerce n'a pas de frontend — il faut tout reconstruire. J'ai utilisé l'API REST WooCommerce pour :
- Récupérer le catalogue produits (avec cache côté Next.js)
- Gérer le panier côté client avec un state React
- Envoyer la commande via l'API au moment du checkout
- Synchroniser les stocks en temps réel
Un autre défi était la gestion des images. WooCommerce stocke les images dans WordPress, mais Next.js a besoin de les optimiser. J'ai mis en place un système de proxy d'images avec le composant next/image pour bénéficier de l'optimisation automatique.
Les résultats
- Score Lighthouse : 98/100
- Temps de chargement : <1.5s
- Le site a été livré en 3 semaines
- Le gérant gère sa boutique en autonomie depuis le lancement
Ce que j'en retiens
Le headless n'est pas pour tous les projets — il ajoute de la complexité. Mais quand le client a besoin à la fois d'un site sur mesure et d'une interface d'administration simple, c'est la meilleure solution. Le gérant de Kafarnaom n'a jamais eu besoin de moi pour gérer sa boutique au quotidien, et c'était exactement l'objectif.