Communitygithub.com

kubai-book-cards

Les cartes s'ouvrent comme un livre au survol ou au focus, révélant des pages intérieures, et restent identiques au repos. Propose trois styles : carte standard, livre relié imitation et document minimaliste. Idéal pour documentation, bases de connaissances, portfolios et places de marché de templates.

Qu'est-ce que kubai-book-cards ?

Cette compétence transforme des cartes d'interface utilisateur en éléments interactifs qui s'ouvrent comme un livre lorsqu'on les survole ou qu'on les met au focus, révélant un contenu de pages intérieur, tout en restant parfaitement identiques visuellement au repos. Elle est conçue pour les développeurs et designers utilisant des agents IA comme Claude Code, Cursor ou Codex, et s'intègre directement dans les projets existants en modifiant les composants de carte déjà présents. La compétence propose trois styles visuels distincts : des cartes produit ordinaires (par défaut), une version imitation reliure (skeuomorphic) avec grain de tissu et ombres chaudes, et un style document minimaliste avec typographie monospace et diagrammes discrets. Elle offre de nombreuses options de personnalisation : intensité de l'ouverture (de subtile à dramatique), nombre de pages, charnière (gauche, droite, haut), déclencheur (survol, pression, défilement), type de contenu des pages, et comportement de l'ombre et de l'animation. La mise en œuvre est technique mais bien documentée, avec une gestion précise des calques en 3D, des ombres portées pré-floutées pour éviter les animations coûteuses, et une attention particulière à l'accessibilité (aria-hidden sur les pages décoratives, navigation clavier) ainsi qu'aux performances (animation via transform/opacity uniquement, boucle requestAnimationFrame optimisée).

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-book-cards

Demander à votre IA préférée

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

Documentation

Cartes qui s'ouvrent comme un livre au survol

999 petits trucs pour donner plus de style à votre produit · Épisode 006 · @kubai087

Appliquez les modifications suivantes dans le projet de l'utilisateur. Les consignes sont rédigées à la première personne (je, me, mon) pour correspondre à la voix de l'utilisateur ; lorsque le texte dit « demandez d'abord », arrêtez-vous et interrogez l'utilisateur avant de continuer.

Consignes de transformation

Faites en sorte que les cartes de mon produit s'ouvrent légèrement, comme un livre, lorsqu'on les survole. Au repos, une carte doit ressembler exactement à ce qu'elle est aujourd'hui ; seul le survol ou le focus révèle qu'il s'agit d'un petit livre avec des pages à l'intérieur.

0. Partir de l'existant

  • Trouvez le composant de carte dont je donne le nom (ou celui utilisé dans la grille ou la liste que je désigne) et adaptez-le sur place. Réutilisez son balisage, ses tokens de design, son rayon, son ombre et ses utilitaires de mouvement ou de ressort.
  • Conservez l'empreinte, le padding, le contenu et la disposition de la carte. Rien autour de la carte ne doit bouger.
  • Si je demande de nouvelles cartes, construisez une carte carrée neuve (environ 280 × 280) dans le style que je choisis ci-dessous.
  • Toute option que je ne renseigne pas utilise la valeur par défaut marquée *.

1. Choisir un style

Par défaut* : cartes produit ordinaires, identiques aux cartes normales jusqu'au survol.

  • Surface : blanc uni (ou mon token de surface de carte), sans texture.
  • Bord : un filet de 1 px dans ma couleur de bordure.
  • Ombre : claire, gris neutre froid, demi-intensité.
  • Typographie : la police sans sérif du produit. Titre 24/600, description 15 atténuée, méta 14 atténuée.
  • Couverture : l'interface utilisateur de la carte existante : une vignette d'icône de 48 px, une flèche ↗ en haut à droite, titre, description, et un pied de page méta sous un filet.
  • Mur : mon fond de page normal.
  • Pages : blanc, une légère teinte vers le dos, un petit titre et 4 à 6 lignes de texte gris.

