WP test container created

README.md

@@ -8,12 +8,39 @@ This first pass covers the common foundation only: fonts, colour, type scale,
 links, buttons, form fields and the footer. Page-specific styling (messages,
 bookstore, menus, the wood and scroll backgrounds) is not here yet.
 
+## Layout
+
+    src/sass/        the stylesheet
+    src/images/      art: the parchment 9-slice, the scroll, the wood ground
+    src/demo/        the static style guide's own chrome
+    site/            WordPress docroot (core is gitignored; see below)
+      wp-content/themes/tlig/    THE DELIVERABLE
+    local/           docker-compose for the clean rig
+
+WordPress core sits in `site/` but is not ours: it is extracted from the Docker
+image so the two cannot drift, and is gitignored. Only the theme and the asset
+mirror are versioned. To recreate core:
+
+    docker run --rm wordpress:php8.3-apache tar -cC /usr/src/wordpress . | tar -xC site/
+
 ## Commands
 
     npm install
-    npm run dev        # demo with live reload, at localhost:5173
-    npm run preview    # demo as a static page, at localhost:4173
-    npm run build      # the deliverable: dist/tlig.css + dist/fonts/
+    npm run dev        # static style guide, live reload, localhost:5173
+    npm run preview    # static style guide as a built page, localhost:4173
+    npm run build      # the theme's stylesheet -> site/wp-content/themes/tlig/assets/
+
+    cd local && RUN_UID=$(id -u) RUN_GID=$(id -g) docker compose up -d
+    # the theme on real WordPress at localhost:8090  (admin / admin)
+
+The rig is deliberately **not** the `wp-migrate` one. That mounts the production
+tree — Avada, 55 plugins, a 1.5 GB database — and exists to mirror what ships.
+This one boots with nothing but core, so the theme has to stand on its own. Keep
+both: the other is the reference to compare against. It runs on 8080, this on
+8090, so they can run side by side.
+
+A `npm run build` lands directly in the running theme — the docroot is this
+project's own `site/`, so there is no copy step and no container restart.
 
 There is no way to open `src/index.html` from disk — it is an ES module that
 imports `.scss`, so it needs one of the two servers above. `file://` gives a