Skip to the content.

Interaction redesign (Likwidmack, September 2026)

A focused pass on how visitors and the site owner use the portfolio: readable contrast in both themes, no lost work, navigation that is always visible, no dead ends, simpler browsing and a safer Style Studio. The visual identity (warm near-black grounds, deep red, ember, clay, condensed display type) is unchanged.

Why

Problem (before) Who it hurt Fix
Focus outline was the brand red (2.7:1 on the dark page) and personalization re-applied it at runtime Keyboard users AA focus colour from the theme; personalization no longer overrides it
Form borders were an 8 % hairline Everyone filling a field (especially in light mode) --theme-border-strong-color (≥3:1)
Every destination was hidden behind Menu at all widths First-time visitors, recruiters Inline primary nav from 768 px with the current page marked; visible Get in touch
Work cards had three links to the same story Keyboard and screen-reader users One link per card
Case studies ended without a next step Visitors walking the work Previous / next story + Get in touch at the end
Splash hid “Continue from…” under numbered doors Returning visitors Resume first; doors unnumbered with a scope line
Browse filters had two controls per facet and no result count Gallery and Docs visitors One control per facet, counts, “Showing N of M”, Clear filters, filters in the URL
Style Studio discarded unapplied edits on leave, deleted setups with one click, and allowed unreadable colours Anyone personalizing the site Draft kept until Apply/Discard, Undo for deletes, live contrast checks
Camera background asked for the webcam without explanation Privacy-conscious visitors Explains first; switches only after “Turn on camera”
Admin media page was an id table with raw JSON recipes Site owner Drop zone, thumbnail grid, detail drawer, named variant presets

What changed, by page

Surface Change Code
All pages Contrast roles --theme-focus-ring-color, --theme-link-color, --theme-border-strong-color, --theme-primary-fill-color/--theme-on-primary-color, --theme-success-ink-color/--theme-error-ink-color theme/core — packages/theme.md
Header Inline rail About · Work · Gallery · Code · Writing (≥768 px), aria-current, Get in touch, Personalize icon button AppPrimaryNav, shared/primary-nav.ts
Splash /, /splash Resume bar first; unnumbered doors with scope; “Go straight to where I left off next time” AppSplash, content/home.json
Work /work Whole card is one link; “Read the story →” AppWorkCard
Case study /work/:slug Previous / next story + Get in touch AppStoryPager, adjacentStudies()
Code /code Fluid reader: package filter (shared toolbar), accessible snippet tabs (arrows, Home/End), one panel with code + facts, Copy, View source ↗; package cards; ?group=…&item=… deep links pages/code/index.vue, shared/code-types.ts, shared/public-repo.ts
Docs, Code Browse toolbar with counts, live status, Clear filters, URL state AppBrowseToolbar, useBrowseQuery, shared/browse-query.ts — gallery-and-docs.md
Gallery /gallery Full-bleed justified grid; floating menu (Group / Filter / Sort with counts, Play feed, site links); full view = the feed (?item=) GalleryMenu, GalleryGrid, GalleryViewer, useBrowseQuery — gallery-and-docs.md
Style Studio /styles Role-first editing, contrast guard, sticky draft bar, setup Undo, pack tiles AppStyleStudio, shared/contrast-guard.ts — personalization.md
Component parity /styles/parity Kitchen sink moved off Style Studio (/styles/kitchen-sink redirects) pages/styles/parity.vue, AppStylesParity
Personalize dialog, Studio Shared background picker with camera consent AppBackgroundPicker
Admin /admin/media Drop zone, Kind counts, grid, drawer, presets, confirm + Undo core/admin, app/utils/media-presets.ts — admin.md

Rules that keep it this way

  1. Text and controls use the contrast roles (brand-coloured text: --theme-primary-ink-color / --theme-secondary-ink-color); brand colours are for fills. Tests fail if a role drops below its minimum (theme/core/tests/contrast-roles.spec.ts).
  2. One primary action per view; one link or button per object (card, door, asset).
  3. Every story or result list offers a next step (pager, Clear filters, Retry).
  4. Changes that can be lost are kept until the person applies or discards them; destructive actions confirm in place and offer Undo.
  5. Status is always a word (and often a glyph), never colour alone.

Responsive regression (e2e)

Three Cypress specs guard the responsive · accessible · touch rule (docs/agents/README.md):

