Communitygithub.com

Vincenius/wwebdev

Construye, sirve y prueba las páginas de wweb.dev en un navegador real para verificar los cambios en la superficie renderizada.

¿Qué es wwebdev?

Esta habilidad permite verificar cambios en wweb.dev, un sitio Astro estático con componentes React hidratados, cargando la página construida en un navegador real e interactuando con las islas hidratadas. Es útil para desarrolladores que necesitan asegurarse de que las modificaciones en el código fuente se reflejen correctamente en la interfaz renderizada, especialmente en herramientas generadoras de CSS/HTML interactivas. Soporta la construcción del sitio con Yarn, el uso de un servidor de producción local y la automatización de pruebas con Playwright (usando el Chrome del sistema). También incluye verificaciones de estilos computados, valores de textarea y capturas de pantalla en diferentes tamaños de ventana, así como advertencias sobre configuraciones de CSP y pruebas de paridad que requieren archivos de referencia no incluidos en el repositorio.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Vincenius/wwebdev/tree/HEAD/.claude/skills/verify

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Verificar un cambio en wweb.dev

Sitio Astro completamente estático con islas React — la verificación implica cargar la página construida en un navegador e interactuar con las islas hidratadas.

Construir + servir

yarn install          # si faltan dependencias del servidor (server.mjs necesita compression/express)
yarn build            # construcción estática → dist/ (TZ=UTC integrado)
yarn serve            # servidor de producción en http://localhost:4321 (NO astro preview)

node server.mjs falla directamente en configuraciones con Yarn PnP — siempre usa yarn serve. Ejecútalo en segundo plano; verifica con curl -s -o /dev/null -w "%{http_code}" http://localhost:4321/<ruta>.

Manejar la página

No hay Playwright en el repositorio. Instala playwright-core en un directorio temporal y usa el Chrome del sistema (chromium.launch({ channel: 'chrome', headless: true })) — no es necesario descargar un navegador. Las islas son client:visible, así que espera un selector renderizado por la isla antes de hacer afirmaciones, y dale a las animaciones ~1s.

Verificaciones útiles para las herramientas generadoras:

  • estilos computados de la salida <style> inyectada (nombre de animación, posición, tamaño)
  • textarea .inputValue() para el código HTML/CSS copiable
  • capturas de pantalla a 1440 px y ~480 px (varias barras laterales de herramientas cambian a column-reverse en móviles)

Advertencias

  • La consola debe estar libre de errores. La incrustación de activos de Vite está deshabilitada (assetsInlineLimit: 0 en astro.config.mjs) porque las fuentes data-URI violan la CSP font-src 'self' — si los errores de CSP por data-URI reaparecen, esa configuración se perdió.
  • yarn test:parity necesita test/baseline/ (instantáneas HTML de producción) que no está incluido en el repositorio; sin él, el harness falla con ENOENT. De todos modos, no es un sustituto de la verificación en navegador.

Skills relacionados