Skip to content

docs(phase2c4): Tech Stack Keyboard design-system + feature catalog e… - #140

Merged
bryce-seefieldt merged 3 commits into
mainfrom
docs/phase2c4-tech-stack-keyboard
Jun 30, 2026
Merged

docs(phase2c4): Tech Stack Keyboard design-system + feature catalog e…#140
bryce-seefieldt merged 3 commits into
mainfrom
docs/phase2c4-tech-stack-keyboard

Conversation

@bryce-seefieldt

Copy link
Copy Markdown
Owner

…ntry

  • Update design-system source map: add TechStackKeyboard, TechStackIcons entries
  • Add Phase 2C.4 implementation notes: keycap sizing fix, proportional keyboard, radiogroup+CRT pattern
  • Create feature page: tech-stack-keyboard.md with full validation, testing, and troubleshooting
  • Document 16 vendored Simple Icons + 5 text legend fallbacks
  • Include CSS --keycap-unit variable fix for proportional key sizing (1u/1.25u/1.5u/2u)
  • Reference ADRs (Visual Identity, Dark Mode, React2Shell hardening)
  • Link to E2E tests (smoke tests cover home page render)
  • Accessibility standards: keyboard navigation, aria-live, radiogroup roles, reduced-motion

Summary

What changed

This pull request adds comprehensive documentation for the new "Tech Stack Keyboard" feature (MODULE 01), which introduces an accessible, interactive keyboard interface to the home page. It details the feature’s purpose, scope, accessibility patterns, visual treatment, keyboard navigation, theming, and maintenance considerations. Additionally, the design system documentation is updated to include references and implementation notes for the new keyboard and its supporting icon set.

Feature Documentation and Design System Updates:

New Feature Documentation

  • Added docs/00-portfolio/features/04-theming-accessibility/tech-stack-keyboard.md, a complete spec and runbook for the Tech Stack Keyboard, covering purpose, scope, UI/UX details, accessibility, testing, troubleshooting, and references.

Design System Reference Updates

  • Added entries for TechStackKeyboard and TechStackIcons components to the design system index, documenting their source files and roles (interactive keyboard and icon set).
  • Added "Phase 2C.4 implementation notes" to the design system docs, describing proportional key sizing fixes, category organization, keyboard navigation, accessibility features, and icon asset details for the Tech Stack Keyboard.

Scope

  • Docs content update
  • New section/folder (category + index hub)
  • Templates / style guide
  • CI/CD / workflows
  • Security / threat model / SDLC controls
  • Operations / runbooks / IR / DR

Evidence

Nav / Structure

  • New/updated folders include _category_.json or _category_.yml
  • New section has an index hub (generated-index or curated index doc)
  • Sidebars/autogenerated navigation renders correctly

Security

  • No secrets added (confirmed)
  • New/updated MDX reviewed as code (if applicable)
  • Hosting header changes validated (if applicable)
  • If security-relevant: threat model / controls updated or issue created
    • Link to update/issue:

Quality checklist

  • Front matter included (title, description, tags; sidebar fields if needed)
  • Uses standard page structure (Purpose / Scope / Procedure / Validation / Troubleshooting / Refs)
  • Commands are copy/paste safe and specify shell (bash/powershell)
  • Any destructive steps include rollback guidance

Notes for reviewers (optional)

…ntry

- Update design-system source map: add TechStackKeyboard, TechStackIcons entries
- Add Phase 2C.4 implementation notes: keycap sizing fix, proportional keyboard, radiogroup+CRT pattern
- Create feature page: tech-stack-keyboard.md with full validation, testing, and troubleshooting
- Document 16 vendored Simple Icons + 5 text legend fallbacks
- Include CSS --keycap-unit variable fix for proportional key sizing (1u/1.25u/1.5u/2u)
- Reference ADRs (Visual Identity, Dark Mode, React2Shell hardening)
- Link to E2E tests (smoke tests cover home page render)
- Accessibility standards: keyboard navigation, aria-live, radiogroup roles, reduced-motion
@vercel

vercel Bot commented Jun 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
portfolio-docs Ready Ready Preview, Comment Jun 30, 2026 6:56pm

@bryce-seefieldt
bryce-seefieldt merged commit 46d1e3d into main Jun 30, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant