# Portfolio Project Card: Timeline Project Card

A vertical rail grouped by year, each project a compact row with a square thumbnail, name, role, and a one line outcome.

- Page: https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/timeline-project-card
- Collection: [Portfolio](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro), Standard tier
- Group: [Project Cards](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/timeline-project-card.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/portfolio-pro-project-cards-timeline-project-card
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: lucide-react
- shadcn/ui components: placeholder
- Installs to: `@/components/blocks/portfolio-pro/project-cards/timeline-project-card`

## About this block

Timeline Project Card hangs the work off a vertical rail
grouped by year. Each year is marked with a dot and a
connecting line, and every project below it is a compact
linked row: a square Placeholder thumbnail, the project
name with an ArrowUpRight icon, the role, and a one-line
outcome. It runs newest first, from Ledger in 2025 down
through Tend and Field Notes in 2024 to Atlas in 2023.

Years are an array of groups, each holding its own array of
projects. The chronological rail is the distinctive choice:
it reads as a career narrative, showing not just what was
built but the order it was built in and how the work grew.

## When to use

Reach for this block on an about or work page when the
sequence of the work is part of the story, a track record
rather than a flat grid. The installer swaps the years,
projects, roles, and outcomes for their own history and
points each row at the right case study.

A natural flow around it on a Portfolio Pro page:

**Before**

- [Name and role hero](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/hero-sections)
- [About the practice](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/about-sections)

**After**

- [Experience list](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/experience-sections)
- [Contact band](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/cta-sections)

## What you can display

One strong use is the chronological work history for a
mid-career designer. Other uses:

- **Studio timeline.** Each entry is a launch or campaign,
  the role naming the studio's part in it.
- **Career recap.** Roles held by year, the outcome line
  summarizing each tenure.
- **Release log.** Product versions by year, the outcome
  naming what each release shipped.

> Tip: keep one to three rows per year so the rail stays
> readable; a year crowded with entries reads as a list
> and loses the shape of the timeline.

## More in Portfolio Project Cards

- [Before After Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/before-after-card)
- [Bordered Project Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/bordered-project-card)
- [Case Study Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/case-study-card)
- [Compact Grid Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/compact-grid-card)
- [Duo Tone Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/duo-tone-card)
- [Featured Project Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/featured-project-card)
- [Hover Reveal Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/hover-reveal-card)
- [Image Stack Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/image-stack-card)
- [Minimal List Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/minimal-list-card)
- [Minimal Project Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/minimal-project-card)
- [Next Project Teaser](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/next-project-teaser)
- [Numbered Project Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/numbered-project-card)
- [Overlay Caption Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/overlay-caption-card)
- [Project Card With Tags](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/project-card-with-tags)
- [Project List Row](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/project-list-row)
- [Quote Project Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/quote-project-card)
- [Split Project Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/split-project-card)
- [Stat Project Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/stat-project-card)
- [Tag Heavy Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/tag-heavy-card)
- [Tall Project Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/tall-project-card)
- [Text Only Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/text-only-card)
- [Wide Project Row](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/wide-project-row)
- [Year Badge Card](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/project-cards/year-badge-card)
