From c18a5d4c2d6d250724e8d07f4583a73f73a7382b Mon Sep 17 00:00:00 2001 From: TTlaji Date: Mon, 8 Jun 2026 22:52:36 +0800 Subject: [PATCH] Add button chip style refresh design spec --- ...ng-lab-button-chip-style-refresh-design.md | 117 ++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 docs/superpowers/specs/2026-06-08-speaking-lab-button-chip-style-refresh-design.md diff --git a/docs/superpowers/specs/2026-06-08-speaking-lab-button-chip-style-refresh-design.md b/docs/superpowers/specs/2026-06-08-speaking-lab-button-chip-style-refresh-design.md new file mode 100644 index 0000000..9a824fb --- /dev/null +++ b/docs/superpowers/specs/2026-06-08-speaking-lab-button-chip-style-refresh-design.md @@ -0,0 +1,117 @@ +# Speaking Lab Button and Chip Style Refresh Design + +## Goal + +Refresh all Speaking Lab buttons and chips into a flatter, more refined style inspired by the saved TEco Lab reference page while preserving the current HTML structure and class names. + +This is a CSS-only visual refactor unless implementation discovers a narrow accessibility issue that cannot be solved with CSS. Existing behavior, event wiring, IDs, and class names must remain unchanged. + +## Reference Interpretation + +The TEco Lab reference uses compact controls with: + +- rounded-full chips and rounded-lg buttons; +- small, dense typography around 12px to 14px; +- low-contrast neutral backgrounds for inactive controls; +- solid dark/highlight backgrounds only for active or primary controls; +- minimal borders, soft inset or low shadow texture, and smooth hover/active feedback. + +Speaking Lab should adapt those ideas to its Study Notebook direction: warm paper surfaces, deep green primary actions, subdued neutrals, and soft warning colors. + +## Scope + +Update `styles.css` for these existing selectors and related states: + +- `.chip` and `.chip.active`; +- `.secondary-action`; +- `.danger-action`; +- `.primary-link`; +- `#adminSubmitBtn`; +- primary form buttons such as `.auth-form button[type="submit"]`, `.admin-form button[type="submit"]`, `.activation-code-form button[type="submit"]`, and `.practice-answer-row button`; +- relevant disabled, hover, active, and focus-visible states. + +Do not rename selectors, add new required HTML, or change JavaScript behavior. + +## Visual Rules + +### Chips + +`.chip` should become a compact capsule: + +- pill radius; +- 12px font size; +- medium-bold weight; +- horizontal padding that supports short Chinese labels without crowding; +- inactive background in warm light neutral; +- no hard border in the default state; +- hover background slightly darker with subtle elevation; +- `.active` background deep green or dark ink, white text, and a low shadow. + +### Secondary Actions + +`.secondary-action` should be quiet and tactile: + +- no heavy border; +- light warm neutral or translucent white background; +- muted text color; +- rounded-lg or small pill shape depending on existing dimensions; +- hover smoothly darkens the surface and text; +- active state gently presses down; +- disabled state is visibly inactive without looking broken. + +This should cover admin entry, logout, cancel edit, refresh, edit, copy, and other secondary operations that use this class or existing secondary-action variants. + +### Danger Actions + +`.danger-action` should be soft warning, not pure red: + +- pale rose background; +- dark rose text; +- transparent or rose-tinted border; +- hover deepens the rose background and text slightly; +- active state presses down; +- disabled state uses muted rose/neutral colors. + +### Primary Actions + +`#adminSubmitBtn`, `.primary-link`, login submit, activation-code submit, AI primary action, and practice check buttons should share a clear primary treatment: + +- solid deep green background; +- white or warm-white text; +- minimal border matching the background; +- rounded pill or 10px radius based on control context; +- subtle shadow/elevation; +- hover slightly lightens or darkens while lifting by 1px; +- active removes the lift and compresses visually; +- focus-visible ring uses a soft green halo. + +## Compatibility + +The changes must not break: + +- home category filters and material cards; +- study mode tabs and recording/sentence controls; +- login/register form controls; +- admin create/edit form buttons; +- admin video/user/activation-code action rows; +- disabled buttons and hidden states. + +Existing responsive rules should keep working. If a button currently becomes full-width or wraps on small screens, preserve that behavior. + +## Testing + +Verification should include: + +- syntax sanity via existing JS checks if implementation touches no JS; +- browser visual checks for home, study, admin, and login pages; +- at least one desktop viewport and one mobile-width viewport; +- confirm hover/active/focus/disabled states are not visually broken where practical; +- confirm no text overflows inside buttons or chips. + +## Non-Goals + +- No page structure redesign in this task. +- No new icon system in this task. +- No JavaScript behavior changes. +- No changes to backend or data model. +- No full Study Notebook layout implementation beyond button and chip styling.