Phase 6: Verify & Iterate

Seed content, run the dev server, compare screenshots, and iterate until pages match.

6.1 Apply the Seed

# Validate first
emdash seed --validate

# Apply seed with content
emdash seed

6.2 Start Dev Server

Kill any existing server first:

lsof -ti:4321 | xargs kill -9 2>/dev/null || true
pnpm dev

6.3 Screenshot Each Page Type

Screenshot every page type you captured in Phase 1:

# Homepage
agent-browser open http://localhost:4321
agent-browser screenshot output/homepage.png --full

# Single post
agent-browser open http://localhost:4321/posts/hello-world
agent-browser screenshot output/single-post.png --full

# Blog archive
agent-browser open http://localhost:4321/posts
agent-browser screenshot output/archive.png --full

# Category page
agent-browser open http://localhost:4321/categories/news
agent-browser screenshot output/category.png --full

# Static page
agent-browser open http://localhost:4321/pages/about
agent-browser screenshot output/page.png --full

# 404 page
agent-browser open http://localhost:4321/nonexistent
agent-browser screenshot output/404.png --full

6.4 Compare & Iterate

Compare each screenshot pair:

Page Type	Reference	Output
Homepage	`discovery/screenshots/homepage.png`	`output/homepage.png`
Single Post	`discovery/screenshots/single-post.png`	`output/single-post.png`
Archive	`discovery/screenshots/archive.png`	`output/archive.png`
Category	`discovery/screenshots/category.png`	`output/category.png`
Page	`discovery/screenshots/page.png`	`output/page.png`
404	`discovery/screenshots/404.png`	`output/404.png`

For each page, identify differences and fix:

Layout - CSS grid/flexbox, content width, spacing
Typography - Font family, sizes, line height
Colors - Background, text, links, borders
Components - Headers, footers, cards, buttons
Responsive - Check mobile viewport too

Re-screenshot after each round of fixes.

Don't aim for pixel-perfect - aim for "same design language."

6.5 Final Build Test

pnpm run build

License Compliance

WordPress themes are GPL-licensed. Every ported theme needs:

LICENSE - GPL-2.0 text (download with curl, don't output directly):

curl -o LICENSE https://raw.githubusercontent.com/spdx/license-list-data/main/text/GPL-2.0-or-later.txt

README.md - Credits to original theme
package.json - "license": "GPL-2.0-or-later"

2.7 KiB Raw Permalink Blame History