Skip to content

Designer Portfolio with Project Image Hover

Dark pure CSS portfolio list with large project names that reveal each project photo in a side stage on hover or keyboard focus.

Also known as: project list hover preview, portfolio list with image reveal, hover reveal portfolio, case study index, designer portfolio section

Designer Portfolio with Project Image Hover live demo

Open in new tab

Pure CSS code (HTML, CSS)

A dark designer portfolio section built with pure CSS: a numbered list of projects in large type, where hovering or focusing a row reveals that project's photo in a tall image stage on the right. It suits personal portfolios, studio websites and case study indexes. No JavaScript is needed.

How it works

The root section.pph-portfolio holds a .pph-head with an eyebrow and title, followed by .pph-body, which wraps an ordered list .pph-list. Each li.pph-item contains one a.pph-link with a .pph-num, a .pph-text block (.pph-name and .pph-tags), a .pph-year, an arrow icon .pph-arrow and the project photo inside .pph-media.

On wide screens with a mouse (min-width: 860px and hover: hover), .pph-list reserves space on the right with margin-right, and every .pph-media is absolutely positioned against .pph-body, so all photos stack in the same stage. They are hidden with clip-path: inset(100% 0 0 0). When a link is hovered or receives keyboard focus, its photo is revealed with clip-path: inset(0) while the image scales from 1.18 down to 1, giving a wipe-and-settle effect. The project name turns to the accent color and slides right, the arrow rotates, and the other names are dimmed through :has().

When nothing is hovered or focused, .pph-list:not(:has(.pph-link:hover, .pph-link:focus-visible)) keeps the first project active, so the section never shows an empty stage. On phones and touch devices the stage is not used; each row simply shows its photo as a small rounded thumbnail.

Customization

  • --pph-accent on .pph-portfolio: color of the active project name, the arrow, the eyebrow dot and the focus ring.
  • --pph-bg, --pph-text and --pph-muted: background, main text and secondary text colors. Swap them for a light portfolio.
  • --pph-media-width: width of the image stage on desktop, for example 45% for bigger photos.
  • --pph-speed: duration of the reveal, the name slide and the arrow rotation.
  • --pph-radius: corner radius of the image stage.
  • Change the clip-path start value in the desktop .pph-media rule, for example inset(0 100% 0 0), to wipe the photo in from the left instead of from below.
  • Add or remove li.pph-item rows; the stage height follows the height of the list.

Use cases

  • Personal portfolios: large project names reveal a photo in a tall stage on the right on hover
  • Design studios: a numbered list with tags and years works as a case study index
  • Keyboard users: focusing a row triggers the same photo reveal as hovering
  • Touch devices: each row shows its photo as a small thumbnail instead
  • Dark sites: the first project stays active so the stage is never empty

Accessibility

The projects are an ordered list of real links, so they are reachable with Tab and announced with their name, tags and year. Each photo has a descriptive alt text. :focus-visible triggers the same reveal as hover and draws an outline in the accent color, so keyboard users get the full effect. The decorative numbers and arrows are aria-hidden. Text colors meet WCAG AA contrast on the dark background. With prefers-reduced-motion: reduce all transitions are removed and photos switch instantly.

Usage notes

The photos come from Unsplash and should be replaced with your own project images; keep a portrait crop (about 720 by 880) so they fill the stage. The default-active first row relies on :has(); in older browsers the stage is simply empty until a row is hovered.

Designer Portfolio with Project Image Hover at a glance

Framework
Pure CSS
Code
HTML, CSS
JavaScript
Not needed, CSS only
Dependencies
None
Layout
Responsive, works on mobile, dark design
Category
Portfolios
License
Free for personal and commercial use

Questions about this template

Can I use the Designer Portfolio with Project Image Hover code for free?

Yes. You can copy or download the code and use it in personal and commercial projects, including client work. No sign-up is needed. Reselling it as part of a component library or template collection is not allowed; see the license.

How do I add it to my website?

There is nothing to install. Paste the HTML where the component should appear and add the CSS to your stylesheet. Download HTML gives you a complete page with everything already linked.

Does it need jQuery or a JavaScript framework?

No. It is built with HTML and CSS only, so there is no JavaScript to load.

Does it work on mobile?

Yes. The layout adapts to small screens. Use the Mobile and Tablet buttons above the live demo to check it at phone and tablet width.

Requirements

No dependencies. Pure HTML, CSS and JavaScript.

Designer Portfolio with Project Image Hover – Pure CSS portfolios component screenshot
Designer Portfolio with Project Image Hover · Pure CSS Portfolios

More Portfolios

Developer Portfolio Page – Tailwind CSS portfolios preview

Developer Portfolio Page

One-page Tailwind CSS developer portfolio with sticky mobile menu, hero stats, filterable project grid, experience timeline and a validated contact form.

Photographer Portfolio with Photo Grid – Bootstrap 5 portfolios preview

Photographer Portfolio with Photo Grid

Dark Bootstrap 5 photographer portfolio with subject filters, a full-bleed dense photo grid with wide and tall tiles, hover captions and a modal lightbox.

Agency Case Study Grid with Images – Tailwind CSS portfolios preview

Agency Case Study Grid with Images

Dark Tailwind CSS portfolio grid of agency case studies with project photos, client, year, key results and service filter buttons.