[rtibblesbot]

Summary

• AppBarPage and ImmersivePage render a hidden <h1> until a hasVisibleHeading page's own <h1> appears in #main.

References

Fixes #15467. Heading focus: #15485.

Reviewer guidance

Code review

• usePageHeading observes #main only while the innermost registration sets hasVisibleHeading.
• The shell's own hidden <h1> is excluded by template ref, so it cannot remove itself.
• Risk: focus on the hidden H1 is lost when it unmounts.

QA steps

Setup: Chrome, a screen reader's headings list (NVDA Insert+F7, VoiceOver rotor) or the HeadingsMap extension, DevTools > Network > Slow 3G. Sign in as admin; import a channel with a course.

Where	While loading	After load
Coach, from a class page back to the class list	one hidden H1 "Classes"	one visible H1 "Classes"
Coach > a class > Courses > a course	one hidden H1, the course title	one visible H1, the course title
Device > Info	one hidden H1 "Device info"	one visible H1 "Device info"
Learn > Home; Facility > Data	one hidden H1	one hidden H1, as on develop

Evidence

API delayed 3 s; overlay lists every <h1>.

Loading	Loaded

coach-classes-reload.webm

AI usage

Claude Code wrote the change and its Jest tests.

🤖 Generated with Claude Code

---

Written by rtibblesbot, an LLM-based coding agent.

🟡 Held for manual QA (🧪 Needs QA) Last updated: 2026-10-30 16:30 UTC

[github-actions]

npm Package Versions

Warning

The following packages have changed files but no version bump:

Package	Version	Changed files
kolibri	0.18.0	4

If these changes affect published code, consider bumping the version.

[github-actions]

Build Artifacts

Asset type	Download link
PEX file	kolibri-0.20.0a2.dev1542_g41ceffa6a.pex
Windows Installer (EXE)	kolibri-setup-0.20.0a2.dev1542+g41ceffa6a-unsigned.exe
Debian Package	kolibri-server_0.20.0alpha2dev1542-0ubuntu1_all.deb
Debian Package	kolibri_0.20.0alpha2dev1542-0ubuntu1_all.deb
Mac Installer (DMG)	kolibri-0.20.0a2.dev1542+g41ceffa6a.dmg
Android Package (APK)	kolibri-0.20.0a2.dev1542+g41ceffa6a-debug.apk
Flatpak bundle (GNOME)	org.learningequality.Kolibri.Devel.flatpak
Raspberry Pi Image	kolibri-pi-image-0.20.0alpha2dev1542.zip
TAR file	kolibri-0.20.0a2.dev1542+g41ceffa6a.tar.gz
WHL file	kolibri-0.20.0a2.dev1542+g41ceffa6a-py3-none-any.whl

Smoke test screenshot

Download screenshot

[rtibbles]

The code looks fine from a quick read through, but please write better QA guidance, you can do better than this.

[rtibblesbot]

Rewrote the PR body; the old QA steps and evidence described sibling PRs' flows.

• QA steps: a Where | While loading | After load table for pages whose <h1> renders after load, plus two develop-identical controls; each row except the course page checked live with the API delayed 3 s.
• Same mistake elsewhere in the body: 4 sections — the risk bullets, the 49 evidence captures, the Deviations table, the Register Coach page titles with usePageTitle #15476 reference. All replaced or removed.
• Rebased on develop: Register Coach page titles with usePageTitle #15476 has merged, so Coach course pages now register hasVisibleHeading and the Deviations row no longer holds.
• Course page not captured: the QA seed has no course channel. Evidence is the Coach class list instead.

[rtibbles]

Code changes look good, QA confirmation needed.

[rtibblesbot]

Holding off on changes while this PR is in 🧪 Needs QA — the branch will not move while it is being tested. Questions still get answered.

Change the board status when QA is done and I'll pick up any outstanding review feedback, CI failures and conflicts on the next cycle.

---

Written by rtibblesbot, an LLM-based coding agent.

[rtibblesbot]

Holding off on changes while this PR is in 🧪 Needs QA — the branch will not move while it is being tested. Questions still get answered.

Change the board status when QA is done and I'll pick up any outstanding review feedback, CI failures and conflicts on the next cycle.

---

Written by rtibblesbot, an LLM-based coding agent.