Communitygithub.com

kubai-book-cards

Karten, die beim Überfahren oder Fokussieren wie ein Buch aufklappen und die Innenseiten zeigen, im Ruhezustand aber unverändert bleiben. Bietet drei Stile: normale Karten, skeuomorphe Hardcover-Bücher und minimalistische Dokumente. Geeignet für Dokumentationen, Wissensdatenbanken, Portfolios und Vorlagenmärkte (Book-Hover-Karten).

Was ist kubai-book-cards?

Diese Fähigkeit verwandelt vorhandene Kartenkomponenten in interaktive Buchklappkarten, die beim Hovern oder Fokussieren wie ein richtiges Buch aufblättern. Sie ist speziell für Entwickler:innen gedacht, die bestehende UI-Komponenten nahtlos erweitern möchten – ohne das Layout oder die Inhalte zu verändern. Die Fähigkeit unterstützt drei visuelle Stile: (1) normale Produktkarten, die erst bei Interaktion ihre Buchstruktur zeigen, (2) skeuomorphe Hardcover-Bücher mit Stoffstruktur, warmen Schatten und vollflächigen Covern, und (3) minimalistische Dokumentationen mit monospace-Elementen und feinem Rasterhintergrund. Die Implementierung erfolgt durch einen CSS-3D-Layer-Stack (Cover, Seiten, Rückseite) mit transform-style: preserve-3d, perspektivischer Projektion und gefederten Animationen für Cover und Seiten. Optionen wie Klappwinkel, Seitenanzahl, Scharnierposition (links/rechts/oben), Bewegungsgefühl, Schattenrichtung und Barrierefreiheit (inkl. reduced-motion und Fokussteuerung) sind konfigurierbar. Die Bibliothek achtet auf hohe Performance – nur transform und opacity werden animiert, Schatten sind vorgerendert und weich überblendet, und pro Frame wird nur ein requestAnimationFrame-Loop gesteuert.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Karten, die beim Überfahren wie ein Buch aufklappen

Die 999 kleinen Tricks, die deinem Produkt mehr Ähnlichkeit verleihen – Ausgabe 006 · @kubai087

Wende die folgenden Anforderungen in meinem Projekt an. Die Anforderungen sind aus der Perspektive des Nutzers formuliert: I, me, my bezieht sich auf den Nutzer. An Stellen, an denen etwas erfragt werden soll, halte inne, frage den Nutzer und fahre fort.

Anforderungen an die Umgestaltung

Die Karten in meinem Produkt sollen sich beim Überfahren wie ein Buch ein Stück weit öffnen. Im Ruhezustand muss eine Karte exakt so aussehen wie heute; nur Hover oder Fokus zeigt, dass es sich um ein kleines Buch mit Seiten im Inneren handelt.

0. Beginne mit dem Bestehenden

  • Finde die Kartenkomponente, die ich benenne (oder die im von mir gezeigten Raster/Dynamik verwendet wird), und baue sie direkt um. Verwende deren Markup, Design-Token, Radien, Schatten und Bewegungs-/Spring-Utilities.
  • Behalte das Footprint, Padding, den Inhalt und das Layout der Karte bei. Nichts um die Karte herum darf sich verschieben.
  • Wenn ich stattdessen neue Karten wünsche, erstelle eine frische quadratische Karte (ca. 280 × 280) im unten von mir gewählten Stil.
  • Jede Option, die ich nicht setze, verwendet den Standardwert (gekennzeichnet mit *).

1. Wähle einen Stil

Standard*: normale Produktkarten, die bis zum Hover identisch sind.

  • Oberfläche: schlichtes Weiß (oder mein Kartenoberfläche-Token), keine Textur.
  • Rand: 1 px feiner Strich in meiner Randfarbe.
  • Schatten: hell, neutrales Grau, halbe Stärke.
  • Schrift: die Produkt-Sans. Titel 24/600, Beschreibung 15 muted, Meta 14 muted.
  • Cover: die vorhandene Karten-UI: 48 px Icon-Kachel, ↗ Pfeil oben rechts, Titel, Beschreibung und ein Meta-Footer unter einem feinen Strich.
  • Hintergrundwand: mein normaler Seitenhintergrund.
  • Seiten: weiß, leicht abgeschattet zum Buchrücken hin, eine kleine Überschrift und 4–6 graue Textzeilen.

