Communitygithub.com

Vincenius/wwebdev

Construire, servir et piloter les pages de wweb.dev dans un navigateur réel pour vérifier les changements au niveau du rendu visuel.

Qu'est-ce que wwebdev ?

Cette compétence permet de valider des modifications sur le site wweb.dev, un site Astro statique avec des îles React. Elle guide l'utilisateur à travers les étapes de construction statique (yarn build) et de démarrage d'un serveur de production (yarn serve) sur le port 4321. Ensuite, elle explique comment utiliser Playwright Core avec le Chrome système pour contrôler le navigateur sans téléchargement supplémentaire de navigateur. Les îles étant chargées avec client:visible, il faut attendre les sélecteurs appropriés et laisser ~1s pour les animations. La compétence détaille les vérifications utiles pour les outils de génération : styles calculés, valeurs de zones de texte pour le code copiable, et captures d'écran à 1440px et 480px. Elle met en garde contre les erreurs de console (notamment les violations CSP des data-URI de polices) et explique pourquoi yarn test:parity ne remplace pas une vérification dans le navigateur.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Vérifier une modification sur wweb.dev

Site Astro entièrement statique avec îles React — la vérification consiste à charger la page construite dans un navigateur et à interagir avec les îles hydratées.

Construction + service

yarn install          # si les dépendances du serveur manquent (server.mjs a besoin de compression/express)
yarn build            # construction statique → dist/ (TZ=UTC intégré)
yarn serve            # serveur de production sur http://localhost:4321 (PAS astro preview)

node server.mjs échoue directement sous les configurations Yarn PnP-adjacentes — passez toujours par yarn serve. Lancez-le en arrière-plan ; testez avec curl -s -o /dev/null -w "%{http_code}" http://localhost:4321/<route>.

Piloter la page

Pas de Playwright dans le dépôt. Installez playwright-core dans un répertoire temporaire et utilisez le Chrome système (chromium.launch({ channel: 'chrome', headless: true })) — aucun téléchargement de navigateur nécessaire. Les îles sont client:visible, donc attendez un sélecteur rendu par une île avant d'effectuer des assertions, et laissez ~1s pour les animations.

Vérifications utiles pour les outils de génération :

  • styles calculés de la sortie <style> injectée (animation-name, position, taille)
  • .inputValue() de la zone de texte pour le code HTML/CSS copiable
  • captures d'écran à 1440px et ~480px (plusieurs barres latérales d'outils basculent en column-reverse sur mobile)

Pièges

  • La console doit être exempte d'erreurs. L'inlining d'actifs Vite est désactivé (assetsInlineLimit: 0 dans astro.config.mjs) car les polices en data-URI violent CSP font-src 'self' — si des erreurs CSP liées aux data-URI réapparaissent, ce paramètre a été perdu.
  • yarn test:parity nécessite test/baseline/ (instantanés HTML de production) qui n'est pas inclus dans le dépôt ; sans cela, le harnais émet une erreur ENOENT. Cela ne remplace de toute façon pas une vérification dans le navigateur.

Skills associés