About Services Tools Blog Contact us

Folder-Driven Portfolio Site

A portfolio whose galleries are image files in folders, with a full-screen viewer and a reviews slider read from a text file.

  • Websites & CMS
  • Cross-sector
  • Website
  • Productised
  • Cloud
  • 2025

The problem

Recording every picture in a template or a database is more admin than the work deserves. So new work waited until someone had time to add it. Adding a piece of work should mean dropping a file in a folder.

What it does

The site scans the image folders and skips anything that is not an image. Each gallery shows thumbnails that load as the visitor scrolls and open in a full-screen viewer. A companion text file holds the review text, which is split at the picture markers and paired in order with the review images.

Outcomes

  • A new picture goes live when its file is dropped in a folder.
  • Galleries keep the order of the files in the folder.
  • Each review stays paired with its image.
  • No database entry is needed for any picture.

Simplified mockup

Interactive preview with sample data. Nothing is sent to a server.

Willow Quay Studio

sketches/charcoal · folder order
oils/colour studies
studies/pencil

Review carousel

1 of 4
Paired from reviews/reviews.txt picture markers
Review image of a dance sketch
“They worked at the edge of the marquee and finished twelve sketches before the band packed away. Guests queued, rather than being pulled over.”
picture 1 · Helen Crowe, Maidstone · paired with reviews/r1.png
reviews/reviews.txt
picture 1
They worked at the edge of the marquee and finished twelve sketches before the band packed away.

picture 2
The oil of the top table arrived six weeks later, framed. The colour of the dress matched.

picture 3
We asked for the first dance rather than a posed line-up.

picture 4
A study of the venue doorway, drawn the week after from a photograph.

Folder scan

content/ · unsorted drop
PathKindExpect
sketches/01–05.pngimagegallery
sketches/notes.txttextskip
sketches/contact-sheet.pdfdocumentskip
oils/01–04.pngimagegallery
oils/delivery-note.pdfdocumentskip
studies/01–03.pngimagegallery
studies/.DS_Storesystemskip
reviews/reviews.txttextcarousel
reviews/r1–r4.pngimagepaired

How it works

  1. Scan the image folders and skip non-images.
  2. Turn each folder into a gallery of thumbnails.
  3. Open a thumbnail in a full-screen viewer.
  4. Split the companion text file and pair it with the review images.
  5. Step through the reviews with arrows, and keep saved copies in the visitor's browser so repeat visits are quick.

Pipeline

flowchart LR
  Folders[Image folders] --> Scan[Folder scan]
  Scan --> Galleries[Galleries]
  Galleries --> Light[Lightbox]
  Reviews[Review text file] --> Carousel[Review carousel]
  Galleries --> Page[Portfolio page]
  Carousel --> Page

Output