Skip to content

Post List

Writing index for blogs and notes: compact dated rows, an archive grouped by year with a sticky year label, or detailed entries with excerpt and tags.

Installation

pnpm dlx shadcn@latest add @portfolio-kit/post-list
First time? Add the @portfolio-kit registry to components.json
components.json
{
  "registries": {
    "@portfolio-kit": "https://www.parthjadhav.com/products/portfolio-kit/r/{name}.json"
  }
}

Usage

Examples

Grouped by Year

An archive grouped by year, with the year pinned while its posts scroll past. Tune the pin offset with --post-list-sticky-top.

Detailed

Excerpts and tags under each title, for a blog index where readers skim before they click. A post published elsewhere opens in a new tab and shows ↗.

In a Section

A “Writing” section for a home page: header with a link to the full archive, then the latest posts.

API Reference

Used in