3.3 KiB
Speaking Lab Focused Learning UI Design
Goal
Refine Speaking Lab's interface so it feels more like a focused English learning product instead of a generic admin-style dashboard.
The selected direction is a clean, focused learning workspace with small icon-led status cards.
Visual Direction
Use a restrained learning-app style:
- calm background
- white panels
- compact cards
- clear learning status
- small icons beside dashboard metrics
- strong but limited teal accent
- softer supporting colors for learned, unstudied, favorites, and difficult items
Avoid:
- heavy marketing hero styling
- decorative blobs
- large gradients
- overly colorful one-off cards
- changing the app structure or data model
Scope
This UI pass includes:
- Home dashboard metric cards with small icons.
- More learning-oriented dashboard card layout:
- icon on the left
- label and hint in the middle
- count on the right
- Home material cards with slightly clearer hierarchy.
- Study page visual polish:
- video panel feels like a focused practice surface
- subtitle area feels more like a training prompt
- transcript lines have clearer current, practiced, and difficult states
- toolbar buttons feel less generic
This UI pass excludes:
- README edits.
- Backend changes.
- New API endpoints.
- New user data fields.
- Real icon libraries.
- Custom thumbnail upload.
- Major layout restructuring.
Home Page Details
Dashboard metric cards should use text icons implemented in HTML/CSS:
- current materials:
:: - studied: check mark
- unstudied: clock-like circle
- favorites: heart
- difficult materials: marker symbol
Icons should be small and familiar, with soft tinted backgrounds.
Metric cards should remain clickable filters.
The active metric card should still be visually obvious, but it should not feel like a dark admin button. Use a restrained accent state.
Study Page Details
The study page should better communicate that the learner is practicing English:
- Use a slightly softer page background.
- Keep the video as the main focus.
- Make the subtitle card look like a prompt area:
- primary English line larger and clearer
- Chinese line quieter
- enough padding for comfortable reading
- Make the tool row more compact and training-like.
- Make transcript rows cleaner:
- active row has a visible left accent
- practiced row has a soft green treatment
- difficult row has a soft amber treatment
- status buttons remain easy to scan
No behavior changes are required.
Testing
Automated checks:
node --check home.js
node --check app.js
node --check admin.js
python -m py_compile backend\main.py backend\db.py
node tests\progress-helpers.test.mjs
node tests\admin-file-input.test.mjs
Browser checks:
- Open
http://127.0.0.1:8000/. - Confirm dashboard metric cards show small icons.
- Confirm metric cards still filter materials.
- Confirm home cards still open
study.html?video=<id>. - Open
http://127.0.0.1:8000/study.html. - Confirm video area, subtitle prompt, toolbar, and transcript look more like a learning workspace.
- Confirm no text overlaps on the current browser width.
Future Extensions
Later UI improvements can include:
- replacing text icons with a real icon library
- custom cover images
- a dedicated difficult-sentence review page
- daily learning streaks