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.
by Light CloudPortfolios, Creative


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.
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.
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/.
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.
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.
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.