CommunityImagemgithub.com

cartão-interativo-de-saudação

Transforma uma imagem e uma mensagem em um cartão de felicitação 3D interativo, um cartão dobrado em WebGL cujo foil ou tinta grossa captura a luz conforme você move, que se abre para a mensagem escrita à mão dentro e vira para o verso, e pode ganhar vida com luzes brilhantes, neve caindo, corações flutuantes e partes que balançam e reagem ao toque. Gera um único arquivo HTML autossuficiente que funciona offline e pode ser enviado ou hospedado em qualquer lugar. Use-o sempre que alguém quiser um cartão de felicitação, e-card ou cartão digital (aniversário, Natal, feriado, Dia dos Namorados, Dia das Mães, agradecimento, casamento, aniversário de casamento, parabéns, melhoras), ou quiser transformar sua própria arte, pintura, ilustração ou foto em um cartão com uma mensagem interna, mesmo que nunca mencionem interativo ou 3D.

O que é cartão-interativo-de-saudação?

Este skill cria cartões de felicitação 3D interativos a partir de qualquer imagem e mensagem, gerando um único arquivo HTML autossuficiente que funciona offline e pode ser enviado ou hospedado em qualquer lugar. O usuário fornece a imagem para a frente e a mensagem interna; o skill automaticamente aplica um acabamento (foil, tinta ou impressão) que reage à luz, e o cartão responde a toques e movimentos do mouse – abrindo, virando e exibindo efeitos como neve, corações, vaga-lumes e estrelas cadentes. Também permite criar animações interativas detalhadas, como lanternas que acendem, caudas que balançam ou galhos que balançam, baseadas em posições na imagem. Os scripts principais incluem `make_card.py` para construir o HTML, `foil_preview.py` para visualizar o foil, `grid.py` para definir posições de efeitos, e `snapshot.mjs` para capturar screenshots. O skill é ideal para cartões personalizados para aniversários, Natal, Dia dos Namorados, casamentos, agradecimentos e outras ocasiões, suportando várias imagens e designs na mesma página.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/annnguyentt/interactive-greeting-card-skill/tree/HEAD/interactive-greeting-card

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Cartão de saudação interativo

Faça um cartão com o qual alguém vai querer brincar: a imagem deles na frente de um cartão dobrado que balança na página, capta uma luz móvel em seu foil ou tinta, abre com um toque para a mensagem em caligrafia e vira para mostrar seu verso. Uma construção rápida transforma uma imagem e algumas configurações em um arquivo HTML com tudo dentro (imagem, fonte, renderizador), que abre direto de um arquivo, funciona offline e vai para qualquer servidor web sem alterações.

O que este skill contém:

  • scripts/make_card.py constrói a página a partir dos dados do cartão (JSON). Ele verifica os dados e explica qualquer erro antes de escrever algo.
  • scripts/grid.py desenha uma grade de pixels rotulada sobre a imagem, cortada exatamente como o cartão corta, para ler posições dela (necessário apenas para efeitos vivos e seleções de cor).
  • scripts/foil_preview.py mostra exatamente o que se torna foil, em magenta, para que você possa ajustar o foil antes da construção (precisa de numpy).
  • scripts/snapshot.mjs (opcional, precisa de Node e Playwright) tira screenshots da frente, do interior e do verso, e com --live mostra o que se move em um cartão vivo e o que cada toque faz.
  • references/options.md lista todas as configurações. references/living-cards.md explica como fazer um cartão ganhar vida. Leia-os quando precisar, não antes.

Como fazer um cartão

1. Obter a imagem e a mensagem

As duas coisas necessárias da pessoa são a imagem para a frente e o que escrever dentro. Se algum estiver faltando, peça, ou ofereça-se para escrever a mensagem (pergunte para quem é e de quem é). Todo o resto tem um padrão sensato, então não faça a pessoa responder a um questionário; escolha bem e mencione as escolhas que fez para que ela possa alterá-las.