Skeuomorph: Hardcover-Bücher an einer Galeriewand.

  • Oberfläche: feine Buchleinenstruktur auf einer tiefen Cover-Farbe.
  • Rand: beleuchtete Abschrägung – helle Oberkante, dunkler Fuß.
  • Schatten: warm, fast neutrales Grau (nie orange), volle Stärke.
  • Schrift: ein Serifen-Titel unten links. Nichts weiter auf dem Cover.
  • Cover: ein randfüllendes Bild oder eine animierte ASCII-Szene mit einem weichen Glanz oben und Schatten am Fuß.
  • Hintergrundwand: warmer Putz mit feiner Struktur und einem Spotlicht über jedem Buch.
  • Seiten: cremefarbenes Papier mit Textur, ein kursives Kapitel, Blocksatz und schmale Seitenkanten am Vorderschnitt.

Minimalistisch: Dokumentationsbände.

  • Oberfläche: flach, cremefarben, hellgrau oder graphit, ein Ton pro Karte.
  • Rand: eine leichte Abschrägung oder ein feiner Strich.
  • Schatten: kühles neutrales Grau.
  • Schrift: eine Monospace-Abschnittsnummer und Version oben über einer feinen Linie; ein zweizeiliger Sans-Titel und ein kleines graues Label unten.
  • Cover: ein kleines graues Liniendiagramm mit einem einzelnen Element in der Akzentfarbe.
  • Hintergrundwand: kühles Grau mit einem feinen 24 px Punktgitter und weichem Licht von oben.
  • Passend zu meinem Produkt: Übernimm Oberfläche, Rand, Schatten, Schrift und Wand aus meinen Token und belasse das Cover exakt so, wie die Karte heute ist.

2. Optionen (Standardwerte mit * markiert)

  • Intensität: subtil (A = 24°) | Buch* (A = 42°) | dramatisch (A = 60°).
  • Seiten: 2 | 3 | 4* | 6.
  • Scharnier: links* | rechts | oben.
  • Auslöser: Hover* | Drücken (öffnet während des Drückens) | beim Scrollen einblenden (öffnet einmal bei 60 % Sichtbarkeit, schließt nach ca. 1,2 Sek.). Tastaturfokus öffnet es ebenfalls.
  • Seiten zeigen: leeres Papier | Textzeilen* | echte Vorschauinhalte der Karte (nächste Felder, eine kurze Liste, ein Diagramm-Miniatur).
  • Cover: vorhandene Karten-UI* | Bild | animierte ASCII-Szene | Vollfarbe.
  • Schattenrichtung: von oben* | von oben links.
  • Schattenstärke: keiner | leicht | normal* | tief.
  • Ecken: passend zu meinen Token* | durchgehend (Superellipse).
  • Bewegungsgefühl: schnell (k 320, Dämpfung 0,9) | Standard* (k 240, Dämpfung 0,86) | weich (k 160, Dämpfung 0,8). Alle überschwingen kaum.
  • Reduzierte Bewegung: winzige Anhebung* | nichts.
  • Berührung: Drücken* | beim Scrollen einblenden | aus.

3. Schichtung

  • Innerhalb des Kartenlinks platziere das Cover auf einem Body-Element mit transform-style: preserve-3d. Dahinter stapelst du N Seiten und eine Rückplatte, alle absolut positioniert auf demselben Quadrat.
  • Reihenfolge (von vorne nach hinten): Cover (n = 0), Seiten (n = 1..N), Rückplatte (n = N + 1, bewegt sich nie).
  • Das Cover behält den gesamten vorhandenen Karteninhalt. Seiten und Rückplatte sind dekorativ: aria-hidden, keine Links, keine Tab-Stopps.
  • Perspektive auf dem statischen äußeren Element: etwa 1100 px, Ursprung Richtung Scharnier (30 % 50 % für links, 70 % 50 % für rechts, 50 % 30 % für oben).
  • transform-origin auf der Scharnierseite jeder Schicht: links 0 50 %, rechts 100 % 50 %, oben 50 % 0. backface-visibility: hidden.
  • Hebe Schicht n um translateZ((N + 1 - n) × 0.6 px) an, damit sich die Schichten in der Tiefe nicht überschneiden.
  • Seiten liegen 8 px innerhalb des Covers (4 px am Buchrücken), wie ein Buchblock, mit Radius = Cover-Radius − 8.
  • Rückplatte: Bei flachen Karten (Standard, Minimal) um etwa 6 px vom Cover eingerückt, Radius = Cover-Radius − 6, sodass sie nie über die verkürzten Ecken des Covers hinausschaut. Bei Skeuomorph liegt sie bündig, die Cover-Farbe um etwa 28 % abgedunkelt.