Spec Scope Checks
core/web-e2e/src/e2e/responsive.cy.ts RESPONSIVE_ROUTES at the seven fluid widths Page-level horizontal overflow only.
core/web-e2e/src/e2e/ui-audit.cy.ts PUBLIC_ROUTES at the seven fluid widths (320 doubles as reflow), phone Menu, page-nav disclosure Overflow, 44px targets, 12px type floor, accessible names.
core/web-e2e/src/e2e/responsive-components.cy.ts Every public route at the seven fluid widths, and the components at phone / tablet portrait / landscape Overflow, clipped or spilling text, overlapping text, controls off-screen, media wider than its box, plus the ui-audit floors; components opened and measured.
core/web-e2e/src/e2e/layout-audit.cy.ts Self-tests of layoutAudit on fixtures, at the seven fluid widths Cropped text, the containing-block chain, scroll containers and ellipsis, sticky roots.

Viewports are listed once. core/web-e2e/src/support/viewports.ts exports FLUID_VIEWPORTS — pages run at 320, 480, 768, 1024, 1280, 1440 and 1920 (owner decision 2026-10-14: every page is mostly consistent across the fluid range) — and PHONE (375×812), TABLET_PORTRAIT (768×1024) and TABLET_LANDSCAPE (1024×768) for the components. The 320×640 width doubles as the ≈ 400% zoom reflow check (WCAG 1.4.10) on every page. Pages size their layout from the shared primitives (auto-grid, --prose-max, --container-wide, --section-space), not per-page values — guarded by core/web/tests/pages-scss.spec.ts.