Pegue a mensagem como foi dada. Não polir as palavras, a menos que peçam, mas coloque quebras de linha onde um cartão escrito à mão teria (uma saudação em sua própria linha, a despedida no final); uma linha muito longa para a folha quebra sozinha, com cerca de 20 letras. Até cerca de 60 palavras é lido grande e confortável; cartas mais longas são escritas menores, e além do que cabe, o final é cortado, então sugira encurtar uma muito longa.

Várias imagens geram vários cartões em uma página, lidados um após o outro com uma dock para alternar entre eles. Isso é adequado para um conjunto de cartões, ou um cartão em alguns designs para escolher.

2. Olhar a imagem e escolher o acabamento

O acabamento decide como a frente capta a luz. Olhe a imagem antes de escolher:

A imagemAcabamentoNotas
Uma pintura com textura de pincel (óleo, guache, acrílico, aquarela espessa)paintAs próprias pinceladas se destacam e brilham sob a luz. Se tiver tinta dourada, faça-a brilhar também: foil.on: "colour" com o dourado selecionado.
Uma ilustração, arte linear, lettering ou design plano, especialmente em papel lisofoilon: "details" carimba as linhas e detalhes escuros em foil; "colour" carimba uma cor que você escolhe (letras douradas, por exemplo); "darks" carimba as formas mais escuras (silhuetas).
Uma fotoprintImpresso em cartão fosco. Uma border fina de foil emoldura bem. Foil em detalhes de uma foto tende a parecer ruidoso.

Cores de foil: gold (clássico, quente), silver (inverno, casamentos, paletas frias), rose (romance), copper (outono, rústico), pink (brincalhão), holo (holográfico, aniversários). Combine com a paleta da imagem e a ocasião.

Verifique o foil com foil_preview.py antes da construção (depois que os dados do cartão estiverem escritos, etapa 5). O que você pretendia que fosse foil deve sair sólido, e nada mais deve ser capturado. Duas coisas frequentemente precisam disso:

  • O que você quer em foil compartilha sua cor ou escuridão com coisas que não quer, por exemplo, letras douradas acima de flores com centros dourados. Mantenha o foil em uma caixa ao redor com foil.area.
  • O dourado padrão é claro e clássico. Arte desenhada em um dourado muito mais escuro pode ter sua própria tinta, então o foil corresponde.

A seção Foil de references/options.md tem as tintas, o que amount faz em cada modo e area.

Papel (interior, verso e bordas): white, cream, blush, sage, sky, midnight ou qualquer #rrggbb. Se a imagem foi desenhada em papel liso, o cartão pega esse papel por padrão, o que geralmente fica melhor.

O cartão é cortado do centro da imagem para sua forma: portrait (5:7, o padrão), square, landscape (7:5) ou original (a forma da própria imagem, dentro dos limites). Use landscape para imagens largas. Se o assunto estiver perto de uma borda, execute grid.py para ver o que o corte mantém.

3. Adicionar efeitos para a ocasião (opcional)

Estes não precisam de posições, então adicione-os livremente quando combinarem com o cartão:

  • snow: flocos caem sobre a frente (inverno, Natal)
  • hearts: pequenos corações pintados flutuam para fora da imagem de vez em quando (amor, Dia dos Namorados, Dia das Mães, casamentos)
  • fireflies: luzes suaves vagam pela parte inferior (noites de verão, cenas sonhadoras)
  • shootingStars: uma estrela cruza o topo de vez em quando (céus noturnos)
  • sparkle: pontos do foil captam a luz e cintilam (qualquer cartão com foil)

Um ou dois efeitos são suficientes; mais fica confuso.

4. Dar vida a ele (opcional, e a melhor parte)

Um cartão pode fazer muito mais: a lanterna na imagem brilha e tremula e acende quando tocada, o sol lança raios, o rabo de um gato balança e corações sobem dele quando acariciado, galhos balançam e deixam cair sua neve, cachecóis tremulam na brisa do ponteiro. Isso precisa de posições na imagem, que você lê da grade de grid.py. Leia references/living-cards.md e siga-o.

Faça isso quando a pessoa pedir que o cartão seja vivo, animado ou interativo, ou quando a imagem tiver luzes óbvias (velas, lanternas, sol, lua, janelas iluminadas) ou personagens. Leva um tempo, então para um cartão rápido, ofereça como um próximo passo.

5. Escrever os dados do cartão

Salve como JSON ao lado da imagem. Um cartão:

{
  "title": "Feliz aniversário, Ellie",
  "image": "ellie-birthday.jpg",
  "alt": "Uma aquarela de uma raposa em um prado de papoulas.",
  "name": "Raposa e Papoulas",
  "finish": "foil",
  "foil": { "colour": "rose", "on": "details", "amount": 0.12 },
  "paper": "cream",
  "message": "Querida Ellie,\nFeliz aniversário para minha pessoa favorita.\nUm brinde ao seu melhor ano ainda!\nCom amor, Nora",
  "signature": ["Feito com amor por", "Nora"],
  "effects": { "hearts": true, "sparkle": true }
}

alt descreve a frente para leitores de tela; sempre escreva um. name vai no verso como letras pequenas, a menos que back ou signature diga o contrário. Vários cartões vão em "cards": [ {...}, {...} ], com title e page no topo. Todas as configurações estão em references/options.md.

6. Construir

python scripts/make_card.py card.json --check      # verifica os dados, imprime o tamanho do cartão em pixels
python scripts/make_card.py card.json -o card.html

Os caminhos no JSON são relativos ao arquivo JSON. Para um cartão rápido, há também um formulário de uma linha:

python scripts/make_card.py --image front.jpg --message "Feliz aniversário!" --finish foil --foil gold -o card.html

Se o script reportar um erro, ele diz o que está errado e como corrigir. Avisos (mensagem faltando, configuração desconhecida, posição fora do cartão) ainda constroem, mas corrija-os.

7. Verificar

Se Node e Playwright estiverem disponíveis, olhe o cartão antes de entregá-lo:

node scripts/snapshot.mjs card.html shots/
node scripts/snapshot.mjs card.html shots/ --live   # um cartão que ganha vida: também verifica o que se move

Isso escreve a frente, a frente com a luz sobre ela (front-lit: o foil ou tinta captando a luz), o interior e o verso como PNGs. Olhe para eles: a mensagem é fácil de ler, o foil parece carimbado em vez de pontilhado, a imagem foi cortada onde você esperava? Ajuste e reconstrua; cada rodada é rápida. Sem um navegador, diga claramente que não pôde pré-visualizar (a pré-visualização do foil ainda funciona).

8. Entregar

Dê à pessoa o arquivo HTML e diga como usá-lo:

  • Abra em qualquer navegador para ver o cartão. Toque nele (ou pressione O) para abri-lo; arraste para o lado (ou pressione T) para virá-lo.
  • Para enviar, coloque online e compartilhe o link: GitHub Pages, Netlify Drop ou qualquer host estático aceita o arquivo como está. Ou envie o próprio arquivo; funciona offline.
  • Tem um a dois megabytes, quase tudo a imagem.

Mencione o que você escolheu (acabamento, foil, papel, efeitos) em uma frase, para que possam pedir alterações.

Bom saber

  • Fotos de celular são viradas para a orientação correta e imagens grandes são reduzidas (com Pillow). Áreas transparentes tornam-se brancas. Fotos HEIC precisam ser convertidas para JPEG primeiro, a menos que o Pillow possa lê-las.
  • A caligrafia é Caveat, incorporada na página. Cobre latim, latim estendido e cirílico; outros scripts (vietnamita, grego, CJK) recaem para a fonte de caligrafia do dispositivo.
  • Sem WebGL, a página ainda mostra a imagem e a mensagem, planas.
  • A página é temática clara por design: o cartão fica sobre branco com sombras suaves.
  • Para mudar como os cartões parecem ou se comportam além dessas configurações, o código-fonte do renderizador está no repositório GitHub do skill (renderer/), e reconstruí-lo substitui assets/greeting-card.js.

Habilidades Relacionadas