Nuri Preview brings live component previews for Nuri WPF projects directly into Visual Studio 2022.
Open a Nuri component, launch the preview tool window, and inspect your UI without repeatedly restarting the application. Saving a C# source file automatically requests a preview refresh.
Nuri Preview is currently an early preview release. Features and behavior may change as the Nuri runtime evolves.
Features
- Preview Nuri WPF components inside a Visual Studio tool window
- Automatically refresh the preview when C# source files are saved
- Manually refresh the current preview
- Zoom from 25% to 400%
- Reset, center, and fit the preview
- Resolve the preview project from the active C# document
- Fall back to the selected Startup Project
- Display build and preview status directly in the tool window
- Run project compilation and preview rendering locally
Getting Started
- Open a solution containing a Nuri WPF project.
- Select the intended project as the Startup Project, or open one of its C# files.
- Open Nuri Preview using one of the following locations:
- View > Nuri Preview
- Tools > Nuri Preview
- Right-click inside the C# editor and select Nuri Preview
- Save a C# file to refresh the preview.
- Use the toolbar to refresh, zoom, center, or fit the preview.
Component Discovery
A previewable component must:
- Inherit from
Nuri.UI.Dsl.Component - Have a public parameterless constructor
Nuri Preview determines the root component from calls such as:
NuriApplication.Run<MyComponent>();
NuriApplication.Show<MyComponent>();
NuriApplication.Attach<MyComponent>();
If the project contains only one previewable component, that component may be selected automatically.
## Requirements
- Visual Studio 2022 Community, Professional, or Enterprise
- 64-bit Windows
- .NET Framework 4.7.2 or later
- .NET 8 Desktop Runtime
- A Nuri WPF project
## Current Limitations
- The current preview renderer targets Nuri WPF projects.
- Components requiring constructor arguments cannot be selected as preview roots.
- Code with build or compilation errors cannot be rendered.
- Some application-level resources or startup initialization may need additional preview support.
- This release is intended for evaluation and development feedback.
## Privacy
Nuri Preview does not include telemetry and does not send source code to remote services. Project compilation and preview rendering run locally on your
machine.
## Feedback
Bug reports and feature requests are welcome.
When reporting a problem, please include:
- Visual Studio version
- .NET version
- Nuri version
- Reproduction steps
- Relevant build or preview error messages
## License
License information will be provided with the Nuri project.
---
# Nuri Preview 한국어 안내
Nuri Preview는 Nuri WPF 프로젝트의 컴포넌트를 Visual Studio 2022 안에서 바로 미리 볼 수 있게 해주는 확장입니다.
Nuri 컴포넌트를 열고 Preview 도구 창을 실행하면 애플리케이션을 반복해서 재시작하지 않고 UI를 확인할 수 있습니다. C# 소스 파일을 저장하면 Preview 갱신이 자동
으로 요청됩니다.
> Nuri Preview는 현재 초기 Preview 버전입니다. Nuri Runtime의 발전에 따라 기능과 동작이 변경될 수 있습니다.
## 주요 기능
- Visual Studio 도구 창에서 Nuri WPF 컴포넌트 미리보기
- C# 소스 파일 저장 시 Preview 자동 갱신
- 현재 Preview 수동 새로고침
- 25%부터 400%까지 확대 및 축소
- 배율 초기화, 가운데 정렬 및 창 크기에 맞춤
- 현재 열려 있는 C# 문서에서 Preview 프로젝트 자동 탐색
- Startup Project를 통한 프로젝트 탐색
- 도구 창에서 빌드 및 Preview 상태 확인
- 프로젝트 컴파일과 Preview 렌더링을 로컬 환경에서 실행
## 사용 방법
1. Nuri WPF 프로젝트가 포함된 솔루션을 엽니다.
2. Preview할 프로젝트를 Startup Project로 지정하거나 해당 프로젝트의 C# 파일을 엽니다.
3. 다음 위치 중 하나에서 **Nuri Preview**를 실행합니다.
- **View > Nuri Preview**
- **Tools > Nuri Preview**
- C# 편집기에서 마우스 오른쪽 버튼 클릭 후 **Nuri Preview**
4. C# 파일을 저장하면 Preview가 자동으로 갱신됩니다.
5. 도구 모음에서 새로고침, 확대 및 축소, 가운데 정렬, 창 맞춤 기능을 사용할 수 있습니다.
## 컴포넌트 탐색
Preview할 수 있는 컴포넌트는 다음 조건을 만족해야 합니다.
- `Nuri.UI.Dsl.Component`를 상속해야 합니다.
- public 매개변수 없는 생성자가 있어야 합니다.
Nuri Preview는 다음과 같은 호출에서 루트 컴포넌트를 찾습니다.
```csharp
NuriApplication.Run<MyComponent>();
NuriApplication.Show<MyComponent>();
NuriApplication.Attach<MyComponent>();
프로젝트에 Preview 가능한 컴포넌트가 하나만 있다면 해당 컴포넌트가 자동으로 선택될 수 있습니다.
## 요구 사항
- Visual Studio 2022 Community, Professional 또는 Enterprise
- 64비트 Windows
- .NET Framework 4.7.2 이상
- .NET 8 Desktop Runtime
- Nuri WPF 프로젝트
## 현재 제한 사항
- 현재 Preview Renderer는 Nuri WPF 프로젝트를 대상으로 합니다.
- 생성자 매개변수가 필요한 컴포넌트는 Preview 루트로 선택할 수 없습니다.
- 빌드 또는 컴파일 오류가 있는 코드는 렌더링할 수 없습니다.
- 일부 애플리케이션 리소스나 시작 초기화 코드는 추가적인 Preview 지원이 필요할 수 있습니다.
- 이 릴리스는 기능 평가와 개발 피드백을 위한 초기 버전입니다.
## 개인정보 보호
Nuri Preview에는 텔레메트리가 포함되어 있지 않으며 소스 코드를 외부 서비스로 전송하지 않습니다. 프로젝트 컴파일과 Preview 렌더링은 사용자 컴퓨터에서 로컬로
실행됩니다.
## 피드백
버그 제보와 기능 요청을 환영합니다.
문제를 제보할 때는 다음 정보를 포함해 주세요.
- Visual Studio 버전
- .NET 버전
- Nuri 버전
- 문제 재현 절차
- 관련 빌드 또는 Preview 오류 메시지
## 라이선스
라이선스 정보는 Nuri 프로젝트와 함께 제공될 예정입니다.