Communitygithub.com

Abduovv/Arcadia-frontend

Corrigez les pages qui se chargent d'un coup. Recettes framer-motion prêtes pour la production : entrées chorégraphiées, listes décalées, transitions modales, fondus de filtres, animations de données en direct et micro-interactions.

Qu'est-ce que Arcadia-frontend ?

Cette compétence résout le problème le plus courant dans les interfaces utilisateur crypto : des pages où tout apparaît en même temps, sans chorégraphie, décalage ni physique de ressort, donnant une impression de dysfonctionnement même quand le code est correct. Elle fournit des recettes framer-motion de production qui implémentent des animations d'entrée de page, des listes décalées, des transitions de modales, des fondus de filtres, des animations de données en direct et des micro-interactions. La compétence est conçue pour fonctionner avec des outils d'IA comme Claude Code ou Cursor, et s'intègre avec `frontend-design-guidelines` (qui délègue le travail framer-motion à cette compétence), `number-formatting` (pour l'affichage des nombres en direct) et `brand-design` (pour les couleurs d'animation). Le workflow inclut trois modes : construction de nouvelles animations, revue de code existant (avec détection d'anti-patrons) et consultation rapide de configurations de ressort. Les non-négociables incluent le commentaire ASCII storyboard, les constantes de timing nommées, la physique de ressort par défaut, le séquencement piloté par une seule variable d'état entière, et le respect de `prefers-reduced-motion`.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Abduovv/Arcadia-frontend/tree/HEAD/.agents/skills/page-load-animations

Demander à votre IA préférée

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

Documentation

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-guidelines dé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 :

Chargez uniquement ce dont vous avez besoin. Ne lisez pas toutes les références à l'avance.

Mode 1 : Construction de nouvelles animations

  1. Lisez le(s) fichier(s) de référence pertinent(s) pour le modèle dont vous avez besoin.
  2. Commencez par le commentaire ASCII storyboard — planifiez la séquence complète avant d'écrire du code.
  3. Définissez un objet TIMING avec des constantes nommées pour chaque délai.
  4. Implémentez en utilisant les modèles de la référence. Utilisez la physique de ressort par défaut.
  5. Vérifiez les non-négociables ci-dessous avant de signaler comme terminé.

Mode 2 : Revue de code d'animation existant

  1. 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
    
  2. Pour chaque problème trouvé, référez-vous à la règle d'anti-patron spécifique du fichier de référence pertinent.
  3. 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

  1. 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.
  2. Constantes de timing nommées. Chaque délai va dans un objet TIMING en haut du fichier. Pas de nombres magiques dans setTimeout ou les props delay.
  3. 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.
  4. Séquencement piloté par étape. Une seule variable d'état entière pilote les séquences multi-sections. Pas de booléens dispersés.
  5. Modèle stage >= N. Les sections restent visibles une fois apparues. Jamais stage === N.
  6. Jamais layout à la fois sur parent ET enfants. C'est la cause n°1 des animations de filtre saccadées. Utilisez AnimatedHeight avec ResizeObserver à la place.
  7. Jamais staggerChildren avec AnimatePresence. Cela ne fonctionne pas de manière fiable. Utilisez delay: i * stagger manuel.
  8. Respectez prefers-reduced-motion. Hérité de animation.md. Chaque animation doit se dégrader gracieusement.
  9. 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

  1. Storyboard d'abord — planifiez la séquence avant d'écrire du code
  2. Ressort d'abord — physique de ressort plutôt qu'assouplissement basé sur la durée
  3. Constantes nommées — chaque valeur de timing est déclarée, pas en ligne
  4. Piloté par étape — une seule variable d'état entière orchestre les séquences complexes
  5. 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
  6. Mesurez, ne devinez pas — ResizeObserver pour 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 de animation.md sont autoritaires pour les contraintes ; cette compétence est autoritaire pour les recettes d'implémentation.
  • number-formatting — pour les affichages de nombres en direct, utilisez number-formatting pour 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés