docs: shared PyAuto Furo theming + GitHub Pages hub (phases B+C)

[Jammy2211]

Overview

Phases B+C of the docs-infrastructure middle path (census + decision record: PyAutoLabs/PyAutoFit#1341; phase A — RTD hygiene + docs CI — merged 2026-07-09). Phase B gives PyAutoFit/PyAutoGalaxy/PyAutoLens a shared bespoke brand layer on their Furo/ReadTheDocs docs; phase C ships this repo: a bespoke static front door at pyautolabs.github.io linking the docs, workspaces, HowTo courses and the AI-assistant path.

Zero-cost constraint (user decision): free infrastructure only — *.readthedocs.io stays canonical, the hub lives on the default pyautolabs.github.io domain. Custom domains (docs.pyautolens.org etc.; all relevant .orgs verified unregistered 2026-07-09) are a later config-flip retrofit documented in RETROFIT.md.

Plan

• Phase C (this repo): self-contained static index.html (no external assets, light/dark via prefers-color-scheme, per-project accent colors), RETROFIT.md (paid-domain upgrade path), README.md, .nojekyll; GitHub Pages serves main. AI-assistant framing per the established user-docs convention (point ChatGPT/Claude at autolens_assistant; agentic tools first-class).
• Phase B (three library repos, branch feature/docs-theming-hub): one shared docs/_static/pyauto.css + Furo html_theme_options per repo — common brand layer, per-project accent (Fit #e0700e amber, Galaxy #0d9488 teal, Lens #7c4dff purple — matching the hub), light+dark variables both styled. PyAutoFit needs its .gitignore docs/_static entry lifted (the reason its css never existed). Docs CI (shipped in phase A) guards the builds; baselines should hold (theming adds no warnings).
• Verify: local Sphinx builds before/after per repo (warning counts vs baselines 67/105/134), rendered-page spot checks in both color schemes; full test suites per the ship gate.

Detailed implementation plan

Affected Repositories

• pyautolabs.github.io (primary; new repo, created 2026-07-09 — work on main)
• PyAutoFit, PyAutoGalaxy, PyAutoLens (theming PRs)

Branch Survey

All three library repos: clean on main (phase A merged; claims released). Suggested branch: feature/docs-theming-hub, worktree ~/Code/PyAutoLabs-wt/docs-theming-hub/.

Implementation Steps

1. Hub: commit index.html, RETROFIT.md, README.md, .nojekyll to main; verify https://pyautolabs.github.io serves.
2. Per library repo: add docs/_static/pyauto.css (shared, identical file); set html_static_path, html_css_files = ["pyauto.css"], html_theme_options with light_css_variables/dark_css_variables (brand + accent); Fit only — remove docs/_static from .gitignore.
3. Rebuild docs per repo; confirm warning counts unchanged vs baseline; spot-check rendering light+dark.
4. Ship per the autonomous-ship gate; PRs end at PR-open with validation checklists.

Key Files

• pyautolabs.github.io/index.html — the front door
• PyAuto{Fit,Galaxy,Lens}/docs/_static/pyauto.css — shared brand layer
• PyAuto{Fit,Galaxy,Lens}/docs/conf.py — theme options
• PyAutoFit/.gitignore — lift docs/_static

Registry

• Register pyautolabs.github.io in PyAutoMind/repos.yaml (the body map) and run repos_sync.py --write.

Original Prompt

Click to expand starting prompt

See PyAutoMind/issued/docs_theming_and_hub.md — carries the verbatim original request, the middle-path decision and the zero-cost constraint.

[Jammy2211]

End-of-night state (supervised run) — hub LIVE, theming at PR-open

Phase C is live: https://pyautolabs.github.io — self-contained static front door (light/dark, per-project accents), RETROFIT.md documents the paid-domain flip, repo registered in the PyAutoMind body map. Served by Pages from main.

Phase B is at PR-open, one PR per library, pending-release:

• PyAutoFit #1343 — amber accent + shared css (+ lifts the docs/_static gitignore)
• PyAutoGalaxy #496 — teal accent + shared css
• PyAutoLens #598 — purple accent (now with dark variant) + shared css

Gate: suites 1424/962/373 pass · smoke n/a · review CLEAN · Heart YELLOW with the reason set verified identical to tonight's earlier in-session ack (treated as launch-time ack; validate on the PR checklists). Warning baselines unchanged (67/105/134); the phase-A docs CI check guards each PR.

Morning checklist (human):

1. Review + merge the three theming PRs (any order — no cross-repo dependency; the docs checks should be green).
2. Eyeball https://pyautolabs.github.io in light and dark; amendments welcome — it's a plain index.html.
3. RTD dashboard legs from docs: RTD hygiene — reconnect PyAutoFit RTD, converge conf.py, add docs CI PyAutoFit#1341 (reconnect pyautofit, repoint galaxy/lens URLs) — after the theming merges, the rebuilt RTD sites will show the brand layer.
4. The pyautofit docs site stays visually stale until both (1) and (3) happen — merge order between them doesn't matter.

[Jammy2211]

Complete (2026-07-10) — everything in scope shipped, merged and verified live

• Hub: https://pyautolabs.github.io serving (phase C).
• Theming (phase B): Fit#1343 + Galaxy#496 + Lens#598 all merged; RTD rebuilt via the repaired webhooks; all three live docs sites verified serving pyauto.css + the per-project Furo brand variables.
• One catch by the new docs CI worth recording: Lens's .gitignore had docs/_static ignored (same latent issue phase A found in Fit), so the first Lens PR silently omitted pyauto.css — the warning-baseline check failed the PR (135 vs 134), the ignore was lifted, and the asset committed. The guard works.
• Worktrees removed, branches deleted, task retired in Mind.

Related: PyAutoLabs/PyAutoFit#1341 (phase A + RTD revival) closed earlier today. The zero-cost → paid-domain upgrade path lives in RETROFIT.md.