Merge pull request #45 from zz-plant/codex/add-testing-section-to-readme

Document testing commands in README

Author: zz-plant

README.md

@@ -12,11 +12,20 @@ This repository powers [ethotechnics.org](https://ethotechnics.org), a content-d
 
 Use `npm run check` for a full pre-commit sweep. It will run linting, tests, TypeScript checks, and Astro's checker (skipping any step that is not configured).
 
-## End-to-end tests
+## Testing
 
-- `npm run e2e` builds the Worker bundle and runs Playwright against `npm run preview`.
-- Override the preview target with `PLAYWRIGHT_BASE_URL` (defaults to `http://127.0.0.1:4321`).
-- CI uses `npm run e2e:ci` and publishes the Playwright HTML report as a workflow artifact.
+### Unit and component tests (Vitest)
+
+- `npm test` runs Vitest in watch mode. Expect green checkmarks per suite and a summary such as `Test Files  3 passed` and `Tests  7 passed` when everything succeeds.
+- Component rendering tests use the experimental Astro container (`src/test/astro-container.ts`) and run under Node with jsdom helpers, so no browser is required.
+- CI uses `npm run test:ci` to execute once with coverage; mirror this locally to see the coverage table emitted at the end of the run.
+
+### End-to-end tests (Playwright)
+
+- Install Playwright browsers once with `npx playwright install --with-deps` so local runs match CI; Linux dependencies are included in that command.
+- `npm run e2e` builds the Worker bundle and runs Playwright against `npm run preview` on `http://127.0.0.1:4321` (override with `PLAYWRIGHT_BASE_URL`). Successful runs show Playwright's test list with ✅ markers and a final summary of passed specs and duration.
+- For iterative debugging, start the preview server separately (`npm run build && npm run preview`) in one terminal and run `npm run e2e` in another to reuse the server instead of rebuilding each time.
+- CI uses `npm run e2e:ci`, which emits line-reporter output and publishes the Playwright HTML report as a workflow artifact.
 
 ### Environment configuration