Skip to content

README.md

Latest commit

 

History

History
55 lines (37 loc) · 1.87 KB

README.md

File metadata and controls

55 lines (37 loc) · 1.87 KB
Raw

traverse-starter (Windows WinUI 3)

Native Windows client for the traverse-starter reference app. Phase 1 uses HTTP polling against the public Traverse HTTP/JSON API (spec 033) — same flow as web-react, ios-swift, and android-compose.

Prerequisites

  • Windows 10 1809+ (build 17763) or Windows 11
  • Visual Studio 2022 with the Windows App SDK and .NET desktop development workloads
  • Traverse runtime running locally
git clone https://github.com/traverse-framework/Traverse.git C:\temp\traverse
cd C:\temp\traverse && git checkout v0.6.0
cargo run -p traverse-cli -- serve

Runtime URL configuration

Open Settings (gear icon in the navigation pane) and set:

  • Runtime URL — default http://127.0.0.1:8787
  • Workspace — default local-default

Values persist in ApplicationData.Current.LocalSettings.

Build and run

From Visual Studio 2022, open TraverseStarter.sln and run on x64.

Or from a Developer PowerShell:

cd apps\traverse-starter\windows-winui
dotnet build TraverseStarter.sln -c Release
dotnet test TraverseStarter.sln -c Release
dotnet run --project TraverseStarter\TraverseStarter.csproj

Architecture

File Role
TraverseClient.cs HttpClient wrapper for execute / poll / trace / healthz
ExecutionViewModel.cs MVVM polling state machine (CommunityToolkit.Mvvm)
HomePage.xaml Main view — note input, output fields, trace expander
SettingsPage.xaml Runtime URL + workspace (ApplicationData)
MainWindow.xaml Navigation shell with title-bar health strip

Phase 2 (not implemented)

SSE subscription when Traverse ships #525–#527.

Design language

Follow docs/design-language.md.