Imitation reliure : livres reliés sur un mur de galerie.

  • Surface : fine texture de toile de reliure sur une couleur de couverture profonde.
  • Bord : un biseau éclairé : bord supérieur vif, pied plus foncé.
  • Ombre : chaude, gris quasi neutre (jamais orange), pleine intensité.
  • Typographie : un titre sérif, en bas à gauche. Rien d'autre sur la couverture.
  • Couverture : une image à fond perdu ou une scène ASCII animée, avec un léger brillant en haut et une ombre en bas.
  • Mur : plâtre chaud avec un grain fin et un spot sur chaque livre.
  • Pages : papier crème avec grain, un titre de chapitre en italique, des lignes justifiées, et de fines tranches le long du bord de devant.

Minimaliste : volumes de documentation.

  • Surface : blanc cassé uni, gris clair ou graphite, un ton par carte.
  • Bord : un léger biseau ou filet.
  • Ombre : gris neutre froid.
  • Typographie : un numéro de section et une version en monospace en haut, au-dessus d'un filet ; un titre sans sérif sur deux lignes et une petite étiquette grise en bas.
  • Couverture : un petit diagramme gris avec un seul élément dans la couleur d'encre.
  • Mur : gris froid avec une grille de points de 24 px à peine visible et une lumière douce venant d'en haut.
  • Pages : blanc froid, un titre sans sérif et des lignes grises.

Correspondre à mon produit : prenez la surface, le bord, l'ombre, la typographie et le mur de mes tokens, et gardez la couverture exactement telle que la carte est aujourd'hui.

2. Options (les valeurs par défaut sont marquées *)

  • Intensité : subtile (A = 24°) | livre* (A = 42°) | dramatique (A = 60°).
  • Pages : 2 | 3 | 4* | 6.
  • Charnière : gauche* | droite | haut.
  • Déclencheur : survol* | pression (ouvert tant qu'on appuie) | défilement dans la vue (s'ouvre une fois quand 60 % sont visibles, se ferme après ~1,2 s). Le focus clavier l'ouvre toujours également.
  • Pages affichées : papier blanc | lignes de texte* | vrai contenu d'aperçu de la carte (ses champs suivants, une courte liste, une vignette de graphique).
  • Couverture : UI de carte existante* | image | scène ASCII animée | couleur unie.
  • Direction de l'ombre : depuis le dessus* | depuis le haut-gauche.
  • Force de l'ombre : aucune | légère | normale* | profonde.
  • Coins : correspondre à mes tokens* | continus (superellipse).
  • Sensation de mouvement : vif (k 320, amortissement 0,9) | par défaut* (k 240, amortissement 0,86) | doux (k 160, amortissement 0,8). Tous dépassent à peine.
  • Mouvement réduit : léger soulèvement* | rien.
  • Tactile : pression* | défilement dans la vue | désactivé.

3. Pile de calques

  • À l'intérieur du lien de la carte, placez la couverture sur un élément body avec transform-style: preserve-3d. Derrière, empilez N pages et un fond, tous positionnés en absolu sur le même carré.
  • Ordre, de l'avant vers l'arrière : couverture (n = 0), pages (n = 1..N), fond (n = N + 1, ne bouge jamais).
  • La couverture conserve tout le contenu existant de la carte. Les pages et le fond sont décoratifs : aria-hidden, pas de liens, pas de points d'accès clavier.
  • Perspective sur l'élément extérieur statique : environ 1100 px, origine vers la charnière (30 % 50 % pour gauche, 70 % 50 % pour droite, 50 % 30 % pour haut).
  • transform-origin sur le bord de la charnière de chaque calque : left 0 50 %, right 100 % 50 %, top 50 % 0. backface-visibility: hidden.
  • Soulevez le calque n avec translateZ((N + 1 - n) × 0,6 px) pour que les calques ne se battent jamais en profondeur.
  • Les pages se trouvent à 8 px à l'intérieur de la couverture (4 px au dos), comme un bloc de livre, avec un rayon = rayon de la couverture - 8.
  • Fond : sur les cartes plates (Par défaut, Minimaliste), insérez-le d'environ 6 px par rapport à la couverture avec un rayon = rayon de la couverture - 6, pour qu'il ne dépasse jamais des coins raccourcis de la couverture. En imitation reliure, il est au même niveau, la couleur de la couverture assombrie d'environ 28 %.

