CommunityImagegithub.com

carte-de-voeux-interactive

Transforme une photo et un message en une carte de vœux 3D interactive, une carte pliée en WebGL dont le foil ou la peinture épaisse accroche la lumière lorsque vous bougez, qui s'ouvre au message écrit à la main à l'intérieur et se retourne sur son dos, et peut s'animer avec des lumières lumineuses, de la neige, des cœurs flottants et des parties qui oscillent et réagissent à un tapotement. Produit un fichier HTML autonome qui fonctionne hors ligne et peut être envoyé ou hébergé n'importe où. Utilisez-le chaque fois que quelqu'un souhaite une carte de vœux, une e-carte ou une carte numérique (anniversaire, Noël, fête, Saint-Valentin, fête des Mères, remerciement, mariage, anniversaire de mariage, félicitations, rétablissement), ou souhaite transformer sa propre œuvre d'art, peinture, illustration ou photo en carte avec un message à l'intérieur.

Qu'est-ce que carte-de-voeux-interactive ?

Cette compétence permet de créer une carte de vœux interactive et 3D à partir d'une image et d'un message, le tout dans un seul fichier HTML autonome. Elle transforme l'image de couverture en une carte pliée virtuelle, avec des finitions comme du foil (or, argent, rose, etc.) ou de la peinture qui accroche la lumière en temps réel via WebGL. La carte s'ouvre d'un tapotement pour révéler un message manuscrit, peut se retourner pour montrer son dos, et peut être animée avec des effets comme de la neige, des cœurs, des lucioles, ou des interactions complexes (lumières qui brillent, queues qui remuent). La compétence est conçue pour les développeurs et les créateurs : elle génère un fichier HTML unique, prêt à être hébergé sur GitHub Pages, Netlify ou envoyé directement, et fonctionne hors ligne. Elle inclut des scripts Python pour construire la carte, vérifier les données, prévisualiser le foil, et prendre des captures d'écran. Elle supporte plusieurs formats d'image, plusieurs cartes sur une même page, et une personnalisation fine via un fichier JSON. Les effets avancés nécessitent de positionner des éléments sur l'image à l'aide d'une grille, mais les effets simples (neige, cœurs) sont faciles à ajouter. La documentation complète (options, cartes animées) est fournie en référence.

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

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

Demander à votre IA préférée

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

Documentation

Carte de vœux interactive

Créez une carte avec laquelle on aura envie de jouer : leur photo sur la couverture d'une carte pliée qui se balance dans la page, accroche une lumière mobile dans son foil ou sa peinture, s'ouvre d'un tapotement sur leur message en écriture manuscrite, et se retourne pour montrer son dos. Une courte construction transforme une image et quelques réglages en un seul fichier HTML contenant tout (image, police, moteur de rendu), qui s'ouvre directement depuis un fichier, fonctionne hors ligne et se place sur n'importe quel hébergeur web sans modification.

Ce que contient cette compétence :

  • scripts/make_card.py construit la page à partir des données de la carte (JSON). Il vérifie les données et explique toute erreur avant d'écrire quoi que ce soit.
  • scripts/grid.py dessine une grille de pixels étiquetée sur l'image, coupée exactement comme la carte la coupe, pour lire les positions (nécessaire uniquement pour les effets animés et les choix de couleurs).
  • scripts/foil_preview.py montre exactement ce qui devient du foil, en magenta, pour ajuster le foil avant la construction (nécessite numpy).
  • scripts/snapshot.mjs (optionnel, nécessite Node et Playwright) prend des captures d'écran du recto, de l'intérieur et du dos, et avec --live montre ce qui bouge sur une carte animée et ce que fait chaque tapotement.
  • references/options.md liste tous les réglages. references/living-cards.md explique comment faire vivre une carte. Lisez-les quand vous en avez besoin, pas avant.

Comment faire une carte

1. Obtenir l'image et le message

Les deux choses nécessaires de la personne sont l'image pour le recto et quoi écrire à l'intérieur. Si l'un manque, demandez-le, ou proposez d'écrire le message pour eux (demandez à qui c'est destiné, et de la part de qui). Tout le reste a une valeur par défaut raisonnable, donc ne leur faites pas remplir un questionnaire ; choisissez bien et mentionnez les choix effectués pour qu'ils puissent les modifier.

Prenez le message tel qu'il est donné. Ne polissez pas leurs mots sauf s'ils le demandent, mais insérez des sauts de ligne là où une carte manuscrite en aurait (un souhait sur sa propre ligne, la formule de politesse à la fin) ; une ligne trop longue pour la feuille se coupe automatiquement, à environ 20 lettres. Jusqu'à environ 60 mots, le texte est large et confortable ; les lettres plus longues sont écrites plus petites, et au-delà de ce qui tient, la fin est coupée, donc suggérez de raccourcir un message très long.

Plusieurs images donnent plusieurs cartes sur une même page, présentées l'une après l'autre avec un dock pour passer de l'une à l'autre. Cela convient à un ensemble de cartes, ou à une carte en plusieurs designs au choix.

2. Regarder l'image et choisir la finition

La finition détermine comment le recto accroche la lumière. Regardez l'image avant de choisir :

L'imageFinitionNotes
Une peinture avec texture de pinceau (huile, gouache, acrylique, aquarelle épaisse)paintLes coups de pinceau se dressent et brillent sous la lumière. Si elle contient de la peinture dorée, faites-la briller aussi : foil.on: "colour" avec l'or sélectionné.
Une illustration, un dessin au trait, un lettrage ou un design plat, surtout sur papier unifoilon: "details" marque les lignes et les détails sombres en foil ; "colour" marque une couleur de votre choix (lettrage doré, par exemple) ; "darks" marque les formes les plus sombres (silhouettes).
Une photoprintImprimée sur carton mat. Un fin border en foil l'encadre joliment. Le foil sur les détails d'une photo a tendance à être bruyant.

Couleurs de foil : gold (classique, chaud), silver (hiver, mariages, palettes froides), rose (romance), copper (automne, rustique), pink (espiègle), holo ( holographique, anniversaires). Associez à la palette de l'image et à l'occasion.

Vérifiez le foil avec foil_preview.py avant la construction (une fois les données de la carte écrites, étape 5). Ce que vous vouliez voir en foil doit être solide, et rien d'autre ne doit être capturé. Deux choses nécessitent souvent une correction :

  • Ce que vous voulez en foil partage sa couleur ou son obscurité avec des éléments que vous ne voulez pas, par exemple un lettrage doré au-dessus de fleurs avec des centres dorés. Limitez le foil à une zone autour avec foil.area.
  • L'or standard est pâle et classique. Une œuvre d'art dessinée dans un or beaucoup plus profond peut avoir sa propre encre, pour que le foil corresponde.

La section Foil de references/options.md décrit les encres, ce que amount fait dans chaque mode, et area.

Papier (l'intérieur, le dos et les bords) : white, cream, blush, sage, sky, midnight ou tout #rrggbb. Si l'image est dessinée sur du papier uni, la carte prend ce papier par défaut, ce qui donne généralement le meilleur résultat.

La carte est découpée au milieu de l'image selon sa forme : portrait (5:7, par défaut), square, landscape (7:5), ou original (la propre forme de l'image, dans certaines limites). Utilisez landscape pour les images larges. Si le sujet se trouve près d'un bord, exécutez grid.py pour voir ce que la découpe conserve.

3. Ajouter des effets pour l'occasion (optionnel)

Ceux-ci ne nécessitent pas de positions, donc ajoutez-les librement quand ils conviennent à la carte :

  • snow : des flocons dérivent sur le recto (hiver, Noël)
  • hearts : de petits cœurs peints flottent de temps en temps au-dessus de l'image (amour, Saint-Valentin, fête des Mères, mariages)
  • fireflies : des lumières douces errent dans la partie inférieure (nuits d'été, scènes rêveuses)
  • shootingStars : une étoile filante traverse le haut de temps en temps (ciels nocturnes)
  • sparkle : des points du foil accrochent la lumière et scintillent (toute carte en foil)

Un ou deux effets suffisent ; plus devient chargé.

4. Donner vie à la carte (optionnel, et la meilleure partie)

Une carte peut faire bien plus : la lanterne dans l'image brille, vacille et s'embrase lorsqu'on tapote, le soleil projette des rayons, une queue de chat se balance et des cœurs s'élèvent lorsqu'on le caresse, les branches se balancent et perdent leur neige, les écharpes flottent dans la brise du pointeur. Cela nécessite des positions sur l'image, que vous lisez sur la grille de grid.py. Lisez references/living-cards.md et suivez-le.

Faites-le lorsque la personne demande que la carte soit vivante, animée ou interactive, ou lorsque l'image a des lumières évidentes (bougies, lanternes, le soleil, la lune, fenêtres éclairées) ou des personnages. Cela prend du temps, donc pour une carte rapide, proposez-le comme une prochaine étape.

5. Écrire les données de la carte

Enregistrez-les en JSON à côté de l'image. Une carte :

{
  "title": "Joyeux anniversaire, Julie",
  "image": "julie-anniversaire.jpg",
  "alt": "Une aquarelle d'un renard dans un pré de coquelicots.",
  "name": "Renard et Coquelicots",
  "finish": "foil",
  "foil": { "colour": "rose", "on": "details", "amount": 0.12 },
  "paper": "cream",
  "message": "Chère Julie,\nJoyeux anniversaire à ma personne préférée.\nÀ ta meilleure année !\nAvec tout mon amour, Nora",
  "signature": ["Fabriqué avec amour par", "Nora"],
  "effects": { "hearts": true, "sparkle": true }
}

alt décrit le recto pour les lecteurs d'écran ; écrivez-en toujours un. name apparaît au dos en petits caractères sauf si back ou signature indique le contraire. Plusieurs cartes sont placées dans "cards": [ {...}, {...} ], avec title et page en haut. Tous les réglages sont dans references/options.md.

6. Construire la carte

python scripts/make_card.py carte.json --check      # vérifie les données, affiche la taille en pixels de la carte
python scripts/make_card.py carte.json -o carte.html

Les chemins dans le JSON sont relatifs au fichier JSON. Pour une carte rapide, il existe aussi une forme en une ligne :

python scripts/make_card.py --image recto.jpg --message "Joyeux anniversaire !" --finish foil --foil gold -o carte.html

Si le script signale une erreur, il dit ce qui ne va pas et comment le corriger. Les avertissements (message manquant, réglage inconnu, position hors carte) construisent quand même, mais corrigez-les.

7. Vérifier la carte

Si Node et Playwright sont disponibles, regardez la carte avant de la remettre :

node scripts/snapshot.mjs carte.html captures/
node scripts/snapshot.mjs carte.html captures/ --live   # une carte animée : vérifie aussi ce qui bouge

Ceci écrit le recto, le recto avec la lumière maintenue dessus (front-lit : le foil ou la peinture accrochant la lumière), l'intérieur et le dos en PNG. Regardez-les : le message est-il facile à lire, le foil semble-t-il estampé plutôt que tacheté, la découpe de l'image est-elle là où vous l'attendiez ? Ajustez et reconstruisez ; chaque itération est rapide. Sans navigateur, dites clairement que vous n'avez pas pu prévisualiser (l'aperçu du foil fonctionne toujours).

8. Remettre la carte

Donnez à la personne le fichier HTML et dites-lui comment l'utiliser :

  • Ouvrez-le dans n'importe quel navigateur pour voir la carte. Tapotez-la (ou appuyez sur O) pour l'ouvrir ; faites-la glisser sur le côté (ou appuyez sur T) pour la retourner.
  • Pour l'envoyer, mettez-la en ligne et partagez le lien : GitHub Pages, Netlify Drop ou tout hébergeur statique accepte le fichier tel quel. Ou envoyez le fichier lui-même ; il fonctionne hors ligne.
  • Il pèse un à deux mégaoctets, presque entièrement pour l'image.

Mentionnez ce que vous avez choisi (finition, foil, papier, effets) en une phrase, afin qu'ils puissent demander des modifications.

Bon à savoir

  • Les photos de téléphone sont redressées et les grandes images sont rétrécies (avec Pillow). Les zones transparentes deviennent blanches. Les photos HEIC doivent être converties en JPEG d'abord, à moins que Pillow ne puisse les lire.
  • L'écriture manuscrite est Caveat, intégrée dans la page. Elle couvre le latin, le latin étendu et le cyrillique ; les autres écritures (vietnamien, grec, CJK) utilisent la police manuscrite par défaut de l'appareil.
  • Sans WebGL, la page affiche toujours l'image et le message, à plat.
  • La page est conçue en thème clair : la carte repose sur un fond blanc avec des ombres douces.
  • Pour modifier l'apparence ou le comportement des cartes au-delà de ces réglages, le code source du moteur de rendu se trouve dans le dépôt GitHub de la compétence (renderer/), et sa reconstruction remplace assets/greeting-card.js.

Skills associés