Skip to content
cccskills
FreePublished on GitHub

product-card

Use when implementing product display cards for e-commerce.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md3.5 KB
  • references/pattern.md11.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Product Card

Product display cards for e-commerce

What it solves

A Product Card pattern helps teams create a reliable way to summarize a product clearly enough that users can decide whether to inspect it, compare it, or add it immediately. It is most useful when teams need category and search result listings. Compared with adjacent patterns, this pattern should reduce friction without hiding the state, rules, or recovery paths people need to keep moving.

When to use

  • Category and search result listings
  • Recommendation shelves
  • Quick-buy merchandising

When to avoid

  • Use a simpler purchase path when the item, buyer, and payment state are already known.
  • Avoid forcing the full pattern when users only need a quick confirmation step.
  • Do not optimize for conversion at the expense of price and policy clarity.

Implementation workflow

  1. Confirm the pattern matches the problem and constraints before copying the example.
  2. Start from the anatomy and examples in references/pattern.md, then choose the smallest viable variation.
  3. Apply accessibility, performance, and interaction guardrails before layering visual polish.
  4. Use the testing guidance to verify behavior across keyboard, screen reader, responsive, and failure scenarios.

Accessibility guardrails

Keyboard Interaction

  • Verify that product card can be completed using keyboard alone.
  • Keep focus order logical when the pattern opens, updates, or reveals additional UI.
  • Preserve a visible focus state that is still readable at high zoom.

Screen Reader Support

  • Use semantic elements first, then add ARIA only where semantics alone are not enough.
  • Announce state changes such as errors, loading, or completion in the right place and with the right politeness.
  • Connect labels, hints, and status text with aria-describedby or structural headings when useful.

Visual Accessibility

  • Do not rely on color alone to convey severity, completion, or selection state.

Common mistakes

Treating trust as secondary UI

The Problem: Counts, totals, identities, and policies are often the main thing users are checking before acting.

How to Fix It? Design trust signals into the main hierarchy instead of leaving them as tiny secondary text.

Over-optimizing for the first click

The Problem: Aggressive prompts can increase taps while harming completion quality or long-term trust.

How to Fix It? Measure the full journey, including reversals, refunds, reports, and hidden dissatisfaction.

Ignoring abuse and fraud paths

The Problem: Social and commerce surfaces invite misuse as soon as they create visible value.

How to Fix It? Plan rate limits, authorization checks, moderation, and audit trails as part of the pattern itself.

Related patterns


For full implementation detail, examples, and testing notes, see references/pattern.md.

Pattern page: https://uxpatterns.dev/patterns/e-commerce/product-card

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when implementing expand and collapse content sections.

The English summary is being prepared. Showing the original description.

thedaviddias/ux-patterns-for-developers266Updated Oct 5, 2026

Use when implementing user account configuration and preferences.

The English summary is being prepared. Showing the original description.

thedaviddias/ux-patterns-for-developers266Updated Oct 5, 2026

Use when implementing social activity and updates stream.

The English summary is being prepared. Showing the original description.

thedaviddias/ux-patterns-for-developers266Updated Oct 5, 2026

Use when implementing conversational AI chat interfaces.

The English summary is being prepared. Showing the original description.

thedaviddias/ux-patterns-for-developers266Updated Oct 5, 2026

Use when implementing handling AI-specific errors.

The English summary is being prepared. Showing the original description.

thedaviddias/ux-patterns-for-developers266Updated Oct 5, 2026

Use when implementing loading states for AI operations.

The English summary is being prepared. Showing the original description.

thedaviddias/ux-patterns-for-developers266Updated Oct 5, 2026

See all skills by thedaviddias

Report a problem with this skill