Skip to content
Polytope

Cards

Entries on a list page, hung as exhibits: a black panel with the entry's figure or its own complex, then the title, a meta line, and a summary.

Experimental May change in any minor version before 1.0.


In this chapter 15 pages

A list page

The first card leads: it spans the row and, with room, sets its panel beside the text and its title in wood type, with the subtitle under the name. The others share the rows, up to three to a row.

astro
<CardGrid>
  <Card lead href="/papers/x/" title="Name: what it does" meta={["ICLR 2026", "Oral"]} badge="Top 3 paper" summary="...">
    <Picture slot="figure" src={figure} alt="" />
  </Card>
  <Card href="/papers/y/" title="..." meta={["Preprint"]} />
</CardGrid>
  • Put the figure in the figure slot with empty alt text: the title names the entry, and the panel is a second way to the same page. Without a figure, the card draws a Vietoris-Rips complex seeded from its title, so each entry has its own; seed picks another.
  • badge hangs wall labels on the panel. They carry their own pale ground and edge (.ply-label--flag, the flag tokens), so they read on a white screenshot and a black panel, in both themes.
  • The grid shares a row between fewer cards than it has columns, so a year with two papers sets two wide cards, and a card alone sets like a lead.
  • level sets the title's heading level (3 by default), and link passes attributes to the title's link, such as data attributes for analytics.

Aligned rows and three tracks

Cards with summaries of different lengths leave titles and link rows at different heights across a row. .ply-cards--aligned lines the parts up with subgrid, from 48rem: each card takes seven rows of the grid (panel, title, meta, summary, authors, tags, links), so the parts of one row of cards start on shared lines and the row is as tall as its tallest part. An unused row collapses. .ply-cards--tracks keeps the grid at exactly three tracks from 80rem, whatever a row holds, so a card is the same size on every row. The lead, or a card alone, then puts its panel across two tracks and its text in the third, with its title a step smaller.

astro
<CardGrid class="ply-cards--aligned ply-cards--tracks">
  <Card href="/papers/x/" title="..." meta={["ICLR 2026"]} summary="...">
    <p class="ply-card__authors">A. Author, <span class="ply-me">John Doe</span></p>
    <p class="ply-card__links"><a href="/x.pdf">Paper</a><a href="/papers/x/#cite">BibTeX</a></p>
  </Card>
</CardGrid>
  • .ply-card__authors is the authors line in 14px caption gray, with the owner's name, in .ply-me, set darker. .ply-card__links is a row of small links, 24px tall, 44px under a finger. Both go in the card's default slot.
  • The classes work together or apart. Without subgrid, the last block of each card sits at the card's bottom.

Authors, tags, and links as props

authors, links, and a linked form of tags write those parts for you, in the order the aligned rows expect: summary, authors, tags, links. Authors are names, or { name, href } to link one. me sets the owner's name darker, and fold shortens a long list to the first names, yours, and the last, with the gap read out as "more authors". A link takes attrs for data attributes, and a link to a PDF is kept out of hover prefetch.

astro
<Card href="/papers/x/" title="..." meta={["ICLR 2026"]} summary="..."
  authors={["A. Author", { name: "B. Author", href: "/people/b/" }, "John Doe"]} me="John Doe" fold={12}
  tags={[{ label: "Sheaves", href: "/topics/sheaves/" }, "Graphs"]}
  links={[{ label: "Paper", href: "/x.pdf", attrs: { "data-track": "paper-link" } }, { label: "BibTeX", href: "/papers/x/#cite" }]} />

Pictures

  • Write sizes for the column a phone shows, which is the viewport less two gutters. 100vw overstates it by a tenth, and a phone then fetches the next size up. The helpers column() and widthsFor() from @dario-loi/polytope/astro write both values.
  • A picture with a twin for the other theme takes .ply-light-only and .ply-dark-only: the one for the theme in use shows, the switch's first and then the system's, and paper takes the light one. Load the twin lazily at normal priority, since a reader sees one of the two.
  • A flush panel that holds a picture gets a hairline frame (.ply-panel--flush with an img), so a light screenshot keeps its edge on the white wall, as a card's panel does.
astro
import { Picture } from "astro:assets";
import { column, pictureFormats, widthsFor } from "@dario-loi/polytope/astro";

<Picture {...pictureFormats} src={light} widths={widthsFor(light, 720)} sizes={`(min-width: 64rem) 30vw, ${column()}`} class="ply-light-only" alt="" />
<Picture {...pictureFormats} src={dark} widths={widthsFor(dark, 720)} sizes={`(min-width: 64rem) 30vw, ${column()}`} loading="lazy" class="ply-dark-only" alt="" />

Twins and the fallback complex

ThemedImage writes the twin pair. src is an imported image, which goes through Astro's Picture with the widths and sizes you give, or an address, which becomes a plain img. The twin in dark loads lazily at normal priority, so the theme not in use never competes with the one on screen. A picture that fails to load is hidden. Inside a flush panel on a page of its own (ply-panel ply-panel--flush), fallback={seed} draws the card's complex under the picture, so a missing or failed picture leaves the complex and the panel keeps its shape.

Under a picture in the figure slot, a card draws its complex with no script (ComplexStatic), and the loaded picture covers it. A picture that is slow, missing, or failed leaves the complex. The second card below points at a picture that does not exist.

astro
<Card href="/papers/x/" title="..." meta={["ICLR 2026"]}>
  <ThemedImage slot="figure" src={light} dark={dark} alt="" widths={widthsFor(light, 720)} sizes={`(min-width: 64rem) 30vw, ${column()}`} />
</Card>

Plain HTML

html
<div class="ply-cards">
  <article class="ply-card ply-card--lead">
    <a class="ply-card__panel" href="/papers/x/" tabindex="-1" aria-hidden="true">
      <img src="/x.webp" alt="" />
      <span class="ply-card__labels"><span class="ply-label ply-label--flag">Top 3 paper</span></span>
    </a>
    <div class="ply-card__body">
      <h3 class="ply-card__title"><a href="/papers/x/">Name<span class="ply-card__sub-mark">: </span><span class="ply-card__sub">what it does</span></a></h3>
      <p class="ply-card__meta"><span>ICLR 2026</span><span>Oral</span></p>
      <p class="ply-card__summary">...</p>
    </div>
  </article>
</div>