Files
speaking-practice/docs/superpowers/specs/2026-06-02-speaking-lab-study-focus-layout-design.md
T
2026-06-03 00:34:42 +08:00

1.7 KiB

Speaking Lab Study Focus Layout Design

Goal

Make the study page focus on the active learning session by removing the left material rail. Material discovery now lives on the home page, so the study page should give more room to the video, subtitle controls, and transcript.

Scope

Included:

  • Remove the left material rail from study.html.
  • Let the video learning panel occupy the space previously used by the rail.
  • Keep the right transcript panel.
  • Keep video playback, line navigation, recording, subtitles, continue learning, favorites, and watch-later.
  • Keep admin access on the home page; the study page no longer needs the rail-side admin button.
  • Add JavaScript guards so removed rail elements do not cause runtime errors.

Excluded:

  • Home page changes.
  • README changes.
  • Backend changes.
  • Admin page changes.
  • New navigation or routing.

Behavior

The study page still opens the selected material from study.html?video=<id>.

If the user opens study.html directly:

  • The page selects the previously active video or the first available video.
  • The user can return to the home page manually through browser navigation or direct URL.

The material list search and tag filtering UI is removed from the study page.

Testing

Run:

node --check app.js
node --check home.js
node --check admin.js
node tests\progress-helpers.test.mjs
node tests\admin-file-input.test.mjs

Manual checks:

  1. Open http://127.0.0.1:8000/study.html.
  2. Confirm the left material rail is gone.
  3. Confirm the video panel starts near the left edge of the study layout.
  4. Confirm subtitle tabs and transcript still render.
  5. Open from a home card and confirm study.html?video=<id> still selects the material.