Files
astro-website/openspec/changes/card-layout/specs/card-layout-system/spec.md
2026-02-10 02:34:25 -05:00

1.2 KiB

ADDED Requirements

Requirement: Standard card information architecture

All content cards rendered by the site MUST use a standardized layout so cards across different surfaces look consistent.

The standard card layout MUST be:

  • featured image displayed prominently at the top (when available)
  • title
  • summary/excerpt text, trimmed to a fixed maximum length
  • meta row showing:
    • publish date on the left
    • views on the right (when available)
  • footer row showing the content source (e.g., youtube, podcast, blog)

If a field is not available (for example, views for some sources), the card MUST still render cleanly with that field omitted.

Scenario: Card renders with all fields

  • WHEN a content item has an image, title, summary, publish date, views, and source
  • THEN the card renders those fields in the standard card layout order

Scenario: Card renders without views

  • WHEN a content item has no views data
  • THEN the card renders the meta row with date and omits views without breaking the layout
  • WHEN a content item has no featured image
  • THEN the card renders a placeholder media area and still renders the remaining fields