4. Mouvement

  • Le calque n tourne vers le spectateur d'un angle angle(n) = A × 0,7^n et commence avec un retard retard(n) = 28 ms × n plus tard. La couverture ouvre la marche ; les pages se déploient derrière elle.
  • Direction : rotateY(-angle) pour une charnière gauche, rotateY(+angle) pour droite, rotateX(+angle) pour haut.
  • Chaque calque utilise son propre ressort (voir Sensation de mouvement), se stabilisant en environ 0,3 s.
  • Fermeture en ordre inverse : la page la plus intérieure en premier, retard = 28 ms × (N - n), retour à 0°.
  • Si le pointeur quitte en cours de route, reciblez à partir de l'angle et de la vélocité actuels. Ne sautez jamais.
  • Pas d'utilitaire de ressort dans le projet ? Les transitions CSS sont acceptables : transition transform sur ~420 ms avec un léger dépassement, par exemple cubic-bezier(0,3, 1,2, 0,5, 1), et définissez transition-delay sur 28 ms × n dans l'état ouvert et 28 ms × (N - n) au repos (le délai de l'état cible s'applique, donc la fermeture se fait en ordre inverse).

5. Lumière et ombrage

  • La lumière vient du dessus, donc l'ombre tombe vers le bas du mur.
  • L'ombre est constituée de deux formes solides derrière la carte, chacune floutée une fois. Au repos, elle épouse la carte comme n'importe quelle carte plate :
    • contact : petite et plus foncée, en bas. Moitié inférieure de la carte, ~4 px à l'intérieur de chaque côté, flou ~4 px, ~2 px vers le bas, ~22 % d'opacité.
    • ambiante : faible. Flou ~14 px, ~6 px vers le bas, ~12 % d'opacité.
  • Jamais de box-shadow : c'est un anneau creux qui apparaît comme un contour une fois la couverture détachée.
  • Teinte : gris quasi neutre nuancé vers le mur (gris chaud sur un mur chaud, gris froid sur un mur froid). Jamais noir pur, jamais saturé.
  • Force : met à l'échelle les deux opacités : léger 0,5 (style Par défaut), normal 1, profond 1,4.
  • Ouverture : fondu enchaîné vers une seconde paire pré-floutée plus longue et plus douce (contact flou ~12 px, 12 px vers le bas ; ambiante flou ~38 px, 26 px vers le bas), et déplacez-la d'environ 14 px vers le bas et ~4 % plus large avec transform. Pilotez-la avec une valeur de progression o (0..1) sur son propre ressort (k 200, amortissement 0,9) : paire au repos opacité 1 - o, paire ouverte opacité o.
  • Ombrage des feuilles : chaque page possède un dégradé de superposition depuis le dos (32 % foncé -> 8 % à 55 % -> 0 à 85 %). Son opacité est clamp(écart / 6, 0, 1) × max(0, 1 - écart / 30) où écart = l'angle de la feuille devant moins l'angle de cette feuille. Une page est ombragée tant que la feuille devant se soulève juste d'elle, puis éclairée une fois qu'elles se séparent.
  • Couvertures (Imitation reliure, Minimaliste) : un léger brillant en haut et une petite ombre en bas.

6. Coins et bords

  • Découpez chaque calque (couverture, pages, fond) selon un seul chemin de forme, et dessinez son bord (filet ou biseau) le long de ce chemin exact, par ex. un chemin SVG tracé sur le calque. Ne mélangez pas une bordure CSS ou une box-shadow rentrante avec le découpage : ils divergent aux coins et montrent un second bord quand les calques se séparent.
  • Correspondre à mes tokens : utilisez le rayon du token ; rayon imbriqué = extérieur - retrait.
  • Continus : coins superellipse |x|^n + |y|^n = 1 avec n = 2^1,25 (la même courbe que CSS corner-shape: superellipse(1,25)). Générez un clip-path: path(...) par taille de calque, réutilisez-le pour le bord, et regénérez au redimensionnement.

