Available · v0.1.0

Stage card

Highlight the next useful task for the current merchant stage.

Interactive example

Loading Polaris components…

Usage

<StageCard featured title="Group your customers" description="Review company and location suggestions." action={<s-button variant="primary">Find customers</s-button>} />

Properties

PropertyTypeDefaultDescription
titlestringRequiredClear action-oriented heading.
descriptionstringRequiredExplain the outcome.
featuredbooleanfalseSpan the primary bento area.
eyebrowstring—Stage or real count.
actionReactNode—Native s-button or s-link.
kindstringcompaniesimport or companies artwork.

Design and interaction

Use one featured action. Stage must come from real store/task state. Avoid a wall of equal cards.

Accessibility

Static artwork is decorative; heading and action communicate the same purpose.

Implementation and ownership

Source: Kaupvik Website, packages/polaris. React client component; controlled host data. No API credentials or merchant transport are included. Host applications own authentication, validation, localization, errors and persisted preferences. Graph nodes use native Shopify identities; diagram positions are presentation only.

Tokens and states

Native controls use Shopify attributes and inherit the host’s design system. Kaupvik layout tokens: --kp-surface, --kp-surface-subdued, --kp-ink, --kp-ink-subdued, --kp-border, --kp-accent, --kp-focus, --kp-radius, --kp-space. Override only within the product surface. Loading, error and empty states are distinct; host data is never invented to fill a preview.

Verification

Test keyboard and pointer operation, focus visibility, 375px and desktop layouts, reduced motion and server hydration. Test every product adapter independently before release. QO remains on its reviewed implementation until its own adoption release.

Related product patterns