create-wp-reactor 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# create-wp-reactor
+
+## 0.2.0
+
+### Minor
+
+- Stack dev local : `docker-compose.dev.yml` (WordPress image base + MariaDB +
+  Redis, thème enfant bind-monté) + `bootstrap.sh` + scripts `pnpm docker:*`.
+- Docs déploiement : `docs/deploy.md` (procédure Coolify ordonnée + Cloudflare),
+  `docs/environment.md` (variables local / GitHub / Coolify), `docs/traefik-labels.md`.
+- Script de purge edge Cloudflare (`scripts/clear-cache.mjs`) en post-deploy.
+- Renommage `GA_FRONTEND_URL` → `FRONTEND_URL` dans les templates.
+
+### Patch
+
+- Fix : le `Dockerfile` de la webapp cliente était absent du repo généré
+  (effacé par le sync). Déplacé dans le starter → porté correctement au scaffold.
+
+## 0.1.0
+
+- Première publication. Scaffolder de repo client mince : `npm create wp-reactor <nom>`.

package/README.md

@@ -0,0 +1,41 @@
+# create-wp-reactor
+
+Scaffolder de repo client **WP Reactor** — un framework headless WordPress
+(kernel TanStack Start + modules commerce/auth/editorial + générateur de blocs).
+
+```bash
+npm create wp-reactor@latest mon-client
+# ou : pnpm create wp-reactor mon-client
+# ou : npx create-wp-reactor mon-client
+```
+
+Génère un monorepo client « 2 mondes » :
+
+```
+apps/webapp/                 coque TanStack Start (deps @wp-reactor/* publiées)
+apps/wordpress/theme-<nom>/  thème ENFANT (branding + blocs propres)
+docker-compose.dev.yml       stack dev local (WordPress + DB + Redis)
+.github/workflows/deploy.yml CI réutilisable du framework (GHCR → Coolify)
+docs/                        deploy.md, environment.md, traefik-labels.md
+```
+
+## Options
+
+```
+create-wp-reactor <nom> [--dir <path>] [--namespace <ns>]
+```
+
+- `--dir` : dossier cible (défaut : `<nom>` dans le cwd).
+- `--namespace` : namespace des blocs Gutenberg (défaut : `<nom>` sans tirets).
+
+## Après génération
+
+Les packages runtime `@wp-reactor/*` sont sur **GitHub Packages** (privé) →
+authentifie-toi avant `pnpm install` :
+
+```bash
+echo "//npm.pkg.github.com/:_authToken=<PAT read:packages>" >> ~/.npmrc
+cd mon-client && pnpm install && pnpm dev
+```
+
+Voir le `README.md` et `docs/` du repo généré pour le dev Docker et le déploiement.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-wp-reactor",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"type": "module",
 	"description": "Scaffolder de repo client mince WP Reactor : émet apps/webapp (depuis le starter) + thème enfant + CI réutilisable + docker. Usage : npm create wp-reactor <nom>.",
 	"bin": {
@@ -12,7 +12,8 @@
 	"files": [
 		"dist",
 		"bin",
-		"templates"
+		"templates",
+		"CHANGELOG.md"
 	],
 	"scripts": {
 		"sync": "node scripts/sync-template.mjs",

package/templates/client/.env.example

@@ -1,5 +1,23 @@
-# Webapp (bakées au build Vite)
-VITE_WORDPRESS_URL=https://__PROJECT_NAME__-wp.example.com
+# Copie ce fichier en `.env` (gitignored). Doc complète : docs/environment.md
+# Sert au stack dev local (docker-compose.dev.yml) + `pnpm dev`.
+
+# --- WordPress local (docker-compose.dev.yml) ---
+WP_PORT=8890
+WP_HOME=http://localhost:8890
+FRONTEND_URL=http://localhost:3000
+WORDPRESS_DB_NAME=wordpress
+WORDPRESS_DB_USER=wordpress
+WORDPRESS_DB_PASSWORD=wordpress
+MYSQL_ROOT_PASSWORD=root
+
+# --- Provisioning (wp-bootstrap, profil tools) ---
+WP_SITE_TITLE=__PROJECT_TITLE__
+WP_ADMIN_USER=admin
+WP_ADMIN_PASSWORD=admin
+WP_ADMIN_EMAIL=admin@example.com
+
+# --- Webapp (bakées au build Vite / lues par `pnpm dev`) ---
+VITE_WORDPRESS_URL=http://localhost:8890
 VITE_GRAPHQL_PATH=/graphql
 VITE_FEATURE_EDITORIAL=true
 VITE_FEATURE_ECOMMERCE=true

package/templates/client/README.md

@@ -6,8 +6,11 @@ Repo client **WP Reactor** (framework headless WordPress) — monorepo léger «
 apps/webapp/                 coque TanStack Start (deps @wp-reactor/* publiées)
 apps/wordpress/theme-__PROJECT_NAME__/   thème ENFANT (branding + blocs propres)
 apps/wordpress/Dockerfile    image WP = base framework + thème enfant overlayé
+docker-compose.dev.yml       stack dev local (WordPress + DB + Redis)
 .github/workflows/deploy.yml appelle les workflows réutilisables du framework
 wp-reactor.config.json       config gen-block (namespace, chemins)
+docs/environment.md          où va chaque variable (local / GitHub / Coolify)
+docs/traefik-labels.md       labels Traefik à coller dans Coolify
 ```
 
 ## Prérequis
@@ -19,14 +22,27 @@ Authentifie-toi avant `pnpm install` :
 echo "//npm.pkg.github.com/:_authToken=<PAT read:packages>" >> ~/.npmrc
 ```
 
-## Dev
+## Dev rapide (Docker)
+
+WordPress (image base framework) + DB + Redis en conteneurs, webapp sur l'hôte.
 
 ```bash
+# L'image WordPress base est privée (GHCR) → login une fois :
+echo <PAT read:packages> | docker login ghcr.io -u <user> --password-stdin
+
 pnpm install
-cp .env.example .env   # renseigne VITE_WORDPRESS_URL, SESSION_SECRET…
-pnpm dev               # webapp sur :3000
+cp .env.example .env            # ajuste si besoin
+
+pnpm docker:up                  # WordPress + DB + Redis
+pnpm docker:bootstrap           # install WP + plugins GraphQL + thème enfant
+pnpm dev                        # webapp sur http://localhost:3000
 ```
 
+WordPress (admin / GraphQL) : `http://localhost:8890` (cf `WP_PORT`).
+Arrêt : `pnpm docker:down` — remise à zéro (volumes) : `pnpm docker:reset`.
+
+> Détail des variables d'environnement : **[`docs/environment.md`](docs/environment.md)**.
+
 ## Générer un bloc
 
 ```bash
@@ -36,5 +52,8 @@ pnpm gen:block schemas/<slug>.json   # écrit thème enfant + renderer webapp +
 ## Déploiement
 
 Push sur `main` → `.github/workflows/deploy.yml` build+push les images webapp & WordPress
-sur GHCR via les workflows réutilisables du framework, puis déclenche Coolify (secrets
-`COOLIFY_*` requis).
+sur GHCR via les workflows réutilisables du framework, puis déclenche Coolify.
+
+- **Procédure ordonnée + Cloudflare** : **[`docs/deploy.md`](docs/deploy.md)**
+- **Variables / secrets** (GitHub Actions + Coolify) : **[`docs/environment.md`](docs/environment.md)**
+- **Labels Traefik** à coller dans l'UI Coolify : **[`docs/traefik-labels.md`](docs/traefik-labels.md)**

package/templates/client/apps/webapp/Dockerfile

@@ -0,0 +1,40 @@
+# syntax=docker/dockerfile:1.7
+# Build de la coque webapp. Les @wp-reactor/* sont tirés depuis GitHub Packages
+# (cf .npmrc) — passer NODE_AUTH_TOKEN (read:packages) au build.
+#
+# NB : ce Dockerfile est un artefact de TEMPLATE (porté dans le repo client par
+# le scaffolder, qui substitue __PROJECT_NAME__). Le contexte de build = racine
+# du repo client.
+FROM node:22-alpine AS base
+WORKDIR /app
+ENV CI=true DO_NOT_TRACK=1
+RUN corepack enable && corepack prepare pnpm@11.3.0 --activate
+
+FROM base AS build
+ARG NODE_AUTH_TOKEN
+ARG VITE_WORDPRESS_URL
+ARG VITE_GRAPHQL_PATH
+ARG VITE_FEATURE_EDITORIAL
+ARG VITE_FEATURE_ECOMMERCE
+ARG VITE_FEATURE_AUTH
+ARG SESSION_SECRET
+ENV VITE_WORDPRESS_URL=${VITE_WORDPRESS_URL} \
+	VITE_GRAPHQL_PATH=${VITE_GRAPHQL_PATH} \
+	VITE_FEATURE_EDITORIAL=${VITE_FEATURE_EDITORIAL} \
+	VITE_FEATURE_ECOMMERCE=${VITE_FEATURE_ECOMMERCE} \
+	VITE_FEATURE_AUTH=${VITE_FEATURE_AUTH} \
+	SESSION_SECRET=${SESSION_SECRET}
+COPY . .
+RUN printf '//npm.pkg.github.com/:_authToken=%s\n' "${NODE_AUTH_TOKEN}" >> .npmrc \
+	&& pnpm install --frozen-lockfile \
+	&& pnpm --filter @__PROJECT_NAME__/webapp build \
+	&& rm -f .npmrc
+
+FROM node:22-alpine AS runner
+RUN apk add --no-cache curl
+WORKDIR /app/apps/webapp
+COPY --from=build /app/apps/webapp/.output ./.output
+# Scripts ops (ex. purge Cloudflare en post-deployment Coolify).
+COPY --from=build /app/apps/webapp/scripts ./scripts
+EXPOSE 3000
+CMD ["node", ".output/server/index.mjs"]

package/templates/client/apps/webapp/scripts/clear-cache.mjs

@@ -0,0 +1,45 @@
+// Purge complète du cache Cloudflare de la zone webapp.
+//
+// Lancé en "Post-deployment command" Coolify (après le health check, donc une
+// fois le nouveau conteneur live) :
+//   node scripts/clear-cache.mjs
+//
+// Pourquoi : un redeploy ne vide pas le cache edge → l'ancien HTML caché
+// référence des assets hashés disparus (404 CSS/JS). On purge pour que le 1er
+// visiteur reconstruise le cache sur le nouveau build.
+//
+// Env requis (Coolify → Environment Variables de l'app webapp) :
+//   CF_ZONE_ID    — Zone ID Cloudflare de la zone du front
+//   CF_API_TOKEN  — token scopé `Zone → Cache Purge → Purge` sur cette zone
+// Si l'un manque, la purge est ignorée (exit 0) — déploiement non bloqué.
+
+const zoneId = process.env.CF_ZONE_ID;
+const apiToken = process.env.CF_API_TOKEN;
+
+if (!zoneId || !apiToken) {
+	console.warn("[clear-cache] CF_ZONE_ID/CF_API_TOKEN absent — purge ignorée.");
+	process.exit(0);
+}
+
+try {
+	const res = await fetch(
+		`https://api.cloudflare.com/client/v4/zones/${zoneId}/purge_cache`,
+		{
+			method: "POST",
+			headers: {
+				Authorization: `Bearer ${apiToken}`,
+				"Content-Type": "application/json",
+			},
+			body: JSON.stringify({ purge_everything: true }),
+		},
+	);
+	const json = await res.json();
+	if (!json.success) {
+		console.error("[clear-cache] échec:", JSON.stringify(json.errors ?? json));
+		process.exit(1);
+	}
+	console.log("[clear-cache] cache Cloudflare purgé ✅");
+} catch (err) {
+	console.error("[clear-cache] erreur:", err);
+	process.exit(1);
+}

package/templates/client/apps/wordpress/docker/bootstrap.sh

@@ -0,0 +1,43 @@
+#!/bin/sh
+set -eu
+# Provisioning WordPress local : install core + plugins GraphQL headless +
+# active le thème enfant. Idempotent (relançable sans casse).
+WP_PATH="/var/www/html"
+WP="wp --path=$WP_PATH --allow-root"
+
+echo "→ Attente du core WordPress…"
+for _ in $(seq 1 60); do
+  [ -f "$WP_PATH/wp-includes/version.php" ] && break
+  sleep 2
+done
+
+if [ ! -f "$WP_PATH/wp-config.php" ]; then
+  $WP config create \
+    --dbname="$WORDPRESS_DB_NAME" \
+    --dbuser="$WORDPRESS_DB_USER" \
+    --dbpass="$WORDPRESS_DB_PASSWORD" \
+    --dbhost="db" --skip-check
+fi
+
+if ! $WP core is-installed >/dev/null 2>&1; then
+  echo "→ Installation de WordPress…"
+  $WP core install \
+    --url="$WP_HOME" --title="$WP_SITE_TITLE" \
+    --admin_user="$WP_ADMIN_USER" --admin_password="$WP_ADMIN_PASSWORD" \
+    --admin_email="$WP_ADMIN_EMAIL" --skip-email
+fi
+
+$WP option update home "$WP_HOME"
+$WP option update siteurl "$WP_HOME"
+
+echo "→ Plugins GraphQL headless…"
+$WP plugin install wp-graphql --activate
+# Expose editorBlocks (+ attributs) consommés par @wp-reactor/editorial.
+$WP plugin install https://github.com/wpengine/wp-graphql-content-blocks/archive/refs/heads/main.zip --activate || true
+# Plugin headless (baké dans l'image base) : activer s'il est présent.
+$WP plugin activate wp-reactor-headless || true
+
+echo "→ Thème enfant ${CHILD_THEME}…"
+$WP theme activate "$CHILD_THEME" || echo "  (thème ${CHILD_THEME} pas encore prêt, ignoré)"
+
+echo "✓ Bootstrap terminé — $WP_HOME"

package/templates/client/docker-compose.dev.yml

@@ -0,0 +1,93 @@
+# =============================================================================
+# Stack DEV local __PROJECT_TITLE__ — démarrage rapide.
+# -----------------------------------------------------------------------------
+# WordPress = image BASE du framework (ghcr.io/wp-reactor/wordpress-base, qui
+# bake le thème parent + plugin). Le thème ENFANT est bind-monté en live pour
+# l'éditer sans rebuild. La webapp tourne séparément sur l'hôte (`pnpm dev`,
+# port 3000) — la plus rapide en dev (HMR).
+#
+# Prérequis : l'image base est PRIVÉE (GHCR) → s'authentifier une fois :
+#   echo <PAT read:packages> | docker login ghcr.io -u <user> --password-stdin
+#
+# Démarrage :
+#   cp .env.example .env        # ajuste si besoin
+#   docker compose -f docker-compose.dev.yml up -d
+#   docker compose -f docker-compose.dev.yml --profile tools run --rm wp-bootstrap
+#   pnpm dev                    # webapp sur http://localhost:3000
+# WordPress (admin/GraphQL) : http://localhost:${WP_PORT}
+# =============================================================================
+name: __PROJECT_NAME__-dev
+
+services:
+  db:
+    image: mariadb:11
+    environment:
+      MARIADB_DATABASE: ${WORDPRESS_DB_NAME}
+      MARIADB_USER: ${WORDPRESS_DB_USER}
+      MARIADB_PASSWORD: ${WORDPRESS_DB_PASSWORD}
+      MARIADB_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+    volumes:
+      - db_data:/var/lib/mysql
+    healthcheck:
+      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
+      interval: 5s
+      timeout: 5s
+      retries: 20
+
+  redis:
+    image: redis:7-alpine
+
+  wordpress:
+    image: ghcr.io/wp-reactor/wordpress-base:latest
+    depends_on:
+      db:
+        condition: service_healthy
+      redis:
+        condition: service_started
+    ports:
+      - "${WP_PORT}:80"
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_NAME: ${WORDPRESS_DB_NAME}
+      WORDPRESS_DB_USER: ${WORDPRESS_DB_USER}
+      WORDPRESS_DB_PASSWORD: ${WORDPRESS_DB_PASSWORD}
+      # Lues par la config bakée (wp-reactor-config.php via auto_prepend_file).
+      WP_HOME: ${WP_HOME}
+      WP_SITEURL: ${WP_HOME}
+      WP_ENVIRONMENT_TYPE: local
+      WP_REDIS_HOST: redis
+      FRONTEND_URL: ${FRONTEND_URL}
+      WP_DEBUG: "true"
+      GRAPHQL_DEBUG: "true"
+    volumes:
+      - wp_data:/var/www/html
+      # Thème ENFANT bind-monté en live (le parent + plugin viennent de l'image base).
+      - ./apps/wordpress/theme-__PROJECT_NAME__:/var/www/html/wp-content/themes/__PROJECT_NAME__
+
+  wp-bootstrap:
+    image: wordpress:cli-php8.4
+    profiles: ["tools"]
+    user: "33:33"
+    depends_on:
+      db:
+        condition: service_healthy
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_NAME: ${WORDPRESS_DB_NAME}
+      WORDPRESS_DB_USER: ${WORDPRESS_DB_USER}
+      WORDPRESS_DB_PASSWORD: ${WORDPRESS_DB_PASSWORD}
+      WP_HOME: ${WP_HOME}
+      WP_SITE_TITLE: ${WP_SITE_TITLE}
+      WP_ADMIN_USER: ${WP_ADMIN_USER}
+      WP_ADMIN_PASSWORD: ${WP_ADMIN_PASSWORD}
+      WP_ADMIN_EMAIL: ${WP_ADMIN_EMAIL}
+      CHILD_THEME: __PROJECT_NAME__
+    volumes:
+      - wp_data:/var/www/html
+      - ./apps/wordpress/theme-__PROJECT_NAME__:/var/www/html/wp-content/themes/__PROJECT_NAME__
+      - ./apps/wordpress/docker/bootstrap.sh:/bootstrap.sh:ro
+    entrypoint: ["sh", "/bootstrap.sh"]
+
+volumes:
+  db_data:
+  wp_data:

package/templates/client/docs/deploy.md

@@ -0,0 +1,105 @@
+# Déploiement Coolify — procédure ordonnée
+
+Deux **applications Coolify autonomes** par environnement : `__PROJECT_NAME__-wordpress`
+et `__PROJECT_NAME__-webapp`. Chacune tire son image GHCR construite par
+`.github/workflows/deploy.yml` (push sur `main`). Variables d'env : voir
+[`environment.md`](./environment.md) ; labels Traefik : [`traefik-labels.md`](./traefik-labels.md).
+
+## Prérequis (une fois)
+
+1. **GHCR accessible par Coolify** : les images sont privées. Dans Coolify →
+   *Sources / Registries*, ajouter `ghcr.io` avec un PAT `read:packages`.
+2. **DNS** chez Cloudflare : `__PROJECT_NAME__.example.com` (front) et
+   `wp.__PROJECT_NAME__.example.com` (WordPress) → IP du serveur Coolify, **proxy activé**
+   (nuage orange) pour le front, **DNS-only** (nuage gris) pour WordPress
+   (l'admin/GraphQL ne doit pas passer par le cache edge).
+3. **Secrets GitHub Actions** renseignés (cf [`environment.md`](./environment.md) §2).
+
+## Ordre de déploiement (1er provisioning)
+
+> L'ordre compte : WordPress doit exister et répondre avant que la webapp (SSR)
+> ne l'interroge.
+
+### 1. App WordPress
+
+1. Coolify → *New Resource* → *Docker Image* → `ghcr.io/<owner>/<repo>/wordpress:main`.
+2. **Network** : réseau `coolify`. Ajouter un *Network Alias*
+   `__PROJECT_NAME__-wordpress-internal` (résolu par la webapp en SSR via `WORDPRESS_INTERNAL_URL`).
+3. **Environment Variables** : section *App WordPress* de [`environment.md`](./environment.md).
+4. **Labels** Traefik : bloc WordPress de [`traefik-labels.md`](./traefik-labels.md).
+5. **Persistent Storage** : volume sur `/var/www/html` (conserve core, uploads, plugins tiers).
+6. Déployer. Vérifier `https://wp.__PROJECT_NAME__.example.com/wp-admin` et `/graphql`.
+
+### 2. Provisioning WordPress (wp-cli, une fois)
+
+Installer DB + plugins GraphQL + activer le thème enfant. Depuis le serveur (ou un
+job Coolify ponctuel), avec accès à la même DB/volume :
+
+```bash
+# active wp-graphql + wp-graphql-content-blocks, thème enfant __PROJECT_NAME__
+wp plugin install wp-graphql --activate
+wp theme activate __PROJECT_NAME__
+```
+
+### 3. App Webapp
+
+1. Coolify → *New Resource* → *Docker Image* → `ghcr.io/<owner>/<repo>/webapp:main`.
+2. **Network** : réseau `coolify` (pour résoudre `__PROJECT_NAME__-wordpress-internal`).
+3. **Environment Variables** : section *App Webapp* de [`environment.md`](./environment.md)
+   (dont `WORDPRESS_INTERNAL_URL=http://__PROJECT_NAME__-wordpress-internal`, `SESSION_SECRET`,
+   `CF_ZONE_ID`, `CF_API_TOKEN`).
+4. **Labels** Traefik : bloc Webapp de [`traefik-labels.md`](./traefik-labels.md).
+5. **Post-deployment command** : `node scripts/clear-cache.mjs` (purge Cloudflare, cf §Cloudflare).
+6. Déployer. Vérifier `https://__PROJECT_NAME__.example.com`.
+
+## Déploiements suivants (automatiques)
+
+Push sur `main` → `deploy.yml` build+push les images puis appelle l'API Coolify
+(`COOLIFY_*`) pour redéployer. La **post-deployment command** purge le cache edge.
+Rien à faire manuellement.
+
+## Cloudflare
+
+Le HTML SSR public est **mutualisé pour tous les visiteurs** (l'auth et le panier
+s'hydratent côté client, jamais au SSR) — il est donc cachable à l'edge. Le middleware
+`cacheControl` (framework) émet `s-maxage` + `stale-while-revalidate` sur les pages
+publiques et `private, no-cache` sur les routes perso (`/mon-compte`, `/cart`, `/login`,
+`/preview`) ou toute réponse posant un `Set-Cookie`.
+
+### Cache Rule (zone du front)
+
+Crée **une Cache Rule** Cloudflare sur la zone `__PROJECT_NAME__.example.com` :
+
+- **Si** : `Method eq GET` **et** l'URI ne commence pas par `/mon-compte`, `/cart`,
+  `/login`, `/preview`, `/api`.
+- **Alors** : *Eligible for cache* + *Respect origin TTL* (honore le `s-maxage` envoyé
+  par l'origine — ne PAS forcer un Edge TTL fixe).
+
+> ⚠️ Ne **pas** bypasser le cache sur présence de cookie : le HTML public ne porte
+> jamais de `Set-Cookie` et reste cachable même si la requête a un cookie de session.
+> Bypasser sur cookie casserait le cache dès le 1er ajout panier.
+
+### Token de purge (post-deploy)
+
+`scripts/clear-cache.mjs` purge la zone après chaque deploy (sinon l'ancien HTML
+caché référence des assets hashés disparus → 404 CSS/JS). Crée un **API Token**
+Cloudflare scopé `Zone → Cache Purge → Purge` sur la zone du front, puis renseigne
+dans l'app webapp Coolify :
+
+- `CF_ZONE_ID` — Zone ID de `__PROJECT_NAME__.example.com`
+- `CF_API_TOKEN` — le token ci-dessus
+
+Si l'un manque, la purge est ignorée (le déploiement n'échoue pas).
+
+### WordPress (host dédié)
+
+Le host `wp.__PROJECT_NAME__.example.com` reste **DNS-only** (pas de proxy edge) :
+l'admin, GraphQL (POST) et `/wp-json` ne doivent jamais être mis en cache partagé.
+Les assets/uploads WordPress sont cachés via les labels Traefik (cf `traefik-labels.md`),
+pas par Cloudflare.
+
+## Rollback
+
+Les images sont taguées par SHA (`...:<sha>`). Pour revenir en arrière, pointer
+l'app Coolify sur le tag SHA précédent et redéployer. Sauvegarder la DB avant un
+déploiement prod à risque.

package/templates/client/docs/environment.md

@@ -0,0 +1,74 @@
+# Variables d'environnement — où va quoi
+
+Trois destinations distinctes. Ne pas mélanger.
+
+## 1. Local (`.env`, gitignored)
+
+Pour `docker-compose.dev.yml` + `pnpm dev`. Copie `.env.example` → `.env`.
+
+| Variable | Rôle |
+|---|---|
+| `WP_PORT` | Port hôte du WordPress local (ex. 8890) |
+| `WP_HOME` | URL du WP local (`http://localhost:${WP_PORT}`) |
+| `FRONTEND_URL` | URL de la webapp en dev (`http://localhost:3000`) |
+| `WORDPRESS_DB_NAME/_USER/_PASSWORD`, `MYSQL_ROOT_PASSWORD` | DB locale |
+| `WP_SITE_TITLE`, `WP_ADMIN_USER/_PASSWORD/_EMAIL` | Provisioning (`wp-bootstrap`) |
+| `VITE_*` | Bakées par Vite au `pnpm dev` (front) |
+| `SESSION_SECRET` | Sceau du cookie de session (auth) |
+
+> L'image WordPress de base est **privée** (GHCR). Avant le 1er `up` :
+> `echo <PAT read:packages> | docker login ghcr.io -u <user> --password-stdin`
+
+## 2. GitHub (CI — `.github/workflows/deploy.yml`)
+
+Repo → *Settings* → *Secrets and variables* → *Actions*.
+
+**Secrets** (sensibles) :
+
+| Secret | Rôle |
+|---|---|
+| `SESSION_SECRET` | Sceau cookie session (baké au build webapp) |
+| `COOLIFY_URL`, `COOLIFY_TOKEN` | API Coolify (déclenche le redeploy) |
+| `COOLIFY_WEBAPP_UUID`, `COOLIFY_WORDPRESS_UUID` | UUID des apps Coolify à redéployer |
+
+> `GITHUB_TOKEN` est fourni automatiquement (push GHCR + lecture des packages
+> `@wp-reactor/*` privés au build). Aucun PAT à créer côté CI.
+
+**Variables** (non sensibles, `vars.*`, bakées au build Vite) :
+
+| Variable | Rôle |
+|---|---|
+| `VITE_WORDPRESS_URL` | URL publique du WordPress (`https://${WP_HOST}`) |
+| `VITE_GRAPHQL_PATH` | Chemin GraphQL (`/graphql`) |
+| `VITE_FEATURE_EDITORIAL/_ECOMMERCE/_AUTH` | Flags de modules |
+
+## 3. Coolify (runtime des apps déployées)
+
+Dans chaque application Coolify (webapp / WordPress), onglet *Environment Variables*.
+Ce sont les variables **runtime** (lues à l'exécution), distinctes des `VITE_*`
+qui, elles, sont figées au build.
+
+**App WordPress** :
+
+| Variable | Rôle |
+|---|---|
+| `WORDPRESS_DB_HOST/_NAME/_USER/_PASSWORD` | Connexion DB |
+| `WP_HOME`, `WP_SITEURL` | `https://${WP_HOST}` |
+| `FRONTEND_URL` | `https://${APP_HOST}` (redirection headless) |
+| `WP_REDIS_HOST`, `WP_REDIS_PASSWORD` | Cache objet Redis |
+| `WP_ENVIRONMENT_TYPE`, `WP_DEBUG` | Environnement |
+
+> ⚠️ NE PAS définir `WORDPRESS_CONFIG_EXTRA` ni `WORDPRESS_DEBUG` côté Coolify :
+> la config est bakée dans l'image base (`wp-reactor-config.php`). Utiliser `WP_DEBUG`.
+
+**App Webapp** :
+
+| Variable | Rôle |
+|---|---|
+| `WORDPRESS_INTERNAL_URL` | URL interne du WP en SSR (`http://__PROJECT_NAME__-wordpress-internal`) |
+| `SESSION_SECRET` | Doit matcher celui du build |
+
+## TLS / routing
+
+Les **labels Traefik** (host, TLS, cache, compression) ne sont pas des variables
+d'env : ils se collent dans l'UI Coolify → voir [`traefik-labels.md`](./traefik-labels.md).

package/templates/client/docs/traefik-labels.md

@@ -0,0 +1,78 @@
+# Labels Traefik (à recopier dans Coolify)
+
+La webapp **et** WordPress sont déployées comme **applications Coolify autonomes**
+(images GHCR construites par `.github/workflows/deploy.yml`). Aucun runtime n'est
+dans un compose de prod — les labels Traefik ci-dessous se configurent
+**manuellement dans l'UI Coolify** de chaque application (onglet *Labels*).
+
+- `${APP_HOST}` = host du front (ex. `__PROJECT_NAME__.example.com`)
+- `${WP_HOST}`  = host dédié WordPress (ex. `wp.__PROJECT_NAME__.example.com`)
+
+> ⚠️ L'app WordPress doit aussi exposer l'**alias réseau** `__PROJECT_NAME__-wordpress-internal`
+> sur le réseau `coolify` (Coolify → *Network Aliases*), sinon la webapp ne résout
+> plus `WORDPRESS_INTERNAL_URL` en SSR.
+
+## WordPress (`__PROJECT_NAME__-wordpress`)
+
+```
+traefik.enable=true
+traefik.docker.network=coolify
+traefik.http.services.__PROJECT_NAME__-wordpress.loadbalancer.server.port=80
+
+# Médias uploads : cache revalidable (remplaçables à la même URL, non fingerprintés)
+traefik.http.middlewares.__PROJECT_NAME__-wp-uploads-cache.headers.customResponseHeaders.Cache-Control=public, max-age=3600, stale-while-revalidate=86400
+traefik.http.routers.__PROJECT_NAME__-wp-uploads.rule=Host(`${WP_HOST}`) && PathPrefix(`/wp-content/uploads`)
+traefik.http.routers.__PROJECT_NAME__-wp-uploads.entrypoints=https
+traefik.http.routers.__PROJECT_NAME__-wp-uploads.service=__PROJECT_NAME__-wordpress
+traefik.http.routers.__PROJECT_NAME__-wp-uploads.priority=95
+traefik.http.routers.__PROJECT_NAME__-wp-uploads.middlewares=__PROJECT_NAME__-wp-uploads-cache
+traefik.http.routers.__PROJECT_NAME__-wp-uploads.tls=true
+traefik.http.routers.__PROJECT_NAME__-wp-uploads.tls.certresolver=letsencrypt
+
+# Assets fingerprintés (cache long immutable) — prioritaire sur le catch-all WP
+traefik.http.middlewares.__PROJECT_NAME__-wp-assets-cache.headers.customResponseHeaders.Cache-Control=public, max-age=31536000, immutable
+traefik.http.routers.__PROJECT_NAME__-wp-assets.rule=Host(`${WP_HOST}`) && (PathPrefix(`/wp-includes`) || PathPrefix(`/wp-content`))
+traefik.http.routers.__PROJECT_NAME__-wp-assets.entrypoints=https
+traefik.http.routers.__PROJECT_NAME__-wp-assets.service=__PROJECT_NAME__-wordpress
+traefik.http.routers.__PROJECT_NAME__-wp-assets.priority=90
+traefik.http.routers.__PROJECT_NAME__-wp-assets.middlewares=__PROJECT_NAME__-wp-assets-cache
+traefik.http.routers.__PROJECT_NAME__-wp-assets.tls=true
+traefik.http.routers.__PROJECT_NAME__-wp-assets.tls.certresolver=letsencrypt
+
+# SEO (robots.txt + sitemaps) servis sur le host FRONT → WordPress
+traefik.http.routers.__PROJECT_NAME__-wp-seo.rule=Host(`${APP_HOST}`) && (Path(`/robots.txt`) || Path(`/sitemap_index.xml`) || PathRegexp(`-sitemap\.(xml|xsl)$`))
+traefik.http.routers.__PROJECT_NAME__-wp-seo.entrypoints=https
+traefik.http.routers.__PROJECT_NAME__-wp-seo.service=__PROJECT_NAME__-wordpress
+traefik.http.routers.__PROJECT_NAME__-wp-seo.priority=100
+traefik.http.routers.__PROJECT_NAME__-wp-seo.tls=true
+traefik.http.routers.__PROJECT_NAME__-wp-seo.tls.certresolver=letsencrypt
+
+# Catch-all WordPress (admin, /graphql, /wp-json…) sur son host dédié
+traefik.http.routers.__PROJECT_NAME__-wordpress.rule=Host(`${WP_HOST}`)
+traefik.http.routers.__PROJECT_NAME__-wordpress.entrypoints=https
+traefik.http.routers.__PROJECT_NAME__-wordpress.service=__PROJECT_NAME__-wordpress
+traefik.http.routers.__PROJECT_NAME__-wordpress.priority=10
+traefik.http.routers.__PROJECT_NAME__-wordpress.tls=true
+traefik.http.routers.__PROJECT_NAME__-wordpress.tls.certresolver=letsencrypt
+```
+
+## Webapp (`__PROJECT_NAME__-webapp`)
+
+```
+traefik.enable=true
+traefik.docker.network=coolify
+traefik.http.services.__PROJECT_NAME__-webapp.loadbalancer.server.port=3000
+
+# Compression
+traefik.http.middlewares.__PROJECT_NAME__-webapp-compress.compress=true
+traefik.http.middlewares.__PROJECT_NAME__-webapp-compress.compress.encodings=br,gzip
+traefik.http.middlewares.__PROJECT_NAME__-webapp-compress.compress.defaultEncoding=gzip
+
+# Front (catch-all, priorité basse pour laisser passer les routes WP/SEO ci-dessus)
+traefik.http.routers.__PROJECT_NAME__-webapp.rule=Host(`${APP_HOST}`)
+traefik.http.routers.__PROJECT_NAME__-webapp.entrypoints=https
+traefik.http.routers.__PROJECT_NAME__-webapp.priority=1
+traefik.http.routers.__PROJECT_NAME__-webapp.middlewares=__PROJECT_NAME__-webapp-compress
+traefik.http.routers.__PROJECT_NAME__-webapp.tls=true
+traefik.http.routers.__PROJECT_NAME__-webapp.tls.certresolver=letsencrypt
+```

package/templates/client/package.json

@@ -8,7 +8,11 @@
 		"build": "turbo run build",
 		"check-types": "turbo run check-types",
 		"lint": "turbo run lint",
-		"gen:block": "gen-block"
+		"gen:block": "gen-block",
+		"docker:up": "docker compose -f docker-compose.dev.yml up -d",
+		"docker:bootstrap": "docker compose -f docker-compose.dev.yml --profile tools run --rm wp-bootstrap",
+		"docker:down": "docker compose -f docker-compose.dev.yml down",
+		"docker:reset": "docker compose -f docker-compose.dev.yml down -v"
 	},
 	"devDependencies": {
 		"@wp-reactor/cli": "^0.1.0",

package/dist/index.d.ts

@@ -1,18 +0,0 @@
-declare const TEMPLATES_DIR: string;
-interface ScaffoldOptions {
-    /** Nom kebab du projet (ex. "client-2") → noms de packages, dossiers, thème. */
-    projectName: string;
-    /** Dossier cible (créé). */
-    targetDir: string;
-    /** Namespace des blocs gen-block. Défaut : projectName sans tirets. */
-    namespace?: string;
-    /** Override du dossier template (tests). */
-    templatesDir?: string;
-}
-interface ScaffoldResult {
-    targetDir: string;
-    written: string[];
-}
-declare function scaffold(opts: ScaffoldOptions): ScaffoldResult;
-
-export { type ScaffoldOptions, type ScaffoldResult, TEMPLATES_DIR, scaffold };

package/dist/index.js

@@ -1,62 +0,0 @@
-// src/index.ts
-import {
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  statSync,
-  writeFileSync
-} from "fs";
-import { dirname, join, resolve } from "path";
-import { fileURLToPath } from "url";
-var HERE = dirname(fileURLToPath(import.meta.url));
-var TEMPLATES_DIR = resolve(HERE, "../templates/client");
-function titleCase(kebab) {
-  return kebab.split(/[-_]/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
-}
-function applyTokens(input, tokens) {
-  let out = input;
-  for (const [key, value] of Object.entries(tokens)) {
-    out = out.split(key).join(value);
-  }
-  return out;
-}
-var DOTFILES = {
-  gitignore: ".gitignore",
-  npmrc: ".npmrc"
-};
-function copyTemplateTree(srcDir, destDir, tokens, written) {
-  for (const entry of readdirSync(srcDir)) {
-    const srcPath = join(srcDir, entry);
-    const destName = DOTFILES[entry] ?? applyTokens(entry, tokens);
-    const destPath = join(destDir, destName);
-    if (statSync(srcPath).isDirectory()) {
-      mkdirSync(destPath, { recursive: true });
-      copyTemplateTree(srcPath, destPath, tokens, written);
-    } else {
-      const content = applyTokens(readFileSync(srcPath, "utf8"), tokens);
-      mkdirSync(dirname(destPath), { recursive: true });
-      writeFileSync(destPath, content);
-      written.push(destPath);
-    }
-  }
-}
-function scaffold(opts) {
-  const projectName = opts.projectName;
-  const namespace = opts.namespace ?? projectName.replace(/[-_]/g, "");
-  const templatesDir = opts.templatesDir ?? TEMPLATES_DIR;
-  const targetDir = resolve(opts.targetDir);
-  const tokens = {
-    __PROJECT_NAME__: projectName,
-    __PROJECT_TITLE__: titleCase(projectName),
-    __BLOCK_NAMESPACE__: namespace
-  };
-  const written = [];
-  mkdirSync(targetDir, { recursive: true });
-  copyTemplateTree(templatesDir, targetDir, tokens, written);
-  return { targetDir, written };
-}
-export {
-  TEMPLATES_DIR,
-  scaffold
-};
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// create-wp-reactor — scaffolder de repo client mince.\n//\n// Émet un monorepo client « 2 mondes » depuis un template BUNDLÉ (npx-friendly :\n// aucun accès au monorepo framework au runtime) :\n//   • apps/webapp     ← coque (starter synchronisé dans templates/, voir\n//                       scripts/sync-template.mjs)\n//   • apps/wordpress  ← thème ENFANT\n//   • .github, docker, wp-reactor.config.json, workspace root\n//\n// Le runtime ne fait que copier templates/client/ en substituant les tokens.\n\nimport {\n\tmkdirSync,\n\treadFileSync,\n\treaddirSync,\n\tstatSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst HERE = dirname(fileURLToPath(import.meta.url));\n// src/ (dev via tsx) comme dist/ (build) sont à 1 niveau du package.\nconst TEMPLATES_DIR = resolve(HERE, \"../templates/client\");\n\nexport interface ScaffoldOptions {\n\t/** Nom kebab du projet (ex. \"client-2\") → noms de packages, dossiers, thème. */\n\tprojectName: string;\n\t/** Dossier cible (créé). */\n\ttargetDir: string;\n\t/** Namespace des blocs gen-block. Défaut : projectName sans tirets. */\n\tnamespace?: string;\n\t/** Override du dossier template (tests). */\n\ttemplatesDir?: string;\n}\n\nexport interface ScaffoldResult {\n\ttargetDir: string;\n\twritten: string[];\n}\n\nfunction titleCase(kebab: string): string {\n\treturn kebab\n\t\t.split(/[-_]/)\n\t\t.filter(Boolean)\n\t\t.map((w) => w[0].toUpperCase() + w.slice(1))\n\t\t.join(\" \");\n}\n\nfunction applyTokens(input: string, tokens: Record<string, string>): string {\n\tlet out = input;\n\tfor (const [key, value] of Object.entries(tokens)) {\n\t\tout = out.split(key).join(value);\n\t}\n\treturn out;\n}\n\n// npm strippe `.gitignore` et `.npmrc` des tarballs publiés : on les stocke\n// sans point dans le template et on les re-dotte à l'écriture.\nconst DOTFILES: Record<string, string> = {\n\tgitignore: \".gitignore\",\n\tnpmrc: \".npmrc\",\n};\n\n/** Copie récursive du template en substituant les tokens dans chemins + contenu. */\nfunction copyTemplateTree(\n\tsrcDir: string,\n\tdestDir: string,\n\ttokens: Record<string, string>,\n\twritten: string[],\n): void {\n\tfor (const entry of readdirSync(srcDir)) {\n\t\tconst srcPath = join(srcDir, entry);\n\t\tconst destName = DOTFILES[entry] ?? applyTokens(entry, tokens);\n\t\tconst destPath = join(destDir, destName);\n\t\tif (statSync(srcPath).isDirectory()) {\n\t\t\tmkdirSync(destPath, { recursive: true });\n\t\t\tcopyTemplateTree(srcPath, destPath, tokens, written);\n\t\t} else {\n\t\t\tconst content = applyTokens(readFileSync(srcPath, \"utf8\"), tokens);\n\t\t\tmkdirSync(dirname(destPath), { recursive: true });\n\t\t\twriteFileSync(destPath, content);\n\t\t\twritten.push(destPath);\n\t\t}\n\t}\n}\n\nexport function scaffold(opts: ScaffoldOptions): ScaffoldResult {\n\tconst projectName = opts.projectName;\n\tconst namespace = opts.namespace ?? projectName.replace(/[-_]/g, \"\");\n\tconst templatesDir = opts.templatesDir ?? TEMPLATES_DIR;\n\tconst targetDir = resolve(opts.targetDir);\n\tconst tokens: Record<string, string> = {\n\t\t__PROJECT_NAME__: projectName,\n\t\t__PROJECT_TITLE__: titleCase(projectName),\n\t\t__BLOCK_NAMESPACE__: namespace,\n\t};\n\tconst written: string[] = [];\n\n\tmkdirSync(targetDir, { recursive: true });\n\tcopyTemplateTree(templatesDir, targetDir, tokens, written);\n\n\treturn { targetDir, written };\n}\n\nexport { TEMPLATES_DIR };\n"],"mappings":";AAWA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACM;AACP,SAAS,SAAS,MAAM,eAAe;AACvC,SAAS,qBAAqB;AAE9B,IAAM,OAAO,QAAQ,cAAc,YAAY,GAAG,CAAC;AAEnD,IAAM,gBAAgB,QAAQ,MAAM,qBAAqB;AAkBzD,SAAS,UAAU,OAAuB;AACzC,SAAO,MACL,MAAM,MAAM,EACZ,OAAO,OAAO,EACd,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,YAAY,IAAI,EAAE,MAAM,CAAC,CAAC,EAC1C,KAAK,GAAG;AACX;AAEA,SAAS,YAAY,OAAe,QAAwC;AAC3E,MAAI,MAAM;AACV,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AAClD,UAAM,IAAI,MAAM,GAAG,EAAE,KAAK,KAAK;AAAA,EAChC;AACA,SAAO;AACR;AAIA,IAAM,WAAmC;AAAA,EACxC,WAAW;AAAA,EACX,OAAO;AACR;AAGA,SAAS,iBACR,QACA,SACA,QACA,SACO;AACP,aAAW,SAAS,YAAY,MAAM,GAAG;AACxC,UAAM,UAAU,KAAK,QAAQ,KAAK;AAClC,UAAM,WAAW,SAAS,KAAK,KAAK,YAAY,OAAO,MAAM;AAC7D,UAAM,WAAW,KAAK,SAAS,QAAQ;AACvC,QAAI,SAAS,OAAO,EAAE,YAAY,GAAG;AACpC,gBAAU,UAAU,EAAE,WAAW,KAAK,CAAC;AACvC,uBAAiB,SAAS,UAAU,QAAQ,OAAO;AAAA,IACpD,OAAO;AACN,YAAM,UAAU,YAAY,aAAa,SAAS,MAAM,GAAG,MAAM;AACjE,gBAAU,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAChD,oBAAc,UAAU,OAAO;AAC/B,cAAQ,KAAK,QAAQ;AAAA,IACtB;AAAA,EACD;AACD;AAEO,SAAS,SAAS,MAAuC;AAC/D,QAAM,cAAc,KAAK;AACzB,QAAM,YAAY,KAAK,aAAa,YAAY,QAAQ,SAAS,EAAE;AACnE,QAAM,eAAe,KAAK,gBAAgB;AAC1C,QAAM,YAAY,QAAQ,KAAK,SAAS;AACxC,QAAM,SAAiC;AAAA,IACtC,kBAAkB;AAAA,IAClB,mBAAmB,UAAU,WAAW;AAAA,IACxC,qBAAqB;AAAA,EACtB;AACA,QAAM,UAAoB,CAAC;AAE3B,YAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AACxC,mBAAiB,cAAc,WAAW,QAAQ,OAAO;AAEzD,SAAO,EAAE,WAAW,QAAQ;AAC7B;","names":[]}