Skip to content
← Public packages

@kentcdodds/photo-portfolio

A fast, photo-first portfolio site you update by chatting with your agent: galleries, about, contact, and one-step rollback.

FollowFork

Files

README.md

112 lines · 6.4 KB · Markdown

Photo Portfolio

A fast, photo-first portfolio website for photographers, run from your Kody account. You never touch code: tell your agent what to change ("add these photos as a new gallery", "update my bio", "publish") and it does it.

Home page with a full-width hero photo, tagline, and featured galleries

Intent

Give a photographer a beautiful, quick-loading site that works the moment it is installed, and that she can keep up to date entirely by chatting with her agent:

  • Home with a hero photo and featured galleries
  • Galleries with a justified photo grid and a full-screen viewer (arrow keys, swipe on phones, a shareable link for every photo)
  • About with her photo and bio
  • Contact form (messages are saved and emailed to her), her email and phone, and an optional "Book a session" link to Calendly, cal.com, or similar
  • Light and dark mode, an accent color of her choice, and proper link previews when a gallery is shared on social media

Every change lands in a draft first. She can open a private preview link, then publish. Every publish is saved as a version, so any mistake is one sentence away from being undone.

Get your own copy

  1. Sign in at kody.codes (a free account is enough to try it).
  2. Open the Photo Portfolio listing in the Kody community.
  3. Click the fork icon beside the name, then click it again to confirm.
  4. Choose Use in agent and say: "Show me my photo portfolio site."

The copy starts with sample galleries and placeholder text so you can see how it looks right away. Replace them whenever you are ready.

Things to say to your agent

You sayWhat happens
"Set my name to Jane Doe, my email to jane@example.com, and my Instagram to instagram.com/janedoe."Updates your details in the draft
"Here's my bio: …" / "Use this photo as my headshot."Updates the About page
"Make a gallery called Smith Family with these photos." (attach or link them)Resizes the photos and adds a draft gallery
"Add these to the Weddings gallery."Adds photos to an existing gallery
"Use the third photo as the cover." / "Caption the first one 'First look'."Edits the gallery
"Put Weddings first."Reorders galleries
"Remove the sample galleries."Removes them (it will ask you to confirm)
"Let me preview it."Sends a private preview link of your unpublished changes
"Publish."Makes the draft live and saves a version
"Undo the last publish." / "Go back to how it looked yesterday."Rolls back to an earlier version
"Any new inquiries?"Lists contact-form messages
"Make the accent color deep green." / "Always use dark mode."Changes the look
"Add my Calendly link: https://calendly.com/janedoe."Adds a Book a session button

Photos: JPEG, PNG, or WebP up to 30 MB and 12 megapixels (a normal "export for web" from Lightroom is perfect). Send a few at a time; the agent batches them. iPhone HEIC photos need converting to JPEG first.

Your own domain (coming soon)

Kody custom domains are on the way. Until then the site lives at your Kody address. When custom domains arrive:

  1. Buy a domain (for example janedoephoto.com) from any registrar.
  2. Connect it in Kody (instructions will be linked here).
  3. Tell your agent: "My site's address is now https://janedoephoto.com." That updates search-engine links, the sitemap, and social previews.

What it costs

PlanWhat fitsPrice
FreeTrying it out with the sample galleries and a handful of your own photos (16 MB of storage)$0
ProA real portfolio: room for thousands of photos (each uploaded photo uses about 4 to 6 MB once all its sizes are stored)$12/month or $120/year

Ordinary portfolio traffic fits comfortably inside Pro's included usage. A custom domain, when available, is billed by your domain registrar (usually $10 to $20 per year).

Privacy

  • Location (GPS) and camera serial data are stripped from every photo.
  • Your copyright can be written into downloaded JPEGs (on by default).
  • Contact-form messages stay in your Kody account and in your email.

Done when

  • Your name, bio, photo, and contact details show on the site
  • Your galleries replace the samples and look right on a phone and a laptop
  • A test message from the contact page reaches your email
  • You can preview, publish, and undo without help

Sample photo credits

The sample galleries use public-domain (CC0) photos from Wikimedia Commons:

PhotoPhotographerSource
Backlit Margarita Island sunset, Las Guevaras, VenezuelaWilfredorCommons
Lever du 16 Juillet 2025SmailtnCommons
Parasols, evening, beach, Rincón de la Victoria, SpainJebulonCommons
Watch tower of the dam, Embalse de los Bermejales, SpainJebulonCommons
Scuol-Motta Naluns, 15-09-2023Agnes MonkelbaanCommons
Jacques-Cartier National Park from the Wolves peak, QuébecWilfredorCommons
Landscape, snowy hills, HeraklionJebulonCommons
Landscape of Mongolia 01Bernard GagnonCommons
Person in winter clothing in Québec CityWilfredorCommons
Courtyard, Zappeion, AthensJebulonCommons
San Juan ValleyWilfredorCommons
Pont ferroviaire de Tamera, NefzaSmailtnCommons

MIT licensed. See LICENSE.