Communitygithub.com

kubai-book-cards

卡片在悬停或聚焦时像书一样翻开一定角度,显示里面的内页,静止时外观保持不变。提供普通卡片、拟物精装书和极简文档三种风格。适用于文档、知识库、作品集和模板市场(book hover cards)。

kubai-book-cards 是什么?

kubai-book-cards is a Cursor agent skill that 卡片在悬停或聚焦时像书一样翻开一定角度,显示里面的内页,静止时外观保持不变。提供普通卡片、拟物精装书和极简文档三种风格。适用于文档、知识库、作品集和模板市场(book hover cards)。.

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Cards That Tilt Open Like a Book on Hover

999 Tiny Tricks to Make Your Vibe Product More Polished — Issue 006 · @kubai087

Apply the following changes to the user's project as specified. The requirements are written in the user's voice: I, me, my refer to the user; where it says "ask first," stop and ask the user before proceeding.

Requirements

Make the cards in my product open a little, like a book, when hovered. At rest a card must look exactly as it does today; only hover or focus reveals that it is a small book with pages inside.

0. Start from what exists

  • Find the card component I name (or the one used in the grid or list I point to) and retrofit it in place. Reuse its markup, design tokens, radius, shadow and motion or spring utilities.
  • Keep the card's footprint, padding, content and layout unchanged. Nothing around the card may move.
  • If I ask for new cards instead, build a fresh square card (about 280 x 280) in the style I choose below.
  • Any option I leave unset uses the default marked *.

1. Choose a style

Default*: ordinary product cards, identical to normal ones until hovered.

  • Surface: plain white (or my card surface token), no texture.
  • Edge: a 1px hairline in my border colour.
  • Shadow: light, neutral cool grey, half strength.
  • Type: the product sans. Title 24/600, description 15 muted, meta 14 muted.
  • Cover: the existing card UI: a 48px icon tile, a ↗ arrow top right, title, description, and a meta footer below a hairline.
  • Wall: my normal page background.
  • Pages: white, a faint shade toward the spine, a small heading and 4-6 grey text lines.

Skeuomorphic: hardcover books on a gallery wall.

  • Surface: fine bookcloth grain over a deep cover colour.
  • Edge: a lit bevel: bright top edge, darker foot.
  • Shadow: warm, near-neutral grey (never orange), full strength.
  • Type: one serif title, bottom left. Nothing else on the cover.
  • Cover: a full-bleed image or animated ASCII scene, with a soft gloss at the top and shade at the foot.
  • Wall: warm plaster with a fine grain and a spotlight over each book.
  • Pages: cream paper with grain, an italic chapter heading, justified lines, and thin page edges along the fore-edge.

Minimal: documentation volumes.

  • Surface: flat off-white, light grey or graphite, one tone per card.
  • Edge: a faint bevel or hairline.
  • Shadow: cool neutral grey.
  • Type: a mono section number and version on top, over a hairline rule; a two-line sans title and a small grey label at the foot.
  • Cover: one small grey line diagram with a single element in the ink colour.
  • Wall: cool grey with a faint 24px dot grid and soft light from above.
  • Pages: cool white, a sans heading and grey lines.

Match my product: take surface, edge, shadow, type and wall from my tokens, and keep the cover exactly as the card is today.

2. Options (defaults marked *)

  • Intensity: subtle (A = 24deg) | book* (A = 42deg) | dramatic (A = 60deg).
  • Pages: 2 | 3 | 4* | 6.
  • Hinge: left* | right | top.
  • Trigger: hover* | press (open while pressed) | scroll into view (open once when 60% visible, close after ~1.2s). Keyboard focus always opens it too.
  • Pages show: blank paper | lines of text* | real preview content from the card (its next fields, a short list, a chart thumbnail).
  • Cover: existing card UI* | image | animated ASCII scene | solid colour.
  • Shadow direction: from above* | from top-left.
  • Shadow strength: none | light | normal* | deep.
  • Corners: match my tokens* | continuous (superellipse).
  • Motion feel: snappy (k 320, damping 0.9) | default* (k 240, damping 0.86) | soft (k 160, damping 0.8). All barely overshoot.
  • Reduced motion: tiny lift* | nothing.
  • Touch: press* | scroll into view | off.

3. Layer stack

  • Inside the card's link, put the cover on a body element with transform-style: preserve-3d. Behind it stack N pages and a back board, all absolutely positioned on the same square.
  • Order, front to back: cover (n = 0), pages (n = 1..N), back board (n = N + 1, never moves).
  • The cover keeps all of the card's existing content. Pages and the back board are decorative: aria-hidden, no links, no tab stops.
  • Perspective on the static outer element: about 1100px, origin toward the hinge (30% 50% for left, 70% 50% for right, 50% 30% for top).
  • transform-origin on the hinge edge of every layer: left 0 50%, right 100% 50%, top 50% 0. backface-visibility: hidden.
  • Lift layer n by translateZ((N + 1 - n) x 0.6px) so layers never fight in depth.
  • Pages sit 8px inside the cover (4px at the spine), like a book block, with radius = cover radius - 8.
  • Back board: on flat cards (Default, Minimal) inset it ~6px from the cover with radius = cover radius - 6, so it never peeks out past the cover's foreshortened corners. On Skeuomorphic it is flush, the cover colour darkened ~28%.