Routes come from the source. core/web-e2e/src/support/routes.ts globs core/web/app/pages/**/*.vue (static routes) and core/web/content/case-studies/*.json (/work/<slug>) with Vite’s import.meta.glob, so a new page joins the matrix on its own. One doc page and one blog post are resolved at run time from /docs and /api/posts. An empty /docs index fails (docs ship with the repo), and so does a non-200 /api/posts (the store is missing: run npm run db:migrate:local). npm run e2e:regression seeds one published fixture post (scripts/e2e-seed-posts.js, test data only), so on CI (Cypress.env('CI'), set from CI in cypress.config.ts) an empty blog store fails too. Locally the blog test logs the reason and is marked pending with this.skip(); run node scripts/e2e-seed-posts.js after db:migrate:local to audit it.

Components (phone, tablet portrait, tablet landscape): the primary Menu dropdown disclosure (Tab order, Esc closes and returns focus; inline nav from 48em), Personalize, Style Studio (scroll, controls, Apply / Discard bar), page-nav disclosure, the gallery menu panel, the code browse toolbar (pickers ≤ 768px, segments above), the work jump bar, the code snippet picker and ‹ › steps, media player controls, the story pager, footer social links and the evidence examples dialog. Each one is opened and checked: inside the viewport, scrolls inside when taller, 44px targets, named controls, no sideways scroll, and no control hidden at rest that only a :hover rule reveals.

Shared audit. core/web-e2e/src/support/layout-audit.ts holds floorAudit (the ui-audit floors), layoutAudit, surfaceAudit and the hydration-aware visitHydrated. SCROLL_ALLOWLIST there lists the intentional scroll containers (code frames, table wrappers, carousels) and the decorative layers.

Known issues. Real layout bugs found by the suite go in KNOWN_ISSUES at the top of the spec. Each entry names its issue and matches only its findings, so the suite stays green while the fix lands; remove the entry with the fix and the check guards the regression. The list is empty today: KI-1 and KI-3…KI-9 were fixed in one pass (see the TODO entry below).

Cropped text and visible ink. Clipping follows the containing-block chain. A box’s overflow clip applies to a run only when the box sits on that chain. An absolute child escapes a non-positioned overflow: hidden wrapper; a fixed one escapes everything up to a transform, filter or contain ancestor.

Settle before measuring motion. Media queries are re-evaluated in the browser’s rendering step, not on a forced layout. Headless, after cy.viewport a page can keep the previous viewport’s (orientation) state until something produces a frame — on /work that flips every card’s --media-ratio (16:9 → 9:16) right after a jump. settleLayout() nudges scroll by 1px, dispatches resize, then waits two animation frames and three consecutive steady document-height samples before the jump-bar click. The jump itself is instant because visitHydrated seeds motion: 'reduced', which the handler reads (setting data-motion on <html> alone does not change it). Settling still missed once on 768×1024 (story left at top ~4200), so if the story is off screen and the document height changed after the click, the test jumps once more; a jump link that never scrolls still fails, and the record notes rejumped.

Output. Raw measurements are written to core/web-e2e/test-output/responsive/<viewport>/{pages,components}/*.json. Screenshots go to core/web-e2e/test-output/cypress/screenshots/responsive-components.cy.ts/<viewport>/{pages,components}/ (full page per route at w320, w768 and w1440, plus each open component at phone and tablet portrait). Both folders are gitignored.

# Build and serve the app (any free port), then:
NX_NO_CLOUD=true NX_DAEMON=false npm run build
PORT=4310 HOST=127.0.0.1 node .output/local/server/index.mjs &
cd core/web-e2e
E2E_BASE_URL=http://127.0.0.1:4310 npx cypress run --spec src/e2e/responsive-components.cy.ts
E2E_BASE_URL=http://127.0.0.1:4310 npx cypress run --spec "src/e2e/ui-audit.cy.ts,src/e2e/responsive.cy.ts"

TODO

Cognitive accessibility (follow-ups from the 2026-10-22 audit)

Audit: web/reference/cognitive-a11y-audit.md. Done in the same branch: header Pause animation, the depth field holding still under reduced motion, the gallery full view’s Pause, Motion in Personalize, one touch preview at a time, the Undo duration hint, the full-view focus trap and upright blockquotes and cite.

Documentation review follow-ups

Nuxt layers (follow-ups from PR 2 Task 4)

Nuxt UI layer (follow-ups from PR 2 Task 5)

Optional layer features (follow-ups from PR 2 Task 5b)

Forms template (follow-ups from PR 3 Task 7)

Lists and deletes (follow-ups from PR 4 Task 8)

Admin media library: all media types

The DAM is meant to hold audio, video, images, SVG (vector), 3D / XR objects and text documents. MediaKind is image | svg | audio | video | model | document (packages/media/src/kinds.ts, @tgmc/media-client). Editorial facets use meta.tags (and optional facet keys like animated / panorama) — not extra kinds or multicategory.

Site media in the library (owner request 2026-10-21)

Today the site’s own media (core/web/content/media.json: portrait, case-study heroes and artifacts, work cards, gallery, PDFs, MP4s) stays as static build files under /i, /v, /d and is not in the catalog (site media, owner decision 2026-10-17). Goal: manage it in the admin media library instead. Moving it replaces that decision, so update site-media.md, cicd.md and image.md when it lands.

All code / doc links now point to likwidmack/portfolio on main (repo rule — see docs/agents/README.md). The public repo does not yet contain every linked path, so these 404 until the mirror syncs them:

A link audit (crawl of every page, October 2026) found no broken links outside /docs, but several sections are hard to reach. Each change must cover responsiveness (no page-level horizontal overflow, phone to desktop), accessibility (keyboard, focus ring, screen-reader names, aria-current) and touch (≥ 44px targets, no hover-only affordances).

The redesign (gallery-and-docs.md § Gallery; spec docs/superpowers/specs/2026-10-19-gallery-redesign-design.md) left these out on purpose. Each change must cover responsiveness, accessibility and touch like the rest of the gallery.

Admin + media hardening (review 2026-10-21)

Done on cl/admin-media-hardening: I1 delete keeps the name held until the objects are gone (resumable); I2 a failed CDN purge after a delete is audited, not a 500 (retried by deleting again); I3 versioned media URLs (?v=<sha8>, CloudFront m/* cache key); I4 private pending/ prefix + lifecycle (also closes M7: the local /m/** never serves pending uploads); I5 DynamoDB post / message lists read every page (+ cross-backend store contract); I6 forward-mode upstream 401/403 → 502; I7 admin upload caps; I8 weak admin tokens refused + admin Host allowlist; M1 atomic DynamoDB slugs; M2/M3 admin blog resolved after auth, body after auth; M4 shared AWS clients + timeouts; M5 admin token runtime-only; M6 partial create-only copy removed.

Responsive images (follow-ups from the /about portrait, 2026-10-21)

Context: site media § Responsive sizes and format.

Other follow-ups