Assinatura de email animada
Você criará duas coisas para a marca do usuário e as colocará no site dele:
- Um GIF em loop (1200×340, exibido em 480×136, cerca de 11 s, abaixo de 1 MB). Ele abre com o cartão da marca (logotipo, nome, slogan, domínio), mostra o produto fazendo um trabalho real e retorna ao cartão da marca.
- Uma página de equipe onde cada pessoa digita seu nome, cargo e email, vê a assinatura em uma caixa de entrada clara e uma escura, e a copia. Nome e cargo permanecem como texto vivo, então um GIF atende toda a equipe. A página instrui mecanismos de busca e rastreadores de IA a ficarem longe.
A pasta da habilidade contém:
scripts/inspect-site.mjs: lê o site (páginas, cores, fontes, logotipos, imagens, capturas de tela)assets/card.html: a animação, com três cenas (chat, contador, vitrine), preenchidas a partir debrand.jsonassets/signature-page.html: a página da equipeassets/brand.example.json: um exemplo de marca para copiarscripts/render.mjs: cartão → GIF, além de verificações de tamanho e loopscripts/build-page.mjs: brand.json → a página da equipereferences/deploy.md: colocando ambos no site; leia-o na etapa 6
Por que foi construído assim
Saber disso permite que você tome boas decisões quando uma marca não se encaixa no modelo:
- O email não pode executar código. Gmail, Outlook e Apple Mail removem scripts, vídeos e animações CSS das assinaturas, então o único movimento que sobrevive em todos os lugares é um GIF animado.
- O Outlook desktop antigo mostra apenas o primeiro quadro. Portanto, o quadro 0 deve ser o cartão da marca finalizado, nunca um quadro em branco ou parcialmente desenhado. O loop também termina exatamente nesse cartão, para que a reinicialização não tenha um salto visível.
render.mjsverifica ambos. - O tamanho importa. Assinaturas grandes são cortadas ou carregam lentamente, então mantenha o GIF abaixo de 1 MB. Um GIF armazena apenas os pixels que mudam entre os quadros, então qualquer coisa que mude uma grande área em todos os quadros aumenta o arquivo. Em uma construção real, um brilho suave pulsante atrás do logotipo levou o GIF de 434 KB para 1,26 MB. Prefira movimento em áreas pequenas: texto digitando, ícones, desvanecimentos curtos.
render.mjsfalha acima de 1 MB. - Desenhado em 2×, exibido em tamanho fixo. Isso o mantém nítido em telas retina. O HTML da assinatura define
width="480" height="136"para que o aplicativo de email nunca o mostre na largura de arquivo de 1200 px. - A assinatura copiada deve apontar para o endereço https absoluto do GIF ao vivo. Um aplicativo de email não pode carregar um arquivo local ou um caminho relativo. A página sempre copia
gifUrl, mesmo quando visualiza um arquivo local. - O nome não tem cor própria. Ele assume a cor do texto da caixa de entrada, então é legível nos modos claro e escuro. A segunda linha e o link de email usam cores de tom médio que são legíveis em ambos.
- A história mostra apenas o que o produto realmente faz. Uma assinatura alcança clientes e investidores, então um recurso ou número inventado nela é uma afirmação falsa em cada email que a equipe envia. Obtenha a história do próprio site ou documentação do produto e obtenha a aprovação do usuário antes de renderizar.
Etapas
1. Configurar uma pasta de trabalho
Use uma pasta fora do repositório do site, para que ferramentas não acabem no site deles:
mkdir email-signature-work && cd email-signature-work
npm init -y
npm i playwright
npx playwright install chromium
Verifique o ffmpeg com ffmpeg -version. Para instalá-lo: no macOS brew install ffmpeg, no Windows winget install Gyan.FFmpeg, no Linux sudo apt install ffmpeg.
Execute todos os comandos abaixo a partir desta pasta. brand.json, o resumo do site, quaisquer imagens recortadas e as saídas ficam todos aqui, ao lado de node_modules.
2. Ler o site
node <pasta da habilidade>/scripts/inspect-site.mjs https://site-deles.com resumo-do-site --pages 6
Ele abre a página inicial e até 6 páginas adicionais (produtos, recursos, sobre, preços primeiro) e escreve resumo-do-site/:
brief.json:pages[]tem o título de cada página, descrição, cabeçalhos, texto principal e rótulos de botões, suapalette(cores rgb realmente usadas, classificadas por quanto da página cobrem, divididas embackground,text,button,link) e suasfonts. Oslogoseimagesde nível superior listam os candidatos. Uma listabuttonvazia ou uma fontesystem-uisignifica que o site não as expôs: pegue o tom das capturas de tela e escolha fontes a olho.screens/: uma captura de tela de cada páginalogos/: cada candidato a logotipo (SVG do cabeçalho ou imagem, ícones de aplicativo, imagem social)images/: as maiores imagens de conteúdo (produtos, pratos, projetos, capturas de tela de aplicativos, pessoas)
brief.json → logos e images listam o tamanho em pixels de cada arquivo (px) e uma note quando é muito pequeno para o cartão ou um banner largo.
Se ele ler apenas uma página, o site provavelmente constrói seus links com scripts ou bloqueia visitas automatizadas. Execute-o novamente com uma página de produto como URL inicial, ou pergunte ao usuário.
Em seguida, olhe realmente, como um designer faria antes de começar:
- Capturas de tela: abra as capturas de tela da página inicial e de uma ou duas páginas de produto. Tenha a sensação (escuro ou claro, lúdico ou sério, fotográfico ou UI plana) e qual cor é o tom da marca. O fundo do botão mais usado geralmente é o tom.
- Logotipos: abra os candidatos a logotipo.
- Um SVG do cabeçalho geralmente é a melhor fonte. Um
apple-touch-iconpode ser uma marca quadrada limpa, mas verifique seupx: muitos sites servem ícones de 32×32, que ficam borrados no cartão. Qualquer coisa anotada como "muito pequeno para o cartão" está fora. - Verifique o que você tem. Uma marca quadrada vai em
logo. Uma marca nominativa larga vai emwordmarke aparece no cartão da marca no lugar do nome digitado. - Sem um logotipo quadrado, o cartão se adapta. Com uma marca nominativa, ele descarta a coluna esquerda, para que o nome não seja mostrado duas vezes. Sem nenhum, ele desenha a primeira letra da marca na cor de destaque.
- Não use um favicon abaixo de 64 px ou um recorte borrado: peça um arquivo ao usuário.
- Logotipos feitos para um cabeçalho branco podem desaparecer em um cartão escuro. Se isso acontecer, use um cartão claro, peça uma versão clara ou edite o preenchimento de um SVG.
- Um SVG do cabeçalho geralmente é a melhor fonte. Um
- Imagens: abra as imagens candidatas para uma cena de vitrine. Pule fotos com aparência de banco de imagens, rostos de pessoas (pergunte primeiro) e qualquer coisa com texto pequeno que não será legível em 168×126.
- O quadro corta para preencher (cerca de 4:3). Banners heróis largos geralmente têm texto e botões incorporados, e cortá-los deixa lascas de letras. Corte você mesmo para o assunto primeiro:
Aquiffmpeg -i resumo-do-site/images/00.png -vf "crop=900:675:500:110" crop-1.pngcrop=w:h:x:yseleciona uma caixa 4:3 ao redor do produto. Então abra o resultado para verificar.
- O quadro corta para preencher (cerca de 4:3). Banners heróis largos geralmente têm texto e botões incorporados, e cortá-los deixa lascas de letras. Corte você mesmo para o assunto primeiro:
- Texto: leia o texto principal e os cabeçalhos. Entenda o que o negócio realmente faz por um cliente, nas palavras deles, e quaisquer números reais que ele declare publicamente (clientes atendidos, pedidos entregues, anos de operação).
Se o site bloquear o script (paywall, proteção contra bots) ou for superficial, peça ao usuário o logotipo, as cores e uma frase sobre o que o negócio faz.
3. Escolher a cena e escrever a história, depois obter aprovação
brand.json → story.type escolhe uma das três cenas. Escolha aquela que mostra este negócio fazendo seu trabalho mais claramente:
| Cena | Adequado para | Campos da história |
|---|---|---|
chat | software, agentes de IA, aplicativos, serviços que respondem ou corrigem algo | question (≤ 32 caracteres), três steps de { text ≤ 34, status: "ok" | "warn" }, result (≤ 28), details (2–3 linhas ≤ 40) |
counter | um número público real: dinheiro manipulado, pedidos enviados, clientes atendidos, anos de operação | label (≤ 40), value (número), prefix/suffix (ex.: "R$", "+", " pedidos"), decimals, result (≤ 28), details |
showcase | lojas, comida, viagens, estúdios, portfólios, produtos físicos: qualquer coisa melhor mostrada do que contada | items: 2–3 de { image: "resumo-do-site/images/03.jpg", title ≤ 22, text ≤ 36 }. Fotos são a parte mais pesada de um GIF: em testes, 2 fotos chegaram a cerca de 790 KB, 3 a cerca de 940 KB e 4 ultrapassaram 1 MB. |
O número de um contador deve ser um que o negócio já declare publicamente (em seu próprio site), com a aprovação do usuário. Nunca invente um. Uma vitrine usa as próprias imagens do negócio de seu site, não imagens de banco.
Para adicionar uma cena diferente (um antes/depois, uma rota de marcador de mapa, uma barra de progresso), adicione uma entrada a SCENES em uma cópia de card.html e renderize com --card seu-card.html. Mantenha as regras em "Por que foi construído assim".
Escreva brand.json (copie assets/brand.example.json; caminhos de imagem são relativos a brand.json):
- Nome, domínio, URLs:
name,domain,siteUrlegifUrl, o endereço absoluto onde o GIF viverá (por exemplohttps://site-deles.com/email/signature.gif). - Texto:
tagline, cerca de cinco palavras dizendo o que o negócio faz. Opcionalmenteemail, o email placeholder mostrado na página da equipe. - Imagens:
logo(uma marca quadrada, opcional) ewordmark(opcional). - Fontes: nomes de famílias do Google Fonts.
brief.jsonlista as fontes do próprio site.- Se essas estiverem no Google Fonts, use-as.
- Se forem proprietárias ou auto-hospedadas, escolha a fonte do Google mais próxima por sensação: um sem arredondado para um sem arredondado, uma serif para uma serif.
- Deixe
fontsde fora para usar fontes do sistema.
- Cores:
colors, construídas a partir da paleta do site:bg: o fundo do cartão. Um tom escuro da marca funciona bem em caixas de entrada claras e não ofusca nas escuras. Um cartão claro também funciona, se o site for claro.card: uma cor de painel ligeiramente diferenteline: bordastext,mutedesubtle: texto, do mais forte ao mais fraco. Eles precisam de contraste claro embg.accent: a cor da marcagoodebad: um verde e um vermelholink: um tom escuro o suficiente para ser legível em uma caixa de entrada branca
Defina story.type para a cena escolhida; o padrão é chat.
Mostre ao usuário o plano antes de renderizar e aguarde a aprovação dele. Inclua a cena, as linhas da história (ou imagens escolhidas com legendas) e qual logotipo você usará.
4. Renderizar e olhar
node <pasta da habilidade>/scripts/render.mjs brand.json signature.gif
Ele imprime o tamanho e linhas PASS, escreve signature-last.png (o final do loop, que deve corresponder ao primeiro quadro), falha se o texto sair da borda, o arquivo tiver mais de 1 MB ou o loop não terminar no primeiro quadro, e escreve signature-first.png, o quadro que o Outlook antigo mostra. Abra essa imagem e dois ou três quadros do meio do loop e verifique:
- nada está cortado na borda direita (texto longo é a causa usual)
- o logotipo está nítido
- as cores são legíveis
- o primeiro quadro é um cartão finalizado
Para extrair um quadro em, digamos, 5 s, execute ffmpeg -ss 5 -i signature.gif -frames:v 1 frame5.png. Corrija e renderize novamente até que passe e pareça correto. Se estiver acima de 1 MB, remova primeiro o movimento de área grande. Reduzir --fps 12 é um último recurso.
Mostre ao usuário o primeiro quadro e um quadro do meio do loop (ou o próprio GIF) antes de prosseguir.
5. Construir a página da equipe
node <pasta da habilidade>/scripts/build-page.mjs brand.json email-signature.html
Para visualizá-la antes da implantação, execute npx serve . na pasta de trabalho e abra http://localhost:3000/email-signature?preview=signature.gif. Deixe de fora .html: serve redireciona endereços .html e descarta a parte ?preview, e a página então tenta o GIF ainda não ao vivo. O parâmetro preview apenas altera o que a página mostra; a assinatura copiada ainda aponta para gifUrl. Teste com um nome longo e com caracteres como < e &, que devem ser mostrados como digitados.
6. Implantar
Leia references/deploy.md. Ele cobre onde os dois arquivos vão para stacks comuns (hospedagens estáticas, Next.js, Astro, WordPress, Webflow e outros), onde hospedar o GIF quando o usuário não puder colocar arquivos no site, a linha robots.txt e o que verificar uma vez que esteja ao vivo. Siga a maneira normal do site de enviar alterações: um branch e pull request se for um repositório git. Não faça push ou implante sem a autorização do usuário.
7. Entregar
Diga ao usuário:
- Links: o endereço da página para compartilhar com a equipe e o endereço do GIF.
- Verificado: o que você mesmo verificou, como as verificações de renderização, os quadros que você olhou e a visualização da página.
- Ainda para verificar após a implantação: colar no Gmail, Outlook e Apple Mail, a partir da lista em
deploy.md. Nada sobre aplicativos de email reais pode ser verificado antes do GIF estar ao vivo, então diga isso claramente em vez de insinuar que funciona. - Atualizar depois: edite
brand.json, renderize novamente e substitua o GIF no mesmo endereço. A assinatura de todos é atualizada por conta própria, embora os caches de imagem do aplicativo de email possam levar um dia ou mais.