Hacker News 2026.07.28 31

React를 걷어내고 htmx로 — 1인 오픈소스 포럼 Misago의 8년 만의 유턴

오픈소스 포럼 소프트웨어 Misago를 10년 넘게 혼자 개발해 온 Rafał Pitoń이 React를 코드베이스에서 걷어내고 htmx로 갈아타기로 한 결정을 공개한 글이에요. 2023년에 쓰인 글이지만 하이퍼미디어 방식이 재조명되는 요즘 다시 읽어볼 가치가 충분한데요, 1인 메인테이너의 8년짜리 회고이자 기술 선택론이거든요.

8년의 SPA 여정

2015년, Discourse와 NodeBB가 버티고 있는 세상에서 포럼 소프트웨어가 살아남으려면 SPA(싱글 페이지 애플리케이션)여야 한다고 믿고 React를 도입했대요. SPA가 뭐냐면, 페이지 이동 없이 자바스크립트가 화면을 전부 그리는 방식의 웹앱이에요. 그렇게 2019년에 React 클라이언트를 얹은 버전을 출시했는데, 유지보수를 하면 할수록 회의감이 쌓였다고 해요. 가장 큰 문제는 모든 기능을 두 번 구현해야 한다는 것. 파이썬으로 한 번, 자바스크립트로 또 한 번이요. 세션 처리, 권한, 라우팅, 데이터 로딩, 에러 처리까지 전부 중복이었대요. 거기에 React 생태계의 변화 속도가 얹혔어요. 클래스 컴포넌트에서 훅으로, React Router는 메이저 버전마다 브레이킹 체인지, 상태 관리 라이브러리는 유행 따라 물갈이. 여가 시간에 혼자 개발하는 메인테이너가 따라갈 수 있는 속도가 아니었던 거죠.

htmx가 뭐냐면

자바스크립트를 거의 쓰지 않고 HTML 속성만으로 동적인 UI를 만드는 라이브러리예요. 버튼에 hx-get='/comments' hx-target='#list' 같은 속성을 붙여 두면, 클릭했을 때 서버에 요청을 보내고 서버가 렌더링해 준 HTML 조각을 받아서 지정한 자리에 갈아 끼워요. JSON API를 만들고, 프런트에서 상태를 관리하고, 컴포넌트로 다시 그리는 과정 전체가 '서버가 그냥 완성된 HTML을 보내준다'로 대체되는 거죠. Misago는 폼 제출을 새로고침 없이 처리하고, 무거운 페이지 조각을 지연 로딩하고, 투표나 운영 기능을 제자리에서 갱신하는 데만 htmx를 쓰고, 나머지는 평범한 Django 서버 렌더링으로 갑니다. 저자 표현으로는 '지루한' 방식인데, 지루하다는 건 곧 개발이 빠르고 유지보수가 쉽다는 뜻이라고요. 덤도 커요. 서버 렌더링된 HTML은 자바스크립트 없이도 동작하고, 스크린 리더 접근성과 검색 엔진 노출이 기본으로 따라와요. SPA에서는 상당한 추가 공수를 들여야 얻는 것들이거든요.

이 글의 핵심 문장

'SPA가 나쁘다는 얘기가 아니다. Discourse는 훌륭한 SPA다. 하지만 Discourse에는 팀이 있고, Misago에는 여가 시간의 나 혼자다. 아키텍처는 갖고 싶은 리소스가 아니라 실제로 가진 리소스에 맞춰야 한다.' 기술 선택 논쟁이 벌어질 때마다 인용할 만한 문장이에요. 좋은 아키텍처란 절대적인 게 아니라 그걸 감당할 사람 수의 함수라는 거죠.

업계 맥락

htmx는 '서버가 HTML을 보낸다'는 하이퍼미디어 회귀 흐름의 대표 주자인데요, 같은 계열로 Rails의 Hotwire/Turbo, Laravel의 Livewire, Phoenix의 LiveView가 있어요. 흥미로운 건 React 진영조차 서버 컴포넌트로 렌더링의 무게중심을 서버로 옮기고 있다는 거예요. 접근은 달라도 '클라이언트에 로직이 너무 많이 쌓였다'는 문제의식은 업계 전체가 공유하고 있는 셈이죠.

우리에게 주는 시사점

사이드 프로젝트, 소규모 팀, 관리자 페이지나 사내 도구라면 htmx 계열의 체감 생산성이 정말 커요. Django, Rails, Spring을 쓰는 백엔드 개발자가 프런트 스택을 따로 배우지 않고도 인터랙티브한 UI를 만들 수 있는 선택지거든요. 물론 실시간 협업 도구나 복잡한 클라이언트 상태가 필요한 앱이라면 여전히 SPA가 맞는 도구고요. 핵심은 도구를 팀의 크기와 유지보수 여력에 맞추는 거예요.