Configuration requise
Ce qu'il faut installer avant de lancer votre pack, avec ou sans Docker.
Pour le pack Full Stack
Ce que contient chaque pack
| Pack | Applications incluses dans le téléchargement | Fonctionne seul |
|---|---|---|
| Full Stack | API, boutique, tableau de bord admin | Oui, les trois ensemble |
| Boutique | Boutique | Oui, sur une boutique d'exemple intégrée jusqu'à ce que vous connectiez l'API du template |
| Tableau de bord admin | Tableau de bord admin | Oui, sur une boutique d'exemple intégrée jusqu'à ce que vous connectiez l'API du template |
| API backend | API | Oui, en servant uniquement l'API |
Un pack à application unique n'inclut pas les autres applications. Les frontends peuvent utiliser une API que vous faites déjà tourner, mais le code de l'API ne se trouve que dans les packs Full Stack et API backend.
Avec Docker
- Docker Desktop sous macOS ou Windows, ou Docker Engine avec le plugin Compose sous Linux. Le pack Full Stack démarre avec une seule commande
docker compose. - Une connexion internet pour le premier build, qui télécharge les images de base et les dépendances.
- Rien d'autre : Docker fournit Node.js, et la base de données est un fichier SQLite dans un volume Docker.
Avec Docker
- Docker Desktop sous macOS ou Windows, ou Docker Engine sous Linux. Votre application a son propre
Dockerfile; Compose n'est pas nécessaire. - Une connexion internet pour le premier build, qui télécharge l'image de base et les dépendances.
Sans Docker
- Node.js 22 ou plus récent. Le template est testé sur Node.js 24, que ses images Docker utilisent aussi. La boutique seule fonctionne aussi sur Node.js 20.9.
- Yarn 4, via Corepack. Exécutez
corepack enableune fois ; chaque application fixe sa propre version de Yarn, doncyarnchoisit la bonne. Si votre Node.js n'a pas Corepack, installez-le d'abord avecnpm install -g corepack. - Aucun package global.
Base de données
Aucun serveur de base de données. L'API utilise SQLite par défaut et yarn seed crée le fichier pour vous ; Docker utilise aussi SQLite. MySQL est pris en charge par un changement de configuration, pas de code.
Ports
Chaque application écoute sur un port local fixe. Assurez-vous que rien d'autre ne les utilise ou, avec Docker, déplacez-en un avec SITE_PORT, ADMIN_PORT ou API_PORT dans un .env à côté de docker-compose.yml.
| Application | Port |
|---|---|
| API | 8000 |
| Boutique | 3030 |
| Tableau de bord admin | 3031 |
Port
La boutique écoute sur le port 3030. Assurez-vous que rien d'autre ne l'utilise.
Port
Le tableau de bord admin écoute sur le port 3031. Assurez-vous que rien d'autre ne l'utilise.
Port
L'API écoute sur le port 8000. Assurez-vous que rien d'autre ne l'utilise.
Une API à connecter
Rien n'est nécessaire pour essayer votre application : elle fonctionne sur sa propre boutique d'exemple. Pour utiliser des données réelles, elle a besoin de l'API du template en fonctionnement, dont vous indiquez l'adresse dans son .env. L'API est vendue comme un pack à part.
Services optionnels
Aucun de ces éléments n'est nécessaire pour lancer la boutique en local. Chacun s'active grâce à ses clés dans back-end/.env, et une clé laissée à sa valeur de .env.example compte comme non définie.
| Service | Sans lui |
|---|---|
| Cloudflare R2 ou un autre bucket compatible S3 | Les images de la boutique de démonstration sont servies depuis des copies livrées avec les deux frontends. L'envoi de nouvelles images répond 503 tant qu'aucun bucket n'est configuré. |
| Stripe | Aucun paiement par carte n'est encaissé : l'option carte du paiement indique que les paiements par carte sont indisponibles, et le paiement à la livraison fonctionne normalement. |
| Une clé Google AI (Gemini) | L'assistant du tableau de bord, le mode Assistant du studio (rédaction des détails du produit et retouches photo) et la cabine d'essayage de la boutique s'affichent comme désactivés. Le studio et la cabine d'essayage ont aussi besoin du bucket. |
| Une clé et un secret Higgsfield | Le mode Animate du studio, qui crée des vidéos de produit, s'affiche comme désactivé. |
| Le fichier du modèle de suppression d'arrière-plan | Le bouton « Remove background » du studio n'apparaît pas. Il tourne sur votre propre serveur, a besoin du bucket pour ses résultats et ne coûte rien par image. |