Skip to content

woowacourse-study/2025-fe-hookponent

Repository files navigation

💭 Hookponent: 훅과 컴포넌트로 완성하는 개발자 경험(DX)

📝 스터디 소개

Hookponent는 단순히 "훅을 만들어보자"로 시작했지만, 지금은 좋은 인터페이스와 일관된 개발자 경험(DX) 을 설계하는 스터디로 발전했습니다. React 환경에서 자주 쓰이는 훅과 컴포넌트를 함께 만들어가며, "잘 동작하는 코드"를 넘어 "잘 설계된 코드"를 고민합니다.

"좋은 훅은 코드가 아니라 설계에서 시작된다." Hookponent는 이 한 문장을 실천하는 개발자들의 연구소입니다.


🧱 스터디 목표

  1. React 훅과 컴포넌트의 설계 패턴 확립
    • 반복되는 패턴을 줄이고, 일관된 인터페이스를 구축합니다.
    • 인자 구조, 반환 형태, 내부 최적화 등 DX 중심의 기준을 세웁니다.
  2. 유틸 함수 및 라이브러리화 확장
    • 훅으로 출발하지만, 공통 유틸 함수까지 확장합니다.
    • 나아가 프레임워크에 종속되지 않는(FW-Agnostic) 구조를 목표로 합니다.
  3. 문서와 함께 성장하는 코드
    • 코드와 문서를 함께 작성해, 누구나 쉽게 이해하고 사용할 수 있는 훅과 컴포넌트를 만듭니다.

🧩 스터디 운영 방식

  • React 환경에서 유용한 훅이나 컴포넌트를 주제로 스터디를 진행합니다.
  • 각자 만든 훅을 설계 의도, DX 고려, 성능 측면에서 함께 리뷰합니다.
  • 미션, 프로젝트, 혹은 아이디어를 통해 새 훅을 제안하고 직접 추가할 수 있습니다.
  • 최종적으로는 모든 멤버가 "기여자(Contributor)" 로 참여하여, 오픈소스 수준의 협업 문화를 지향합니다.

🧠 Hookdle의 4대 설계 철학

  1. 실무 친화성
    • "바로 프로젝트에 쓸 수 있는가?"를 기준으로 설계합니다.
  2. 재사용성과 일관성
    • 인자 구조, 반환값, 네이밍을 통일하여 자연스러운 DX를 제공합니다.
  3. 내부 최적화 내장
    • 훅 사용자가 useCallback이나 useMemo를 직접 신경 쓰지 않아도 되도록, 내부에서 참조 안정성(ref)불필요한 렌더링 최소화를 처리합니다.
  4. 문서화 우선 문화
    • jsDoc, README, 예제 코드 중심의 문서화 문화를 지향합니다.
    • 훅은 "코드보다 문서로 먼저 이해되는 구조"를 목표로 합니다.

🗓 기간 및 일정

  • 기간: 2025.07 ~
  • 장소: 매주 스터디 마지막에 선정
  • 시간: 매주 월요일 저녁 7시 30분

📎 참고 자료


👥 기여자 소개

호이초이 🤡 재오 🧗🏻 세오 ⚽️ 범태 🍻
호이초이 호이초이 세오 호이초이
@hoyyChoi @jaeyoung-kwon @jin123457 @Beomtae
메이토 🍅 클레어 🌀 기린 🦒 익셉 🤖
메이토 클레어 호이초이 호이초이
@Db0111 @eunsoA @jeongyou @ExceptAnyone

About

7기 프론트엔드 훅&컴포넌트 제작 스터디

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 8