Préambule (à exécuter en premier)
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
_TEL_TIER="${_TEL_TIER:-anonymous}"
_TEL_PROMPTED=$([ -f ~/.superstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
mkdir -p ~/.superstack
echo "TELEMETRY: $_TEL_TIER"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
if [ "$_TEL_TIER" != "off" ]; then
_TEL_EVENT='{"skill":"page-load-animations","phase":"build","event":"started","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}'
echo "$_TEL_EVENT" >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
_CONVEX_URL=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"convexUrl":"[^"]*"' | head -1 | cut -d'"' -f4 || echo "")
[ -n "$_CONVEX_URL" ] && curl -s -X POST "$_CONVEX_URL/api/mutation" -H "Content-Type: application/json" -d '{"path":"telemetry:track","args":{"skill":"page-load-animations","phase":"build","status":"success","version":"0.2.0","platform":"'$(uname -s)-$(uname -m)'","timestamp":'$(date +%s)000'}}' >/dev/null 2>&1 &
true
fi
Si TEL_PROMPTED est no : Avant de commencer le workflow de la compétence, demandez à l'utilisateur au sujet de la télémétrie.
Utilisez AskUserQuestion :
Aidez superstack à s'améliorer ! Nous suivons les compétences utilisées et leur durée — pas de code, pas de chemins de fichiers, pas de données personnelles. Modifiable à tout moment dans
~/.superstack/config.json.
Options :
- A) Oui, aider superstack à s'améliorer (anonyme)
- B) Non merci
Si A : exécutez ce bash :
echo '{"telemetryTier":"anonymous"}' > ~/.superstack/config.json
_TEL_TIER="anonymous"
touch ~/.superstack/.telemetry-prompted
Si B : exécutez ce bash :
echo '{"telemetryTier":"off"}' > ~/.superstack/config.json
_TEL_TIER="off"
touch ~/.superstack/.telemetry-prompted
Cela n'arrive qu'une seule fois. Si TEL_PROMPTED est yes, ignorez cela entièrement et passez au workflow de la compétence.
Mauvaise compétence ? Voir SKILL_ROUTER.md pour toutes les compétences disponibles.
Animations de chargement de page
Modèles adaptés de recettes framer-motion éprouvées en production. Inspiration originale : suzi-ux-motions.
Recettes framer-motion de production pour rendre les chargements de page intentionnels plutôt que chaotiques. Cette compétence existe parce que le problème d'animation le plus courant dans les interfaces crypto n'est pas l'absence d'animation — c'est le fait que tout apparaît en même temps, sans chorégraphie, décalage ni physique de ressort. Le résultat donne l'impression d'un dysfonctionnement même lorsque le code est correct.
Cette compétence fournit les recettes d'implémentation. Pour la théorie de l'animation (quand animer, paliers de durée, courbes d'assouplissement, mouvement réduit), voir frontend-design-guidelines/references/animation.md. Cette compétence hérite de toutes ces contraintes de base.
Modèle d'autorité
animation.md= contraintes de base (paliers de durée, assouplissement, mouvement réduit, propriétés GPU)- Cette compétence = recettes de production qui implémentent dans ces contraintes
frontend-design-guidelinesdélègue À cette compétence pour les modèles framer-motion, pas l'inverse
Configuration
npm install framer-motion
Les transitions CSS sont la valeur par défaut pour les changements d'état simples (selon animation.md). Utilisez framer-motion lorsque vous avez besoin de : physique de ressort, séquences orchestrées, animations de sortie AnimatePresence, gestes/glisser, ou transitions de mise en page partagées.
Quand déclencher cette compétence
Appliquez ces recettes à chaque fois que vous :
- Construisez une page qui charge plusieurs sections (tableau de bord, écran de détail, page d'accueil)
- Décalez une liste, une grille de cartes ou un tableau au montage
- Animez une modale, un menu déroulant ou une popover
- Changez d'onglets ou de filtres avec changement de contenu et de hauteur
- Affichez des nombres, graphiques ou diagrammes en direct
- Ajoutez un retour au survol, une rotation de chevron ou une entrée d'infobulle
- Relisez du code framer-motion existant pour des anti-patrons
- Un utilisateur dit "la page semble saccadée" ou "tout apparaît en même temps"
Si vous construisez un composant au niveau page et que cette compétence n'a pas été déclenchée, déclenchez-la vous-même.
Workflow
Avant d'écrire du code d'animation, identifiez quel fichier de référence est pertinent et lisez-le :
- Orchestrer une entrée de page → references/page-choreography.md
- Décaler une liste ou une grille de cartes → references/list-stagger.md
- Animer une modale, un menu déroulant ou une popover → references/popups-modals.md
- Changer d'onglets/filtres avec changements de hauteur → references/filter-transitions.md
- Nombres défilants, morphing de graphiques, révélations de donuts → references/live-data.md
- Retour au survol, rotation de chevron, infobulles → references/hover-micro.md
- Rechercher un préréglage de ressort ou une courbe d'assouplissement → references/spring-presets.md
Chargez uniquement ce dont vous avez besoin. Ne lisez pas toutes les références à l'avance.
Mode 1 : Construction de nouvelles animations
- Lisez le(s) fichier(s) de référence pertinent(s) pour le modèle dont vous avez besoin.
- Commencez par le commentaire ASCII storyboard — planifiez la séquence complète avant d'écrire du code.
- Définissez un objet TIMING avec des constantes nommées pour chaque délai.
- Implémentez en utilisant les modèles de la référence. Utilisez la physique de ressort par défaut.
- Vérifiez les non-négociables ci-dessous avant de signaler comme terminé.
Mode 2 : Revue de code d'animation existant
- Scannez les anti-patrons courants :
# layout sur parent ET enfants (source de saccades) grep -rn "layout" --include="*.tsx" --include="*.jsx" | head -20 # staggerChildren avec AnimatePresence (peu fiable) grep -rn "staggerChildren" --include="*.tsx" --include="*.jsx" | head -10 # transition-all (anime des propriétés non désirées) grep -rn "transition-all\|transition: all" --include="*.tsx" --include="*.css" | head -10 # Gestion de mouvement réduit manquante grep -rn "motion\.\|animate=" --include="*.tsx" -l | while read f; do grep -L "reduced-motion\|useReducedMotion\|motion-safe" "$f"; done | head -10 - Pour chaque problème trouvé, référez-vous à la règle d'anti-patron spécifique du fichier de référence pertinent.
- Fournissez des corrections exactes de code.
Mode 3 : Consultation rapide
Si l'utilisateur demande "quelle configuration de ressort pour X ?" ou "comment animer Y ?", répondez directement à partir des fichiers de référence et des préréglages de ressort sans exécuter un workflow complet.
Non-négociables
- Commentaire ASCII storyboard. Chaque page animée commence par un commentaire chronologique montrant la séquence complète en un coup d'œil. Les temps sont absolus depuis le montage, alignés à droite.
- Constantes de timing nommées. Chaque délai va dans un objet TIMING en haut du fichier. Pas de nombres magiques dans
setTimeoutou les propsdelay. - Ressort en premier. Préférez la physique de ressort à l'assouplissement basé sur la durée pour un mouvement naturel et interruptible. Utilisez la durée uniquement pour les fondus et les infobulles.
- Séquencement piloté par étape. Une seule variable d'état entière pilote les séquences multi-sections. Pas de booléens dispersés.
- Modèle
stage >= N. Les sections restent visibles une fois apparues. Jamaisstage === N. - Jamais
layoutà la fois sur parent ET enfants. C'est la cause n°1 des animations de filtre saccadées. UtilisezAnimatedHeightavecResizeObserverà la place. - Jamais
staggerChildrenavecAnimatePresence. Cela ne fonctionne pas de manière fiable. Utilisezdelay: i * staggermanuel. - Respectez
prefers-reduced-motion. Hérité deanimation.md. Chaque animation doit se dégrader gracieusement. - Distinction montage vs mise à jour. Les animations de montage sont dramatiques (600 ms, assouplissement expressif). Les animations de mise à jour sont subtiles (150 ms, assouplissement lisse). Phases différentes, configurations différentes.
Principes de conception
- Storyboard d'abord — planifiez la séquence avant d'écrire du code
- Ressort d'abord — physique de ressort plutôt qu'assouplissement basé sur la durée
- Constantes nommées — chaque valeur de timing est déclarée, pas en ligne
- Piloté par étape — une seule variable d'état entière orchestre les séquences complexes
- Piloté par les données — les éléments répétés utilisent
.map()avec des délais basés sur l'index, pas des blocs copiés-collés - Mesurez, ne devinez pas —
ResizeObserverpour les hauteurs dynamiques, jamais de hauteurs en pixels codées en dur
Intégration avec d'autres compétences
frontend-design-guidelines— la compétence UI générale. Elle délègue le travail framer-motion à cette compétence. Quand les deux sont déclenchées, les règles de base deanimation.mdsont autoritaires pour les contraintes ; cette compétence est autoritaire pour les recettes d'implémentation.number-formatting— pour les affichages de nombres en direct, utiliseznumber-formattingpour la spécification de formatage et cette compétence pour le modèle d'animation de chiffres défilants.brand-design— les couleurs de la marque peuvent affecter les choix de couleurs d'animation (indicateurs positifs/négatifs, surbrillances d'accent).
Ressources
references/
- references/page-choreography.md — Entrée de page pilotée par étape avec storyboards ASCII, objets TIMING, configurations de section, préréglages de ressort et le modèle
stage >= N - references/list-stagger.md — Délais de décalage basés sur l'index, wrapper StaggerItem, directives de timing/décalage et anti-patrons
- references/popups-modals.md — Animation de modale à trois couches (fond, panneau, décalage de contenu), modèle de menu déroulant, comportements de fermeture
- references/filter-transitions.md — AnimatedHeight avec ResizeObserver, fondu croisé avec wrapper à clé, anti-patron critique
layout - references/live-data.md — Chiffres défilants (machine à sous), révélations SVG de donuts, morphing de graphiques, gestion de phase montage vs mise à jour
- references/hover-micro.md — Matrice de décision CSS vs framer-motion, retour au survol, rotation de chevron, entrée d'infobulle, retour de copie
- references/spring-presets.md — Tous les préréglages sous forme de tableaux + JSON : configurations de ressort, courbes d'assouplissement, valeurs de décalage, préréglages de durée
Références inter-compétences
frontend-design-guidelines/references/animation.md— contraintes de base dont cette compétence hérite (paliers de durée, assouplissement, mouvement réduit, propriétés GPU)number-formatting— pour les règles d'affichage des nombres (formatage, pas d'animation)
Démarrage rapide
# Déclencheurs :
# "Corrige le chargement de ma page — tout apparaît en même temps"
# "Ajoute des animations d'entrée à ce tableau de bord"
# "L'animation de la modale semble saccadée"
# "Comment décaler ces cartes ?"
# "Quelle configuration de ressort utiliser pour un menu déroulant ?"
# "Ajoute une animation de chiffres défilants à l'affichage du solde"
# Se déclenche automatiquement lors de la construction de composants au niveau page
Télémétrie (à exécuter en dernier)
Après la fin du workflow de la compétence (succès, erreur ou abandon), enregistrez l'événement de télémétrie.
Déterminez le résultat à partir du résultat du workflow : success si terminé normalement, error
s'il a échoué, abort si l'utilisateur a interrompu.
Exécutez ce bash :
_TEL_END=$(date +%s)
_TEL_DUR=$(( _TEL_END - ${_TEL_START:-$_TEL_END} ))
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
if [ "$_TEL_TIER" != "off" ]; then
echo '{"skill":"page-load-animations","phase":"build","event":"completed","outcome":"OUTCOME","duration_s":"'"$_TEL_DUR"'","session":"'"$_SESSION_ID"'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","platform":"'$(uname -s)-$(uname -m)'"}' >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
true
fi
Remplacez OUTCOME par success/error/abort selon le résultat du workflow.