7. Interaction et accessibilité

  • Test de hit sur l'empreinte au repos : écoutez le survol sur l'élément extérieur statique et donnez à chaque calque mobile pointer-events: none, de sorte qu'une couverture qui se balance ne déplace jamais la cible et que la carte ne clignote jamais en ouverture et fermeture sur ses bords.
  • Curseur : une main pointante sur toute la carte.
  • La carte entière reste un seul ou avec son nom accessible actuel. Les pages n'ajoutent rien à l'arbre d'accessibilité.
  • :focus-visible l'ouvre exactement comme le survol. Gardez l'anneau de focus sur l'élément extérieur, le long de la forme au repos.
  • Mouvement réduit : pas d'éventail ni de rotation. La couverture se soulève d'environ 2 px et l'ombre fait un fondu enchaîné vers la paire ouverte.
  • Tactile : pas de survol. Utilisez l'option Tactile ; un appui doit toujours activer la carte du premier coup.

8. Performances

  • Animer uniquement transform et opacity. Ne jamais animer blur, box-shadow, clip-path, width, height ou top/left.
  • Ne jamais animer un rayon de flou : floutez chaque ombre une fois et faites un fondu enchaîné entre les deux versions pré-floutées.
  • Une seule boucle requestAnimationFrame pour toutes les cartes. Ignorez les cartes dont les ressorts sont au repos, et arrêtez la boucle quand rien ne bouge.
  • Écrivez un style uniquement lorsque sa valeur change (mettez en cache la dernière chaîne par élément).
  • Aucune lecture de mise en page par trame : mesurez une fois, et de nouveau au redimensionnement (ResizeObserver).
  • Couvertures animées sur canvas : dessinez à ~30 ips au maximum, et mettez en pause hors écran (IntersectionObserver) ou lorsque l'onglet est masqué.

9. Couverture ASCII animée (uniquement si choisie)

  • Peignez une petite scène avec une couleur par cellule de caractère (~6 × 9 px).
  • Choisissez chaque caractère par luminosité parmi " .:-=+*#%@".
  • Dessinez une copie atténuée des couleurs (~40 %) en dessous et les caractères colorés par-dessus, de sorte que les espaces ressemblent à un tramage.
  • Estampez les caractères à partir d'un atlas de glyphes pré-rendu au lieu de disposer le texte à chaque trame. Gardez le mouvement lent et en boucle continue.

10. Une fois terminé

  • Listez chaque fichier que vous avez modifié ou ajouté.
  • Listez le style et chaque option que vous avez utilisée, en marquant lesquelles étaient les valeurs par défaut.
  • Notez tout ce qui n'a plus l'air identique au repos.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

kubai-easing-curves

按使用场景为项目中的动画设置缓动曲线和时长:入场用 ease-out,离场用 ease-in,位置变化用 ease-in-out,小的确认反馈用 overshoot,拖动松手后用 spring,并统一为动效 token(easing, motion curves)。

kubai-holo-card

把产品里代表身份或收藏的卡片(会员卡、门票、徽章、个人卡片)改成镭射卡片:卡片朝指针方向 3D 倾斜,镭射与高光随光线移动,内部图案按深度产生视差,静止时轻微晃动,点击可翻到背面并显示厚度。附 Prism、Rainbow、Pearl、Sparkle、Chrome、Etched 六种材质的推荐参数,以及手感、厚度、翻转和层次的几档预设。开始前逐项询问,每项给出推荐值,由你选择或调整,确认后再按现有技术栈改造(holographic card, foil, 3D tilt, parallax)。

kubai-liquid-glass

为图片、壁纸或视频上方的卡片和面板添加液态玻璃材质:背景模糊与提亮、边缘折射与色散、根据背景自动调整的着色和文字颜色,深色和浅色模式下文字都清晰可读,布局保持不变(liquid glass, glassmorphism)。

kubai-scroll-cards

改造现有长页面:选出值得讲的段落,用五种由滚动驱动的卡片交互呈现——层叠卡片(新卡片逐张盖住旧卡片,旧卡片缩小、变暗)、卡组飞出(顶部卡片向一侧甩出,下一张顶上来)、横向展廊(页面固定,纵向滚动推动横向作品集)、封面轮播(中间一张最大,两侧缩小、转开、变暗)、图片展开(小图铺满屏幕,标题从景物后升起形成景深)。效果全部由滚动位置驱动,读者控制节奏,回滚即倒放,不劫持滚动;尺寸按不同屏幕和视窗高度计算,手机工具栏不会挡住内容,矮屏自动退回普通段落。附多档预设,开始前逐项询问,由你选择或调整,确认后按现有技术栈实现(scroll-driven animation, sticky, cover flow, svh)。

Skills associés