ps-watch

name	ps-watch
description	Sets up BrowserSync live-reload watcher for PrestaShop Panda child theme development in Lando. Auto-detects child theme name and Lando proxy URL. Watches child theme CSS/JS/TPL files and reloads the browser automatically on save. Use when working on PS frontend/maquetación in Lando and the user wants auto-reload, live reload, watcher, or is tired of reloading the browser manually after CSS changes.
version	0.1.0
metadata	{"author":"Eduardo Calvo"}

PS Watch — BrowserSync para Panda child theme en Lando

Auto-reload en el browser cada vez que guardas CSS, JS o TPL del child theme. No toca Panda parent. Funciona fuera del contenedor Lando.

---

Setup (ejecutar una vez por proyecto)

Paso 1 — Detectar child theme y URL de Lando

# Child theme = cualquier carpeta en themes/ que no sea panda ni core
ls themes/ | grep -vE "^(panda|core|\.)"

# URL de Lando — leer el campo name del .lando.yml
grep "^name:" .lando.yml | awk '{print $2}'
# URL resultado: http://<name>.lndo.site
# Usar HTTP, no HTTPS — evita errores de cert self-signed de Lando

Paso 2 — Crear bs-config.js en el root del proyecto

Sustituir CHILD_THEME por el nombre detectado y LANDO_URL por http://<name>.lndo.site:

module.exports = {
  proxy: "http://LANDO_URL",
  files: [
    "themes/CHILD_THEME/assets/css/**/*.css",
    "themes/CHILD_THEME/assets/js/**/*.js",
    "themes/CHILD_THEME/templates/**/*.tpl",
    "modules/*/views/templates/**/*.tpl",
    "modules/*/views/css/**/*.css",
  ],
  open: false,
  notify: false,
  reloadDelay: 150,
  logLevel: "info",
};

Paso 3 — Crear o actualizar package.json en el root

Si ya existe package.json, añadir solo las entradas que falten. Si no existe, crear completo:

{
  "private": true,
  "scripts": {
    "watch": "browser-sync start --config bs-config.js"
  },
  "devDependencies": {
    "browser-sync": "^3"
  }
}

Paso 4 — Instalar dependencias

npm install

---

Uso diario

# Arranca el watcher (con Lando ya corriendo)
npm run watch

BrowserSync abre en http://localhost:3000 (proxy de Lando). Abre esa URL en el browser en vez de la URL de Lando directamente. Cada vez que guardas un fichero vigilado → el browser recarga solo.

---

Notas importantes

• Usar HTTP, no HTTPS para el proxy: Lando sirve ambos pero HTTPS tiene cert self-signed que BrowserSync rechaza. HTTP funciona igual para desarrollo local.
• Child theme nunca es panda: Panda es el parent. El child theme varía por proyecto (milagros, podiatech, etc.).
• open: false evita que BrowserSync abra otra pestaña al arrancar.
• modules/*/views/ cubre módulos custom del proyecto — si el proyecto no tiene módulos custom con CSS/TPL, no pasa nada (el watcher ignora patterns vacíos).
• Si el puerto 3000 está ocupado, BrowserSync usa 3001, 3002, etc. — lo indica en la terminal.

.gitignore (añadir si no están)

node_modules/

---

Checklist

• Child theme detectado (ls themes/ | grep -vE "^(panda|core)")
• URL Lando obtenida (grep "^name:" .lando.yml)
• bs-config.js creado con child theme name y URL correctos
• package.json creado/actualizado con script watch y dep browser-sync
• npm install ejecutado
• node_modules/ en .gitignore
• npm run watch arranca y browser recarga al guardar un CSS