Build Components

Post list

Blog posts as cards or a list: a title that links, a date in words and a summary.

Pattern
List of articles
Category
Content · Articles & text
Outputs
React + Tailwind (Next.js or any React app), HTML/CSS/JS, Vue (Nuxt), Svelte (SvelteKit), Astro, Angular, Solid, Web Component
Status
In stock, tested

Test bench

Runs the exported code, not a mock-up.

Output
Screen width

Post list · React + TailwindFull width

Keyboard map
KeysWhat happens
TabMoves from post to post: each card is one link, named by its title.
EnterOpens the post.

Take it home

React + Tailwind CSS v4: install with one command, or copy the file. Your options are already in it.

npx shadcn@latest add "/r/post-list.json"

Run it in your project root. It writes components/post-list.tsx with the options you set here. Needs Tailwind CSS v4 and a project set up for the shadcn CLI (npx shadcn@latest init).

Use it with your own data

import { PostList } from "@/components/post-list";

<PostList config={{ posts: yourData }} />

Pass only what changes: the rest keep the options set in the file. posts takes the same shape as the file's own list.

Changes

This is 1.4.0. A copy you took names its version on its first line.

  1. 1.4.013 October 2026

    Added. The React component takes config as just the options you pass, so data from your page (a list of products, the options of a select) goes straight in; the rest keep the file's defaults. Every file now carries its licence: MIT.

  2. 1.3.010 October 2026

    Added. On small screens the cards can become a slider: when there are more than 4 (the default), always, or never; with buttons, dots and the position in words. Its cards take a theme's surface style.

  3. 1.2.09 October 2026

    Added. An Astro file, and the Vue and Svelte files now tested in Nuxt and SvelteKit too: rendered on the server, then started in the browser.

  4. 1.1.05 October 2026

    Added. Every word it says by itself is an option (the Words group), so it can speak your page's language; the editor fills them in for ten languages.

  5. 1.0.04 October 2026

    Released.

Follow changes to Post list (RSS)

Last test run

5 October 2026, at commit 0adb641: this part's own tests, in every output: React, HTML/CSS/JS and the five framework files.

  • Chromium21 passed
  • WebKit (Safari's engine)21 passed
  • iPhone, emulated21 passed

What every part is tested for

Found a problem?

Write to us: the subject already names the part and this version.

Report a problem with Post list