Signature email animée
Vous allez créer deux éléments pour la marque de l'utilisateur et les placer sur son site web :
- Un GIF en boucle (1200×340, affiché en 480×136, environ 11 s, moins de 1 Mo). Il s'ouvre sur la carte de marque (logo, nom, slogan, domaine), montre le produit en action (une seule tâche réelle), puis revient à la carte de marque.
- Une page d'équipe où chaque personne tape son nom, titre et email, voit la signature dans une boîte de réception claire et une boîte sombre, et la copie. Le nom et le titre restent en texte brut, donc un seul GIF sert toute l'équipe. La page indique aux moteurs de recherche et aux robots IA de ne pas l'indexer.
Le dossier du skill contient :
scripts/inspect-site.mjs: lit le site web (pages, couleurs, polices, logos, images, captures d'écran)assets/card.html: l'animation, avec trois scènes (chat, compteur, showcase), remplies à partir debrand.jsonassets/signature-page.html: la page d'équipeassets/brand.example.json: un exemple de marque à copierscripts/render.mjs: carte → GIF, avec vérifications de taille et de bouclescripts/build-page.mjs: brand.json → la page d'équipereferences/deploy.md: déploiement des deux fichiers sur le site ; à lire à l'étape 6
Pourquoi c'est construit ainsi
Connaître ces points vous permet de prendre de bonnes décisions lorsqu'une marque ne correspond pas au modèle :
- L'email ne peut pas exécuter de code. Gmail, Outlook et Apple Mail suppriment les scripts, vidéos et animations CSS des signatures, donc le seul mouvement qui fonctionne partout est un GIF animé.
- Les anciens Outlook de bureau n'affichent que la première image. L'image 0 doit donc être la carte de marque terminée, jamais une image vierge ou à moitié dessinée. La boucle se termine exactement sur cette carte, pour que le redémarrage n'ait pas de saut visible.
render.mjsvérifie les deux. - La taille compte. Les grandes signatures sont tronquées ou chargent lentement, donc gardez le GIF sous 1 Mo. Un GIF ne stocke que les pixels qui changent entre les images, donc tout ce qui change une grande zone à chaque image gonfle le fichier. Dans un vrai projet, un léger halo pulsant derrière le logo est passé de 434 Ko à 1,26 Mo. Privilégiez les mouvements dans de petites zones : texte qui s'affiche, icônes, fondus courts.
render.mjséchoue au-dessus de 1 Mo. - Dessiné en 2×, affiché en taille fixe. Cela le garde net sur les écrans Retina. Le HTML de la signature définit
width="480" height="136"pour que l'application mail ne l'affiche jamais à la largeur de fichier de 1200 px. - La signature copiée doit pointer vers l'adresse https absolue du GIF en ligne. Un client mail ne peut pas charger un fichier local ou un chemin relatif. La page copie toujours
gifUrl, même lorsqu'elle prévisualise un fichier local. - Le nom n'a pas de couleur propre. Il prend la couleur de texte de la boîte de réception, donc il se lit en mode clair et sombre. La deuxième ligne et le lien email utilisent des couleurs moyennes qui se lisent sur les deux.
- L'histoire montre seulement ce que le produit fait vraiment. Une signature atteint les clients et les investisseurs, donc une fonctionnalité ou un chiffre inventé est une fausse déclaration dans chaque email que l'équipe envoie. Obtenez l'histoire du site ou de la documentation du produit, et obtenez l'approbation de l'utilisateur avant de rendre l'image.
Étapes
1. Configurer un dossier de travail
Utilisez un dossier en dehors du dépôt du site web, pour que les outils ne se retrouvent pas sur leur site :
mkdir email-signature-work && cd email-signature-work
npm init -y
npm i playwright
npx playwright install chromium
Vérifiez ffmpeg avec ffmpeg -version. Pour l'installer : sur macOS brew install ffmpeg, sur Windows winget install Gyan.FFmpeg, sur Linux sudo apt install ffmpeg.
Exécutez toutes les commandes ci-dessous depuis ce dossier. brand.json, le brief du site, les images recadrées et les résultats se trouvent ici, à côté de node_modules.
2. Lire le site web
node <dossier du skill>/scripts/inspect-site.mjs https://leur-site.com site-brief --pages 6
Il ouvre la page d'accueil et jusqu'à 6 pages supplémentaires (produits, fonctionnalités, à propos, tarifs d'abord) et écrit site-brief/ :
brief.json:pages[]contient le titre, la description, les titres, le texte principal et les libellés des boutons de chaque page, sapalette(couleurs rgb réellement utilisées, classées par leur couverture de la page, divisées enbackground,text,button,link) et sesfonts. Leslogosetimagesde haut niveau listent les candidats. Une listebuttonvide ou une policesystem-uisignifie que le site ne les a pas exposés : prenez la couleur d'accent à partir des captures d'écran à la place, et choisissez les polices à l'œil.screens/: une capture d'écran de chaque pagelogos/: chaque candidat logo (SVG d'en-tête ou image, icônes d'application, image sociale)images/: les plus grandes images de contenu (produits, plats, projets, captures d'écran d'application, personnes)
brief.json → logos et images listent la taille en pixels (px) de chaque fichier et une note lorsqu'il est trop petit pour la carte ou une bannière large.
S'il ne lit qu'une seule page, le site construit probablement ses liens avec un script ou bloque les visites automatisées. Relancez-le avec une page produit comme URL de départ, ou demandez à l'utilisateur.
Ensuite, regardez réellement, comme le ferait un designer avant de commencer :
- Captures d'écran : ouvrez les captures de la page d'accueil et d'une ou deux pages produit. Obtenez l'ambiance (sombre ou clair, ludique ou sérieux, photographique ou UI plate) et quelle couleur est l'accent de la marque. Le fond de bouton le plus utilisé est généralement l'accent.
- Logos : ouvrez les candidats logos.
- Un SVG d'en-tête est généralement la meilleure source. Un
apple-touch-iconpeut être un marque carré propre, mais vérifiez sonpx: de nombreux sites servent des icônes 32×32, qui deviennent floues sur la carte. Tout ce qui est noté "trop petit pour la carte" est exclu. - Vérifiez ce que vous avez. Un marque carré va dans
logo. Un wordmark large va danswordmarket s'affiche sur la carte de marque à la place du nom tapé. - Sans logo carré, la carte s'adapte. Avec un wordmark, elle supprime la colonne de gauche, pour que le nom ne soit pas affiché deux fois. Sans aucun des deux, elle dessine la première lettre de la marque dans la couleur d'accent.
- N'utilisez pas un favicon de moins de 64 px ou un recadrage flou : demandez plutôt un fichier à l'utilisateur.
- Les logos conçus pour un en-tête blanc peuvent disparaître sur une carte sombre. Si c'est le cas, utilisez une carte claire, demandez une version claire, ou modifiez le
filld'un SVG.
- Un SVG d'en-tête est généralement la meilleure source. Un
- Images : ouvrez les images candidates pour une scène de showcase. Évitez les photos génériques, les visages de personnes (demandez d'abord), et tout ce qui contient du petit texte illisible en 168×126.
- L'image est recadrée pour remplir (environ 4:3). Les bannières hero larges ont généralement du texte et des boutons intégrés, et leur recadrage laisse des bouts de lettres. Recadrez vous-même le sujet d'abord :
Iciffmpeg -i site-brief/images/00.png -vf "crop=900:675:500:110" crop-1.pngcrop=w:h:x:ysélectionne une boîte 4:3 autour du produit. Ensuite, ouvrez le résultat pour vérifier.
- L'image est recadrée pour remplir (environ 4:3). Les bannières hero larges ont généralement du texte et des boutons intégrés, et leur recadrage laisse des bouts de lettres. Recadrez vous-même le sujet d'abord :
- Texte : lisez le texte principal et les titres. Comprenez ce que l'entreprise fait vraiment pour un client, dans ses propres mots, et tout chiffre réel qu'elle rend public (clients servis, commandes livrées, années d'activité).
Si le site bloque le script (mur de connexion, protection anti-bot) ou est pauvre, demandez à l'utilisateur le logo, les couleurs et une phrase sur ce que fait l'entreprise.
3. Choisir la scène et écrire l'histoire, puis obtenir l'approbation
brand.json → story.type choisit l'une des trois scènes. Choisissez celle qui montre le plus clairement cette entreprise en action :
| Scène | Convient | Champs de l'histoire |
|---|---|---|
chat | logiciels, agents IA, applications, services qui répondent ou réparent quelque chose | question (≤ 32 car.), trois steps de { text ≤ 34, status: "ok" | "warn" }, result (≤ 28), details (2–3 lignes ≤ 40) |
counter | un chiffre public réel : argent géré, commandes expédiées, clients servis, années d'activité | label (≤ 40), value (nombre), prefix/suffix (par ex. "₹", "+", " commandes"), decimals, result (≤ 28), details |
showcase | boutiques, nourriture, voyages, studios, portfolios, produits physiques : tout ce qui est mieux montré que raconté | items : 2–3 de { image: "site-brief/images/03.jpg", title ≤ 22, text ≤ 36 }. Les photos sont la partie la plus lourde d'un GIF : en test, 2 photos représentaient environ 790 Ko, 3 environ 940 Ko et 4 dépassaient 1 Mo. |
Le chiffre d'un compteur doit être déjà annoncé publiquement par l'entreprise (sur son propre site), avec l'accord de l'utilisateur. N'en inventez jamais. Un showcase utilise les propres images de l'entreprise issues de son site, pas des images génériques.
Pour ajouter une scène différente (avant/après, itinéraire sur une carte, barre de progression), ajoutez une entrée à SCENES dans une copie de card.html et rendez avec --card votre-card.html. Respectez les règles dans "Pourquoi c'est construit ainsi".
Écrivez brand.json (copiez assets/brand.example.json ; les chemins d'image sont relatifs à brand.json) :
- Nom, domaine, URLs :
name,domain,siteUrl, etgifUrl, l'adresse absolue où le GIF sera hébergé (par exemplehttps://leur-site.com/email/signature.gif). - Texte :
tagline, environ cinq mots décrivant ce que fait l'entreprise. Optionnellementemail, l'email de placeholder affiché sur la page d'équipe. - Images :
logo(un marque carré, optionnel) etwordmark(optionnel). - Polices : noms de familles Google Fonts.
brief.jsonliste les polices du site.- Si elles sont sur Google Fonts, utilisez-les.
- Si elles sont propriétaires ou auto-hébergées, choisissez la police Google la plus proche par l'ambiance : un sans rond pour un sans rond, un serif pour un serif.
- Laissez
fontsvide pour utiliser les polices système.
- Couleurs :
colors, construites à partir de la palette du site :bg: le fond de la carte. Un ton foncé de la marque se lit bien dans les boîtes de réception claires et ne fait pas mal dans les boîtes sombres. Une carte claire fonctionne aussi, si le site est clair.card: une couleur de panneau légèrement différenteline: bordurestext,mutedetsubtle: texte, du plus fort au plus faible. Ils doivent avoir un contraste clair surbg.accent: la couleur de la marquegoodetbad: un vert et un rougelink: un accent assez foncé pour se lire sur un fond de boîte de réception blanc
Définissez story.type sur la scène choisie ; par défaut c'est chat.
Montrez le plan à l'utilisateur avant de rendre, et attendez son accord. Incluez la scène, les lignes de l'histoire (ou les images choisies avec légendes), et le logo que vous utiliserez.
4. Rendre et examiner
node <dossier du skill>/scripts/render.mjs brand.json signature.gif
Il affiche la taille et les lignes PASS, écrit signature-last.png (la fin de la boucle, qui doit correspondre à la première image), échoue si le texte dépasse du bord, le fichier dépasse 1 Mo, ou la boucle ne se termine pas sur la première image, et écrit signature-first.png, l'image que montre Outlook sur les anciennes versions. Ouvrez cette image et deux ou trois images du milieu de la boucle, et vérifiez :
- rien n'est coupé au bord droit (le texte long est la cause habituelle)
- le logo est net
- les couleurs se lisent
- la première image est une carte terminée
Pour extraire une image à, disons, 5 s, exécutez ffmpeg -ss 5 -i signature.gif -frames:v 1 frame5.png. Corrigez et rendez à nouveau jusqu'à ce que tout passe et ait l'air correct. Si le fichier dépasse 1 Mo, supprimez d'abord le mouvement de grande zone. Baisser --fps 12 est un dernier recours.
Montrez à l'utilisateur la première image et une image du milieu de la boucle (ou le GIF lui-même) avant d'aller plus loin.
5. Construire la page d'équipe
node <dossier du skill>/scripts/build-page.mjs brand.json email-signature.html
Pour prévisualiser avant le déploiement, exécutez npx serve . dans le dossier de travail et ouvrez http://localhost:3000/email-signature?preview=signature.gif. Laissez .html de côté : serve redirige les adresses .html et supprime la partie ?preview, et la page tente alors d'utiliser le GIF pas encore en ligne. Le paramètre preview ne modifie que ce que la page affiche ; la signature copiée pointe toujours vers gifUrl. Testez avec un nom long et avec des caractères comme < et &, qui doivent s'afficher tels quels.
6. Déployer
Lisez references/deploy.md. Il couvre l'emplacement des deux fichiers pour les stacks courants (hébergeurs statiques, Next.js, Astro, WordPress, Webflow et autres), où héberger le GIF lorsque l'utilisateur ne peut pas mettre de fichiers sur son site, la ligne robots.txt, et ce qu'il faut vérifier une fois en ligne. Suivez la méthode normale du site pour livrer les modifications : une branche et une pull request s'il s'agit d'un dépôt git. Ne poussez pas ni ne déployez sans l'accord de l'utilisateur.
7. Remise
Dites à l'utilisateur :
- Liens : l'adresse de la page à partager avec l'équipe, et l'adresse du GIF.
- Vérifié : ce que vous avez vérifié vous-même, comme les contrôles de rendu, les images que vous avez examinées et l'aperçu de la page.
- Encore à vérifier après le déploiement : coller dans Gmail, Outlook et Apple Mail, à partir de la liste dans
deploy.md. Rien concernant les vraies applications mail ne peut être vérifié avant que le GIF ne soit en ligne, donc dites-le clairement plutôt que de laisser entendre que ça marche. - Mise à jour ultérieure : modifiez
brand.json, rendez à nouveau, et remplacez le GIF à la même adresse. La signature de tout le monde se met à jour automatiquement, même si les caches d'images des applications mail peuvent prendre un jour ou plus.