4. Bewegung

  • Schicht n dreht sich zum Betrachter hin um einen Winkel von angle(n) = A × 0.7^n und beginnt mit einer Verzögerung von delay(n) = 28 ms × n. Das Cover führt; die Seiten fächern sich dahinter auf.
  • Richtung: rotateY(-angle) für ein linksseitiges Scharnier, rotateY(+angle) für rechts, rotateX(+angle) für oben.
  • Jede Schicht läuft auf ihrer eigenen Feder (siehe Bewegungsgefühl) und beruhigt sich in etwa 0,3 s.
  • Schließen in umgekehrter Reihenfolge: die innerste Seite zuerst, Verzögerung = 28 ms × (N − n), zurück auf 0°.
  • Wenn der Mauszeiger mitten in der Bewegung das Element verlässt, nahtlos vom aktuellen Winkel und Geschwindigkeit aus weiterkorrigieren. Nie springen.
  • Kein Spring-Helper im Projekt? CSS-Transitions funktionieren: transition: transform über ~420 ms mit leichtem Überschwinger, z. B. cubic-bezier(0.3, 1.2, 0.5, 1), und setze transition-delay auf 28 ms × n im geöffneten Zustand und 28 ms × (N - n) im Ruhezustand (die Verzögerung des Zielzustands gilt, sodass das Schließen rückwärts abläuft).

5. Licht und Schattierung

  • Licht kommt von oben, sodass der Schatten an der Wand nach unten fällt.
  • Der Schatten besteht aus zwei festen Formen hinter der Karte, jede einmal mit Weichzeichnung versehen. Im Ruhezustand umschließt er die Karte wie bei jeder flachen Karte:
    • Kontaktschatten: klein und dunkler, am Fuß. Untere Hälfte der Karte, etwa 4 px von jeder Seite entfernt, Weichzeichnung ~4 px, ~2 px nach unten, ~22 % Deckkraft.
    • Umgebungsschatten: schwach. Weichzeichnung ~14 px, ~6 px nach unten, ~12 % Deckkraft.
  • Niemals einen box-shadow verwenden: Dieser ist ein hohler Ring und erscheint als Umriss, sobald sich das Cover davon wegbewegt.
  • Farbton: nahezu neutrales Grau, Richtung Wand (warmes Grau auf warmer Wand, kühles Grau auf kühler Wand). Nie reines Schwarz, nie gesättigt.
  • Stärke skaliert beide Deckkräfte: leicht 0,5 (Standard-Stil), normal 1, tief 1,4.
  • Öffnen: Überblenden zu einem zweiten vorab unscharfen Paar, das länger und weicher ist (Kontakt ~12 px Weichzeichnung, 12 px nach unten; Umgebung ~38 px Weichzeichnung, 26 px nach unten) und verschiebe es mit transform ~14 px weiter nach unten und ~4 % breiter. Steuere es mit einem Fortschrittswert o (0..1) auf einer eigenen Feder (k 200, Dämpfung 0,9): Ruhepaar-Deckkraft 1 − o, Öffnungspaar-Deckkraft o.
  • Blattschattierung: Jede Seite hat einen Überblendungsverlauf vom Buchrücken (32 % dunkel → 8 % bei 55 % → 0 % bei 85 %). Seine Deckkraft ist clamp(gap / 6, 0, 1) × max(0, 1 − gap / 30), wobei gap der Winkel des vorderen Blatts minus dieses Blatts Winkel ist. Eine Seite wird beschattet, während sich das vordere Blatt gerade davon abhebt, und wird hell, sobald sie sich trennen.
  • Cover (Skeuomorph, Minimal): ein weicher Glanz am oberen Rand und ein wenig Schatten am Fuß.

