This site

My portfolio, rebuilt on a WordPress block theme I designed and wrote myself, and what I learned keeping the site editor and Git in step.

Solo: design, build, content, SEO

WordPress, custom block theme, theme.json

Designed, built, and launched November 2026

Lauren Kapraun Portfolio, a WordPress Block Theme

The problem

My old portfolio was a hand-coded site I had outgrown. It described a career direction I’ve since moved past, and adding a new project meant editing HTML files by hand.

I wanted a site that showed the work I actually do, building and running websites on WordPress and Shopify, and that was itself proof of it. It also had to be easy for me to keep current, and fast on a phone.

What I decided, and why

Write my own block theme instead of restyling one

A child theme of an existing block theme would have launched sooner. Writing my own shows I can build what those themes are: templates, design tokens, and patterns, with the code public for anyone to read.

Stay on WordPress instead of a static site generator

Tools like Astro are popular for developer portfolios, but the roles I want run on WordPress. Building on the platform I’d be hired to run is the more useful proof.

Put the design system in theme.json

Colors, the two typefaces, fluid type sizes, and spacing all live in one file as tokens. The site editor, the patterns, and my CSS all read from it, so one change updates the whole site.

Write CSS only for what theme.json can’t do

A single stylesheet, loaded on the site and in the editor, handles the few things the block settings can’t. That includes the sticky header clearing the admin bar, the menu underline, a mobile menu that switches on at 644px instead of WordPress’s 600px, and the double-ruled stat boxes.

Track everything in Git from day one

The theme went into a private GitHub repository before the first template was built, so every change has a history and a way back.

What I Built

A blank theme generated with Create Block Theme, grown into:

  • A theme.json design system: six colors, Libre Caslon Text and Nunito Sans self-hosted, fluid type and a spacing scale
  • Templates for the homepage, pages and case studies, including a blank page template, so each page is built from sections
  • Template parts for the header, footer and mobile menu overlay
  • Patterns for repeated sections, such as the closing callout. It’s a synced pattern, so the design updates everywhere while the heading and message can change per page.

What Broke, And How I Fixed It

One evening, every style on the site disappeared at once: the fonts, colors, spacing, the blank template, and the header. The page content was still there.

Earlier, I had saved my site editor changes into the theme files, then discarded those file changes in Git. I didn’t realize the save had also cleared the database copy. Git had no copy either, because I hadn’t committed yet. I recovered the files from the Trash and put each back in place. Then I cleared the leftover database edits WordPress was still preferring over the restored header. Now I commit right after every save, even when a section isn’t finished.

The same week, a pattern file sat in the theme but never appeared in the editor. WordPress caches theme patterns and only refreshes the list when the theme’s version changes. I confirmed the file was being read with WP-CLI, cleared the cache, and turned on development mode locally so theme files are always read fresh while I build.

Results

99

100

1.9s

What I Would Do Next

Trim the fonts

The theme bundles every Nunito Sans weight. Keeping only the weights the site uses makes the theme smaller.

Write short build notes

One-page write-ups on things like the pattern cache, linked from the case studies.

Who did what

This site is mine from end to end. I made the design calls, built the theme in Local and the site editor, and wrote the CSS. Claude was my design and coding partner. It mocked up palette, type, logo, and layout options for me to choose from, reviewed and tidied my CSS, and helped me trace the problems above.

Lunaria Bookshop

Want To Talk About A Website?

Recruiters, hiring managers, and fellow developers are all welcome.