Stepkit/Card stack
Product interfaces · Original

Card stack

Layered editorial cards with authored cover art, keyboard navigation, and visible depth.

Download ZIP
Live preview

Try it in context

Customize preview
Source delivery

Usage & source

v0.3.0
React
"use client";

import type { CSSProperties } from "react";
import { CardStack } from "./components/stepkit/CardStack";
import "./components/stepkit/styles.css";
import "./components/stepkit/showcase.css";

const themeStyle = {"--stepkit-bg":"#f7f7f8","--stepkit-surface":"#ffffff","--stepkit-surface-muted":"#f0f0f3","--stepkit-fg":"#17181c","--stepkit-muted":"#626572","--stepkit-border":"#e3e4e9","--stepkit-border-strong":"#c8cad3","--stepkit-code":"#f1f1f4","--stepkit-shadow":"0 20px 60px rgba(31, 26, 64, .10)","--stepkit-accent":"#b64e0d","--stepkit-accent-strong":"#8f3b08","--stepkit-accent-soft":"#fff0e6","--stepkit-accent-on-soft":"#8f3b08","--stepkit-accent-text":"#ffffff","--stepkit-error":"#b43145","--stepkit-placeholder":"#626572","--stepkit-radius":"16px","--stepkit-space":"16px","--stepkit-control-height":"44px","--stepkit-font-sans":"Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif"} as CSSProperties;

export default function Example() {
  return (
    <div className="stepkit-theme" data-stepkit-preset="modern" style={themeStyle}>
      <CardStack
      defaultActiveIndex={0}
      paused={false}
      />
    </div>
  );
}

Dependencies

[email protected]
[email protected]
Add to your project

Install

Use the registry command or download the complete source archive.

npx [email protected] add https://vstepanov.com/stepkit/r/card-stack.json
Assistant handoff

Integration prompt

Prompt
Install Stepkit Card stack 0.3.0 from the registry and preserve the included MIT notice.
npx [email protected] add https://vstepanov.com/stepkit/v0.3.0/r/card-stack.json
Install the tested runtime dependencies exactly: npm install [email protected] [email protected]
Keep the component source, shared styles, NOTICE.md, and provenance files together. Apply the theme tokens on a wrapper rather than passing theme keys as component props.

Usage:
```tsx
"use client";

import type { CSSProperties } from "react";
import { CardStack } from "./components/stepkit/CardStack";
import "./components/stepkit/styles.css";
import "./components/stepkit/showcase.css";

const themeStyle = {"--stepkit-bg":"#f7f7f8","--stepkit-surface":"#ffffff","--stepkit-surface-muted":"#f0f0f3","--stepkit-fg":"#17181c","--stepkit-muted":"#626572","--stepkit-border":"#e3e4e9","--stepkit-border-strong":"#c8cad3","--stepkit-code":"#f1f1f4","--stepkit-shadow":"0 20px 60px rgba(31, 26, 64, .10)","--stepkit-accent":"#6950df","--stepkit-accent-strong":"#5137c7","--stepkit-accent-soft":"#eeeafd","--stepkit-accent-on-soft":"#5137c7","--stepkit-accent-text":"#ffffff","--stepkit-error":"#b43145","--stepkit-placeholder":"#626572","--stepkit-radius":"16px","--stepkit-space":"16px","--stepkit-control-height":"44px","--stepkit-font-sans":"Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif"} as CSSProperties;

export default function Example() {
  return (
    <div className="stepkit-theme" data-stepkit-preset="modern" style={themeStyle}>
      <CardStack
      defaultActiveIndex={0}
      paused={false}
      />
    </div>
  );
}
```

Selected bounded settings: {"defaultActiveIndex":0,"paused":false}.
Selected theme: {"mode":"light","accent":"violet","radius":"soft","density":"comfortable","preset":"modern"}.
API

Props

NameTypeDefaultDescription
cardsCardStackItem[]default cardsEditorial card records and artwork choices.
activeIndexnumberundefinedControlled active card index.
onActiveIndexChange(index: number, card: CardStackItem) => voidundefinedCalled after keyboard or button navigation.
pausedbooleanfalseDisables stack transitions.
Quality

Accessibility & limits

  • Previous and next controls have explicit labels.
  • Arrow keys move through the active card while the count and title are announced.
  • Layered cards expose only the active card to assistive technology.

Limitations

  • The component intentionally shows up to three layers; excess cards remain available through navigation.
Source record

Provenance

Original source under the MIT licence.

Original Stepkit implementation.

Required notices: NOTICE.md, PROVENANCE-stepkit-card-stack.md