4. Motion

  • Layer n turns toward the viewer by angle(n) = A x 0.7^n and starts delay(n) = 28ms x n later. The cover leads; pages fan out behind it.
  • Direction: rotateY(-angle) for a left hinge, rotateY(+angle) for right, rotateX(+angle) for top.
  • Each layer runs on its own spring (see Motion feel), settling in about 0.3s.
  • Close in reverse: the innermost page first, delay = 28ms x (N - n), back to 0deg.
  • If the pointer leaves mid-way, retarget from the current angle and velocity. Never jump.
  • No spring helper in the project? CSS transitions are fine: transition transform over ~420ms with a slight overshoot, e.g. cubic-bezier(0.3, 1.2, 0.5, 1), and set transition-delay to 28ms x n in the open state and 28ms x (N - n) at rest (the target state's delay applies, so closing runs in reverse).

5. Light and shading

  • Light comes from above, so the shadow falls down the wall.
  • The shadow is two solid shapes behind the card, each blurred once. At rest it hugs the card like any flat card's:
    • contact: small and darker, at the foot. Lower half of the card, ~4px in from each side, blur ~4px, ~2px down, ~22% opacity.
    • ambient: faint. Blur ~14px, ~6px down, ~12% opacity.
  • Never a box-shadow: it is a hollow ring and shows as an outline once the cover swings off it.
  • Tint: near-neutral grey nudged toward the wall (warm grey on a warm wall, cool grey on a cool one). Never pure black, never saturated.
  • Strength scales both opacities: light 0.5 (Default style), normal 1, deep 1.4.
  • Opening: crossfade to a second pre-blurred pair that is longer and softer (contact blur ~12px, 12px down; ambient blur ~38px, 26px down), and move it ~14px further down and ~4% wider with transform. Drive it with one progress value o (0..1) on its own spring (k 200, damping 0.9): rest pair opacity 1 - o, open pair opacity o.
  • Leaf shading: every page has an overlay gradient from the spine (32% dark -> 8% at 55% -> 0 at 85%). Its opacity is clamp(gap / 6, 0, 1) x max(0, 1 - gap / 30) where gap = the angle of the leaf in front minus this leaf's angle. A page is shaded while the leaf in front is just lifting off it, then lit once they part.
  • Covers (Skeuomorphic, Minimal): a soft gloss at the top edge and a little shade at the foot.

6. Corners and edges

  • Clip every layer (cover, pages, back board) to one shape path, and draw its edge (hairline or bevel) along that exact path, e.g. an SVG path stroked over the layer. Do not mix a CSS border or inset box-shadow with the clip: they disagree at the corners and show a second rim when the layers part.
  • Match my tokens: use the token radius; nested radius = outer - inset.
  • Continuous: superellipse corners |x|^n + |y|^n = 1 with n = 2^1.25 (the same curve as CSS corner-shape: superellipse(1.25)). Generate a clip-path: path(...) per layer size, reuse it for the edge, and regenerate on resize.

7. Interaction and accessibility

  • Hit-test on the resting footprint: listen for hover on the static outer element and give every moving layer pointer-events: none, so a swinging cover never moves the target and the card never flickers open and closed at its edges.
  • Cursor: a pointing hand over the whole card.
  • The whole card stays one or with its current accessible name. Pages add nothing to the accessibility tree.
  • :focus-visible opens it exactly like hover. Keep the focus ring on the outer element, along the resting shape.
  • Reduced motion: no fan and no rotation. The cover lifts ~2px and the shadow crossfades to the open pair.
  • Touch: no hover. Use the Touch option; a tap must still activate the card on the first try.

8. Performance

  • Animate transform and opacity only. Never animate blur, box-shadow, clip-path, width, height or top/left.
  • Never animate a blur radius: blur each shadow once and crossfade the two pre-blurred versions.
  • One requestAnimationFrame loop for all cards. Skip cards whose springs are at rest, and stop the loop when nothing moves.
  • Write a style only when its value changes (cache the last string per element).
  • No layout reads per frame: measure once, and again on resize (ResizeObserver).
  • Animated canvas covers: draw at ~30fps at most, and pause when off screen (IntersectionObserver) or when the tab is hidden.

9. Animated ASCII cover (only if chosen)

  • Paint a small scene as one colour per character cell (~6 x 9px).
  • Pick each character by brightness from " .:-=+*#%@".
  • Draw a dimmed copy of the colours (~40%) underneath and the coloured characters on top, so the gaps read like a halftone.
  • Stamp characters from a pre-rendered glyph atlas instead of laying out text every frame. Keep the motion slow and seamlessly looping.

10. When done

  • List every file you changed or added.
  • List the style and every option you used, marking which were defaults.
  • Note anything that no longer looks identical at rest.

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

相关技能