😺 MewUI – Native AOT 배포를 위한 경량 .NET UI 라이브러리

[al6uiz]

간단한 유틸리티나 소형 도구를 만들어서 배포하고 싶을 때 .NET 런타임 설치 자체가 부담이 되는 경우가 많습니다.
Native AOT는 하나의 대안이지만 현실적으로는 선택지가 제한적입니다.

• WPF / WinForms는 Native AOT를 지원하지 않습니다.
• Avalonia는 Native AOT와 트리밍을 적용하더라도 Skia 백엔드 등의 영향으로 결과물이 수십 MB에 달하는 경우가 많습니다.
• 간단한 계산기나 설정 도구 수준의 프로그램에 적용하기에는 배포 크기 대비 효용이 맞지 않는 상황이 자주 발생합니다.

이러한 문제를 해소하기 위해 MewUI라는 경량 .NET UI 라이브러리를 GPT와 함께 만들어봤습니다.

---

GitHub - aprillz/MewUI: A lightweight code-first .NET UI toolkit focused...

프로젝트 목표

MewUI의 목표는 다음과 같습니다.

• Native AOT 배포를 전제로 한 최소 구성의 UI 프레임워크
• 런타임 설치 없이 단일 실행 파일 배포
• “풀 스펙 UI 프레임워크”가 아닌 간단한 툴 제작에 필요한 최소 기능에 집중

초기 단계에서는 다음 범위를 우선 지원할 예정입니다.

• 기본적인 컨트롤 배치
• 단순한 레이아웃 구성
• 소형 유틸리티 및 내부 도구에 적합한 UI 표현
• 간단한 바인딩과 컨버터

복잡한 스타일링, 고급 애니메이션, 대규모 데이터 바인딩 등은 현재 범위에 포함하지 않습니다.

---

개발 방식

이 프로젝트는 다음과 같은 방식으로 개발되었습니다.

• GPT Plus 플랜 / GPT-5.2 (CODEX 아님) / Medium 추론 / 150K 토큰
• 실제 코드 직접 수정 없이 프롬프트 이터레이션만으로 설계 및 구현

설계 보완, API 구조 조정, 내부 구성 개선을 모두 대화 기반으로 반복하며 현재 형태까지 구현했습니다.

---

향후 계획

시간이 허락된다면 다음 기능도 추가를 검토할 예정입니다.

• 디자인 프리뷰 도구
• 런타임 핫 리로드
• Native AOT 친화적인 추가 컨트롤 확장

이 역시 동일한 방식으로 진행할 계획입니다.

---

마무리

MewUI는 아직 초기 단계이며 범용 UI 프레임워크를 목표로 하지는 않습니다.
다만 “이 정도 규모의 UI에 수십 MB가 필요한가”라는 문제의식에서 출발한 하나의 대안입니다.

간단한 .NET 도구 배포, Native AOT 기반 응용 프로그램, 초경량 UI에 관심 있는 분들의 의견과 피드백을 환영합니다.

[al6uiz]

MewUI 는 NativeAOT + Trim 앱을 목표로 하는, 코드 기반(code-first) 경량 크로스 플랫폼 .NET GUI 라이브러리입니다.

• 상태: 실험적 프로토타입 버전입니다(기능/동작/API는 변경될 수 있습니다).
• 참고: 이 저장소의 대부분의 코드는 GPT의 도움으로 작성되었습니다.

---

스크린샷

Light	Dark

---

하이라이트

• NativeAOT + Trim 우선
• 빠르고 가볍게 (가벼운 실행 파일 크기, 낮은 메모리 풋프린트, 빠른 시작)
• Fluent C# 마크업

---

경량(Lightweight)

• 실행 파일 크기: NativeAOT + Trim 중심(샘플 win-x64-trimmed 약 2.2 MB)
• 샘플 런타임 벤치마크 (NativeAOT + Trimmed, 50회 실행):

백엔드	Loaded avg/p95 (ms)	FirstFrame avg/p95 (ms)	WS avg/p95 (MB)	PS avg/p95 (MB)
Direct2D	10 / 11	178 / 190	40.0 / 40.1	54.8 / 55.8
GDI	15 / 21	54 / 67	15.2 / 15.3	4.6 / 4.8

---

C# 마크업

var window = new Window()
    .Title("Hello MewUI")
    .Size(520, 360)
    .Padding(12)
    .Content(
        new StackPanel()
            .Spacing(8)
            .Children(
                new Label()
                    .Text("Hello, Aprillz.MewUI")
                    .FontSize(18)
                    .Bold(),
                new Button()
                    .Content("Quit")
                    .OnClick(() => Application.Quit())
            )
    );

Application.Run(window);

---

컨셉

MewUI는 아래 3가지를 최우선으로 둔 code-first UI 라이브러리입니다:

• NativeAOT + Trim 친화
• 빠르고 가볍게 (단일 EXE ~2.2 MB, 낮은 메모리 풋프린트, 빠른 첫 렌더 — 아래 벤치마크 참고)
• XAML 없이 Fluent한 C# 마크업으로 UI 트리 구성

지향하지 않는 것:

• WPF처럼 애니메이션, 화려한 이펙트, 무거운 컴포지션 파이프라인
• “다 들어있는” 리치 컨트롤 카탈로그
• XAML/WPF 완전 호환이나 디자이너 중심 워크플로우

---

렌더링 백엔드

렌더링은 아래 추상화로 분리됩니다:

• IGraphicsFactory / IGraphicsContext

샘플은 기본적으로 Direct2D를 사용하며, GDI와 OpenGL도 제공됩니다.

---

플랫폼 추상화

윈도우/메시지 루프는 플랫폼 계층으로 추상화되어 있으며, 현재는 Windows 구현(Win32PlatformHost)제와 Linux/X11 구현체를 제공합니다.

• 추후 macOS도 제공예정.

---

NativeAOT / Trim

• 기본적으로 trimming-safe를 지향합니다.(리플렉션 기반 바인딩 지양)
• Windows interop은 NativeAOT 호환을 위해 소스 생성 P/Invoke(LibraryImport)를 사용합니다.

---

상태/바인딩(AOT 친화)

바인딩은 리플렉션 없이, 델리게이트 기반입니다:

var percent = new ObservableValue<double>(0.25);

var slider = new Slider()
                 .BindValue(percent);
var label  = new Label()
                 .BindText(
                     percent, 
                     convert: v => $"Percent ({v:P0})");

---

컨트롤 / 패널

컨트롤:

• Label, Button, TextBox
• CheckBox, RadioButton
• ListBox, ComboBox
• Slider, ProgressBar
• Window

패널:

• Grid (row/column: Auto, *, pixel)
• StackPanel (가로/세로 + Spacing)
• DockPanel (도킹 + 마지막 자식 채우기)
• UniformGrid (균등 셀)
• WrapPanel (줄바꿈 + Item size + Spacing)

---

테마(Theme)

• 라이트 테마와 다크 테마 두 가지를 지원하며 Accent 색상을 지정할 수 있습니다.

  Accent 변경:

  Theme.Current = Theme.Current.WithAccent(Color.FromRgb(214, 176, 82));
  

• 색상 이외의 파라미터 변경을 지원합니다. (테두리 라운딩, 기본 폰트 등 )

---

로드맵 (TODO)

컨트롤

• Image, GroupBox, TabControl, ScrollViewer

렌더링

• OpenGL 백엔드

플랫폼

• Linux
• macOS

툴링

• Hot Reload (디자인 타임 중심)

[dimohy]

완전 대박!!!

[Chris_Shim]

아!! 정말 기대되는군요.

이걸 보니 LLM으로 마소가 유기한 **ATL(Active Template Library)**를 현대화 해보면 좋겠다는 생각이 들었습니다.

[rkttu]

오.. ATL을 아시는군요! 잊고 있었는데 오랫만에 생각났습니다. (WTL이란것도 있었죠. ㅋㅋㅋ)

[windowmini]

헐.. 저 컨트롤 사용 하면 EXE 하나만 배포 가능 한건가요 ??? 그라모 대박 인디

[al6uiz]

MewUI를 참조하는 프로젝트가 리플렉션 사용 등 NativeAOT 컴파일 제약을 위반하는 로직이나 추가 패키지 참조 없이 구성될 수 있다면, EXE 단일 파일 배포가 가능합니다.

또한 FBA로 이렇게도 가능합니다ㅎ

https://github.com/aprillz/MewUI - FBA 샘플앱

https://github.com/aprillz/MewUI - FBA 계산기

---

아래 코드를 붙여넣기 하면 즉시 실행해 볼 수 있습니다. (.NET 10 SDK 필요)

Windows 커맨드라인

샘플앱

curl -sL https://raw.githubusercontent.com/aprillz/MewUI/refs/heads/main/samples/FBASample/fba_sample.cs -o - | dotnet run -

계산기

curl -sL https://raw.githubusercontent.com/aprillz/MewUI/refs/heads/main/samples/FBASample/fba_calculator.cs -o - | dotnet run -

Powershell

샘플앱

irm https://raw.githubusercontent.com/aprillz/MewUI/refs/heads/main/samples/FBASample/fba_sample.cs | dotnet run -

계산기

irm https://raw.githubusercontent.com/aprillz/MewUI/refs/heads/main/samples/FBASample/fba_calculator.cs | dotnet run -

NativeAOT Trim 빌드시 약 1.8메가

[dimohy]

우오오오오오오!!

[al6uiz]

이제 Linux (X11)에서도 잘 동작하는 크로스플랫폼 UI 라이브러리가 되었습니다!