# Photographer portfolio

A free photographer portfolio template built with Astro and TypeScript that publishes as a static site, for wedding, elopement and portrait photographers. Each project is a folder of photos with a Markdown story, and the site adds a lightbox, packages and prices, a journal, an FAQ and an enquiry form.

- Framework: Astro (JavaScript)
- Category: Websites / Portfolios, Creative
- Creates: a static site
- Plan: Free
- Price: Free
- Author: Light Cloud
- Page: https://templates.light-cloud.com/websites/portfolio/photographer-portfolio-template
- Updated: 2026-11-21

## Features

- One folder per project in content/projects/, published at /work/<name>/ with a card on the home page and a sitemap entry
- Responsive WebP at four sizes, fixed width and height, lazy loading below the fold and a blur placeholder per photo
- Full-screen lightbox with arrow keys, Home, End, Escape and touch swipes, and Photo 3 of 10 style counters
- Packages, add-ons, travel and booking terms with From prices, all from content/packages.yaml
- Enquiry form with date, a flexible-date option, type of day, location and guests
- ImageGallery with an ImageObject for every photo, plus ProfessionalService, Person, BlogPosting and FAQPage data
- The build stops if a photo has no alt text; WCAG 2.2 AA in light and dark, with 44 px targets
- Unit tests for JSON-LD, lightbox keys and swipes and the enquiry email, plus a smoke test of the built site

## What you need

- Free plan: it builds to a static site, which the Free plan hosts with no limit on sites
- To run it locally: Node.js 22.18 or later and npm
- Optional: PUBLIC_ENQUIRY_ENDPOINT, a Formspree or similar form URL; without it the enquiry form opens the visitor's email app
- Optional: SITE_URL, your public address for canonical links, sharing images and the sitemap

## About

The business details live in content/site.yaml and each project is a folder with an index.md and its photos, so adding a gallery means copying a folder. At build time sharp turns every photo into WebP sizes and inlines its average colour and a 16 px preview, and the same photo list feeds the gallery HTML, the lightbox and the ImageGallery structured data. Start by setting your details in content/site.yaml, replacing the demo projects and deleting photoCredit so every credit switches to your name. It builds with npm ci and npm run build into dist/, and each push to your copy redeploys, so adding a project is a commit.

## Questions

### How do I make a photography portfolio website without Squarespace or Wix?

Put your details in content/site.yaml, add a folder for each project in content/projects/ with your photos and a short story, and deploy. You get a static site with no builder subscription or plugins to update.

### How do I add a new gallery to this photography template?

Copy a folder in content/projects/, replace the photos, and edit the title, location, date, alt text and captions in its index.md. The folder name becomes the address, for example /work/glencoe-winter-elopement/.

### How do I make portfolio images load fast without losing quality?

Add JPEGs of about 1,800 px and the build makes WebP files at four sizes, lazy loads photos below the fold and gives each one fixed dimensions and a colour placeholder. The README reports Lighthouse mobile performance of 99 to 100.

### How does the enquiry form work on a static portfolio site?

Set PUBLIC_ENQUIRY_ENDPOINT to a Formspree or similar endpoint and the form posts there. Without it, the button opens the visitor's email app with the date, type of day, location and message filled in.

### Can I host this photographer portfolio without Light Cloud?

Yes. Run npm run build and upload dist/ to any static host such as Netlify, Cloudflare Pages or S3 with CloudFront. Each page is a real HTML file, such as dist/work/venice-elopement/index.html.
