# thatdeveloperguy.com

Illustrated, animated website for ThatDeveloperGuy — government IT, security and real solutions. A lobby with three doors leads into
fully animated rooms (IT Services, Government Solutions, Cybersecurity), each built as a Rive scene over crisp plates and driven by a
data-bound view model.

## Layout

| Path | What |
| --- | --- |
| `app/` | React Router 8 site (SSR off, prerendered). `app/experience/` hosts the room shells and Rive canvases. |
| `content/` | Page content (`page.json` + `body.md`) compiled by `scripts/compile-content.ts`. |
| `src/` | Framework-independent contracts, publication compiler inputs, authority projection, SEO/AEO engines and generated registry. |
| `server/` | Loopback-only Fastify inquiry API. It reports provider acceptance truthfully and stores no submissions. |
| `creative-source/plates/` | Clean-plate pipeline per room: `make-plates.py` (masks, removals, 4x upscale, WebP sets), `make-vectors.py` (Adobe vectorize prep/consume), configs per room. |
| `rive/<room>/` | Rive CLI projects. `build-scene.py` generates `scene.rml` from the plates, fixtures and the room's animation-kit contract; `rive . --verify`, `rive inspect .`, `rive . --screenshot` verify it. |
| `tools/svg2rml.py` | Adobe Illustrator trace SVG → native Rive paths. |
| `.claude/skills/rive-expert/`, `.agents/skills/rive-expert/` | The Rive engineering skill (same content) used by coding agents in this repo. |
| `deploy/` | Generated nginx/systemd deployment boundary and atomic publish scripts; credentials come from git-ignored `private/`. |
| `tests/` | Unit, API, browser, HTTP, accessibility and manual acceptance gates. |

## Build

```sh
npm ci
npm run build:demo        # content → stage assets → react-router build → dist/site
npm run check             # repository audit → types → unit/API → demo release → checksums
npm run test:browser      # rendered navigation, accessibility, failure paths and interaction
```

`dist/site` is the only public document root. Demo releases remain `noindex,nofollow`; production builds include only page records
whose `publicationStatus` is `published`, plus generated robots, sitemap and hierarchical AI-discovery files. `/llms.txt` is the
site-wide index; each public non-home route has its own `<route>/llms.txt`, linked from the root and advertised by that page with
`rel="describedby"`. Changing a demo record to published requires an approval reference and `publishedAt`; completing the artwork
alone does not silently publish unapproved copy.

Rive rooms: `cd rive/lobby && python3 build-scene.py && rive . --verify && rive . --once` (Rive CLI 1.0.4+). Plates and vectors are
produced by the scripts in `creative-source/plates/` and need Cloudinary / Adobe access.