Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-frontend

hyper-frontend

Verified

Use this skill when the user wants web frontend code built, fixed, matched to a visual reference, or checked in a rendered browser - a component, page, layout, form, animation, or responsive or state bug in HTML, CSS, JavaScript, React, Vue, Svelte, or Astro - where the job is how the interface is built to hold real content, keep one shape in every state, move safely, and be proven in a real browser. It builds inside the project's existing look, reads a concrete reference as a contract, and saves a report under `.hyper/frontend/[slug]/`. Do not use it for choosing or auditing the visual direction, project structure or tooling, native app UI, or reading a blocked page.

rules/motion-and-interaction.ko.md

View on GitHub
# 모션과 상호작용

애니메이션, 전환, 제스처, 호버·누름 피드백, 입력에 반응하는 동작을 추가하거나 바꿀 때 이 규칙을 읽습니다. 모션이 있어야 하는지, 어떻게 짓는지, 어떻게 안전하게 유지하는지를 정합니다. 스타일은 정하지 않으며 모양은 프로젝트의 모션 토큰과 라이브러리가 정합니다.

## Contents

1. 목적 지도
2. 구현 규칙
3. 안전
4. 입력에 대한 반응
5. 의존성

## 1. 목적 지도

모든 애니메이션은 쓰기 전에 다음 표의 한 행에 대응해야 합니다.

| 트리거 | 상태 변화 | 사용자가 알게 되는 것 |
|---|---|---|
| 애니메이션을 시작하는 사용자 동작이나 시스템 이벤트 | 변화 전후의 상태 | 모션이 전하는 정보: 피드백, 연속성, 위계, 진행 상황 |

행이 없는 애니메이션은 장식이므로 뺍니다. 아무것도 바꾸지 않는 호버, 상호작용이 없는 요소의 모션, 정보 역할이 없는 반복 효과가 흔한 사례입니다. 빼더라도 필요한 콘텐츠와 동작은 남겨야 합니다.

## 2. 구현 규칙

- 레이아웃을 바꾸지 않는 속성(`transform`, `opacity`)을 애니메이션합니다. `width`, `height`, `top`, `left`, 마진을 애니메이션하면 이웃이 밀리고 프레임마다 레이아웃 비용이 듭니다. 같은 움직임을 transform으로 표현합니다.
- 프로젝트의 지속 시간과 이징 토큰을 씁니다. 토큰이 없으면 리터럴을 흩뿌리지 말고 프로젝트 토큰 파일에 한 번 정의합니다.
- 전환은 중단과 되돌림이 가능해야 합니다. 도중에 되돌리면 현재 값에서 이어지고, 빠른 입력이 멈춘 상태나 모순된 상태를 남기지 않습니다.
- 호버는 향상 수단입니다. 호버로만 닿는 정보나 동작은 터치와 키보드에서 닿을 수 없으므로 포커스와 탭에도 같은 경로를 줍니다.
- DOM 순서는 읽기·포커스 순서와 같게 둡니다. transform이나 절대 위치로 시각 순서를 바꿔도 키보드와 스크린 리더 사용자가 처음 만나는 대상이 달라지면 안 됩니다.

## 3. 안전

- 필수가 아닌 모션은 `prefers-reduced-motion`으로 감쌉니다. 줄인다는 것이 정보를 없앤다는 뜻은 아닙니다. 슬라이드는 즉시 전환이나 페이드로 바꾸고 모든 상태 변화가 보이게 합니다.
- 저절로 시작해 5초를 넘기고 다른 콘텐츠 옆에 있는 모션(캐러셀, 마키, 반복 배경)에는 멈춤·정지·숨김 수단이 눈에 보여야 합니다(WCAG 2.2.2).
- 연속 효과는 화면 밖에 있거나 탭이 가려지면 멈춥니다.
- 1초에 세 번을 넘어 깜박이는 것은 없어야 합니다.
- sticky나 fixed 요소가 포커스된 컨트롤을 가리면 안 됩니다. 대상을 그것을 피할 여백을 두고 스크롤해 보이게 합니다(WCAG 2.4.11).

## 4. 입력에 대한 반응

- 누름, 탭, 키 입력은 즉시 확인해 줍니다. 다음 프레임에 눌림, 로딩, 선택 상태가 보여야 합니다. 상호작용 예산(INP 기준 200 ms 이하가 좋은 범위)보다 느린 응답에는 눈에 보이는 진행 표시가 필요합니다.
- 애니메이션이 끝날 때까지 입력을 막지 않습니다. 컨트롤은 동작이 실제로 진행 중일 때만 비활성으로 두고 상자는 그대로 유지합니다([layout-and-states.ko.md](layout-and-states.ko.md) §5).
- 포인터 대상은 24×24 CSS px 이상이고 터치용은 더 크게 잡습니다(WCAG 2.5.8).
- 드래그나 스와이프에는 버튼 같은 단일 포인터 대안을 둡니다(WCAG 2.5.7).

## 5. 의존성

- 프로젝트가 이미 쓰는 애니메이션 방식(CSS, 프레임워크의 전환 API, 설치된 라이브러리)을 재사용합니다. 새로 만들기 전에 그 패턴에 맞춥니다.
- 요청에 이름이 나오지 않으면 애니메이션 라이브러리, 셰이더, 파티클 의존성을 추가하지 않습니다. 더 무거운 효과를 요청받으면 번들 크기와 메인 스레드 비용을 알리고 예산을 묻습니다.

## Sources

> Checked 2026-11-09.

| Claim | Source |
|---|---|
| `prefers-reduced-motion` 미디어 기능 | <https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@media/prefers-reduced-motion> |
| 움직이는 콘텐츠의 일시 정지·정지·숨김(2.2.2), 최소 대상 크기(2.5.8), 드래그 동작(2.5.7), 포커스 가려짐 없음(2.4.11), 세 번 깜박임(2.3.1) | <https://www.w3.org/TR/WCAG22/> |
| 좋은 INP는 200 ms 이하, 좋은 CLS는 0.1 이하 | <https://web.dev/articles/vitals> |
| 목적 지도, transform 전용 모션, 중단 가능성, 의존성 규칙 | `dbc-hbin/omp-ulw@74df40f frontend` shared axioms and interaction guidance (mechanism reference, re-authored) |

### Evidence grade

목적 지도, transform 전용 규칙, 의존성 규칙은 이 패키지가 고른 기본값이므로 `LOCAL`이며, 프로젝트가 명시한 모션 언어가 우선합니다. WCAG, MDN, web.dev 사실은 `PRIMARY`입니다. transform과 opacity가 레이아웃 비용을 피한다는 설명은 위 날짜에 확인한 출처가 아니라 구현 규칙으로 서술했습니다.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall