원문: longbridge/gpui-kit · 수집일: 2026-10-04 · 커밋
4c7f135· v0.7.0(2026-09-28) · Stars 15.9k · Forks 983 · Apache-2.0(문서 산문은 CC BY 4.0 병행) · 사이트 gpui-kit.com
개요
증권사 Longbridge가 만든 Rust 데스크톱 UI 프레임워크다. Zed 에디터의 렌더링 프레임워크 GPUI 위에 75개 이상의 컴포넌트, 데이터 테이블, 코드 에디터, Dock 레이아웃, 차트, Markdown·HTML 렌더링을 얹었다. 앱은 gpui-kit 크레이트 하나만 의존하면 된다. README에서 gpui-component는 이제 3계층 중 스타일 계층의 이름이고, 앱이 직접 의존하는 이름은 gpui-kit이다. 상용 증권 앱 Longbridge Pro를 첫날부터 이 프레임워크로 만들고 그 요구에서 추출했다는 점이 신뢰 근거다.
3계층 구조
| 크레이트 | 역할 | 맞는 용도 |
|---|---|---|
gpui-base | 스타일 없는 동작·상태·인프라 | 자체 디자인 시스템 제작 |
gpui-component | 완전한 스타일 UI 시스템, 테마 기본값 | 앱을 바로 만들기 |
gpui-shell | Rust가 호스팅하는 JavaScript 런타임 | 플러그인·스크립트 앱 |
핵심 원칙은 “동작은 기반에, 표현은 애플리케이션에”. 웹에 빗대면 GPUI는 HTML+Tailwind, base는 Base UI, component는 shadcn의 스타일 계층이다. 의존은 아래로만 흐르고 base는 component의 테마·에셋을 import하지 않는다.
base가 “빈 Div”가 아니라는 설명이 설계의 핵심이다. 키보드 내비게이션, 텍스트 편집, 팝업 충돌 처리, 가상화, 포커스 트랩처럼 직접 짜면 깨지기 쉬운 동작과 그에 필요한 측정·상태는 base가 맡고, 색·타이포·밀도·반경·variant는 호출자가 정한다. Button::new("save")는 라벨이 아니라 ElementId를 받고 기본 높이·패딩·배경이 없다. base 모듈은 시맨틱 요소, 복합 동작 루트(Dialog·Popover·Select 등), 상태 시스템(EditorState·TreeState·DockArea 등), 인프라의 네 계열이다.
주요 기능
- 데이터: 수십만 행을 가상 스크롤하는 테이블(고정·리사이즈 열, 정렬, 셀 선택), 가변 높이 가상 리스트.
- 에디터: 20만 줄에서 안정적이라고 주장하는 코드 에디터, Tree-sitter 하이라이팅, LSP 진단·완성·호버.
- 레이아웃: 리사이즈 패널·드래그 탭·중첩 분할·가장자리 도크, 전부 직렬화 가능.
- 품질: AccessKit 접근성(테스트로 검증), 헤드리스 윈도에서 포인터·키보드를 구동해 상태·포커스·레이아웃·접근성을 단언하는 UI 통합 테스트,
wasm32-unknown-unknown웹 실행. - 시작 코드:
gpui_kit::init(cx)후gpui_kit::open_window(...). 기본 기능에서 component와 Lucide 아이콘이 포함되고, 기능을 끄면 쓰는 계층만 남긴다.
gpui-shell: 네이티브 앱의 JS 플러그인
호스트를 한 번 컴파일·배포한 뒤 새 패널이나 비즈니스 로직을 같은 프로세스에 스크립트로 로드하는 확장 런타임이다. Electron·Tauri와 다르게 WebView·DOM·CSS·Node.js가 없다. 스크립트는 렌더링하지 않고 인터페이스를 한 번 기술하면 Rust가 그 기술을 매 프레임 실제 GPUI 요소로 재생한다. JS 바인딩도 base의 무스타일 계약을 지켜서 Button.new("save")만 쓰면 아무것도 그리지 않는다. 다만 README가 직접 마일스톤 M0(타당성 기준선)이며 안정 인터페이스가 아니라고 밝힌다. 도킹 패널 기여는 되지만 나머지 기여 레지스트리와 PluginManager CLI가 없어 단독 실행 경로만 끝까지 동작한다. 프로덕션에 쓸 계층은 아직 base와 component다.
v0.7.0 (2026-09-28)
Toolbar·Questionnaire·TimeField가 추가됐다. 가장 큰 변경은 윈도 시작 일원화다. open_window가 항상 Base 소유 Root로 앱을 감싸 Cargo 기능 통합과 무관하게 같은 루트를 보장하고, 다이얼로그·시트·알림 오버레이를 Root가 자동으로 호스팅한다. 수동 레이어 렌더링 API는 제거돼 기존 코드는 마이그레이션이 필요하다. Plot 프리미티브는 base로 내려가 component 없이도 커스텀 차트를 만들 수 있다. 릴리스 노트가 직접 Breaking Changes 검토를 당부하므로 0.6 이하에서 올릴 때는 그 절을 먼저 읽어야 한다.
AI 에이전트와의 접점
- 에이전트 스킬:
npx skills add longbridge/gpui-kit로gpui-kit(설정·카탈로그·GPUI 메커닉스·코딩 가이드)과gpui-kit-design-guides(레이아웃·간격·상호작용 상태·인터페이스 문구)를 설치한다. README는 실행 가능한 앱 레시피와 “AI 보조 개발 수용 검사”(examples/ai_recipes)를 안내한다. 라이브러리 쪽이 에이전트가 쓰는 방법을 같이 배포하는 흐름이다. - AI 보조 기여의 공개: 최신 커밋(#3363)은 에디터 자동완성 트리거의 접두사 계산 버그를 고친 PR인데, 본문에 분석·패치·테스트를 Claude(Fable 5.1)로 초안하고 제출자가 검토했으며 후속 구현은 Codex 보조라고 적었다. 회귀 테스트 4건과 UTF-8 경계 패닉 후속 테스트가 붙어 있어, 대형 오픈소스에서 AI 보조 PR이 테스트 우선으로 받아들여지는 사례로 읽을 수 있다.
평가
- 장점: 상용 앱에서 추출됐고 별 1.6만·포크 983·활발한 커밋이 말해주는 생태계 규모, base를 따로 쓸 수 있는 계층 분리, 접근성과 헤드리스 UI 테스트를 프레임워크 차원에서 제공.
- 주의: 0.7대로 API가 아직 움직이고 breaking change가 릴리스마다 있다. GPUI 자체가 Zed 스냅샷(
gpui-pre-*)에 묶여 있어 GPUI 버전 고정 정책에 종속된다. shell은 M0다. 성능 수치(120 FPS, 20만 줄)는 README 주장이고 직접 측정하지 않았다. - 한계: README·아키텍처 문서·shell README·릴리스 노트·최신 커밋만 근거로 했고 빌드·실행은 해 보지 않았다. 사이트에 Iced·egui·Qt 6 비교 문서가 따로 있다.
관련 노트
- 2026-03-21-opensquirrel — 같은 GPUI 위에 만든 Rust 멀티 에이전트 컨트롤 플레인. GPUI 앱의 실제 사례.
- 2026-08-30-github-sinelaw-fresh — QuickJS 플러그인을 가진 Rust 터미널 IDE. shell이 겨냥하는 “Rust 호스트 + 스크립트 확장” 구조와 비교할 만하다.
- moc-dev-tools — 개발 도구 전체 지도.