6. Ecken und Kanten

  • Beschneide jede Schicht (Cover, Seiten, Rückplatte) mit einer einzigen Form und zeichne ihren Rand (feiner Strich oder Abschrägung) entlang dieser exakten Form, z. B. ein SVG-Pfad, der über die Schicht gelegt wird. Verwende nicht gleichzeitig einen CSS-Rand oder einen eingelassenen box-shadow mit dem Clip: Sie stimmen an den Ecken nicht überein und zeigen einen zweiten Rand, wenn sich die Schichten trennen.
  • Passend zu meinen Token: Verwende den Token-Radius; verschachtelter Radius = Außenradius − Einrückung.
  • Durchgehend: Superellipse-Ecken |x|^n + |y|^n = 1 mit n = 2^1.25 (derselbe Kurvenverlauf wie CSS corner-shape: superellipse(1.25)). Generiere einen clip-path: path(...) pro Schichtgröße, verwende ihn für den Rand neu und generiere bei Größenänderung neu.

7. Interaktion und Barrierefreiheit

  • Hit-Testing auf dem Ruhe-Footprint: Höre auf Hover auf dem statischen äußeren Element und gib allen sich bewegenden Schichten pointer-events: none, damit ein schwingendes Cover nie das Ziel verschiebt und die Karte an den Kanten nicht flackert.
  • Cursor: Zeigehand über der gesamten Karte.
  • Die gesamte Karte bleibt ein <a> oder <button> mit dem aktuellen barrierefreien Namen. Seiten fügen nichts zum Barrierefreiheitsbaum hinzu.
  • :focus-visible öffnet sie genauso wie Hover. Platziere den Fokusring auf dem äußeren Element entlang der Ruheform.
  • Reduzierte Bewegung: kein Fächern und keine Drehung. Das Cover hebt sich etwa 2 px an und der Schatten überblendet zum geöffneten Paar.
  • Berührung: kein Hover. Verwende die Berührungsoption; ein Tippen muss die Karte beim ersten Versuch aktivieren.

8. Leistung

  • Animiere nur transform und opacity. Animiere nie blur, box-shadow, clip-path, width, height oder top/left.
  • Animiere niemals einen Weichzeichnungsradius: Weichzeichne jeden Schatten einmal und überblende die beiden vorab unscharfen Versionen.
  • Ein einziger requestAnimationFrame-Loop für alle Karten. Überspringe Karten, deren Federn stillstehen, und stoppe den Loop, wenn sich nichts bewegt.
  • Schreibe einen Style nur, wenn sich sein Wert ändert (Cache des letzten Strings pro Element).
  • Keine Layout-Abfragen pro Frame: einmal messen, und erneut bei Größenänderung (ResizeObserver).
  • Animierte Canvas-Cover: max. ~30 fps zeichnen und pausieren, wenn der Bildschirm nicht sichtbar ist (IntersectionObserver) oder der Tab ausgeblendet ist.

9. Animiertes ASCII-Cover (nur wenn gewählt)

  • Male eine kleine Szene als eine Farbe pro Zeichenzelle (ca. 6 × 9 px).
  • Wähle jedes Zeichen nach Helligkeit aus . -:+*#%@.
  • Zeichne eine abgedunkelte Kopie der Farben (~40 %) darunter und die farbigen Zeichen darüber, sodass die Lücken wie ein Halbton wirken.
  • Stempele Zeichen aus einer vorgerenderten Glyphen-Atlas, anstatt jeden Frame Text zu setzen. Halte die Bewegung langsam und nahtlos wiederholend.

10. Wenn fertig

  • Liste jede Datei auf, die du geändert oder hinzugefügt hast.
  • Liste den verwendeten Stil und jede von dir gesetzte Option auf und markiere, welche Standardwerte waren.
  • Notiere alles, das im Ruhezustand nicht mehr identisch aussieht.

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)。

Verwandte Skills