Let MAUI Sherpa guide you through all your .NET MAUI dev environment needs!

MAUI Sherpa is a desktop application for macOS and Windows that helps manage your .NET MAUI development environment. It provides a unified interface for Android SDK management, Apple Developer tools, environment diagnostics, and GitHub Copilot integration.

• Chat with Copilot directly in the app
• Get AI-assisted help with your development environment
• Suggested prompts for common tasks

• Check your development environment health
• Diagnose .NET SDK, workloads, and dependencies
• AI-powered fix suggestions via Copilot
• One-click environment repairs

• Browse and install SDK packages
• Manage platform tools, build tools, and system images
• Search and filter packages
• Track installed vs available packages

• Create, edit, and delete emulators
• Start and stop emulators
• Create snapshots for quick boot
• View emulator details and configuration

• Create and manage Android signing keystores
• View certificate signatures and details
• Export PEPK keys for Google Play
• Cloud sync keystores across machines

• Simulators: Manage iOS/iPadOS/tvOS/watchOS simulators with built-in inspector
• Bundle IDs: Create and manage App IDs with capabilities editor
• Devices: Register devices for development and ad-hoc distribution
• Certificates: Create, download, export, and revoke signing certificates
• Provisioning Profiles: Create, edit, and manage profiles with CI secrets export
• Root Certificates: Install Apple root certificates for development

• Android: Logcat viewer, file browser, shell, screen capture, and device tools
• iOS Simulator: Log viewer, app manager, screen capture, and simulator tools

• .NET 10 SDK
• .NET MAUI workload (dotnet workload install maui)
• macOS: Xcode (for Apple tools and Mac Catalyst)
• Windows: Visual Studio 2022 or Windows App SDK

Download the latest release from the Releases page.

1. Download MAUI.Sherpa-macOS.zip
2. Extract and move MAUI Sherpa.app to Applications
3. Right-click and select "Open" on first launch (to bypass Gatekeeper)

1. Download MAUI.Sherpa-Windows.zip
2. Extract to your preferred location
3. Run MauiSherpa.exe

To use the Apple Developer tools, you'll need to configure your App Store Connect credentials:

1. Go to App Store Connect → Users and Access → Keys
2. Create a new API key with "Developer" access
3. Download the .p8 key file
4. In MAUI Sherpa, click the identity picker and add your credentials:
   • Issuer ID: Found on the Keys page
   • Key ID: The ID of your API key
   • Private Key: Contents of the .p8 file

Your credentials are stored securely in the system keychain.

To use the Copilot integration:

1. Install GitHub Copilot CLI
2. Authenticate with gh auth login
3. MAUI Sherpa will automatically detect and connect to Copilot

# Clone the repository
git clone https://github.com/Redth/MAUI.Sherpa.git
cd MAUI.Sherpa

# Restore dependencies
dotnet restore

# Build for Mac Catalyst
dotnet build src/MauiSherpa -f net10.0-maccatalyst

# Build for Windows
dotnet build src/MauiSherpa -f net10.0-windows10.0.19041.0

# Run on Mac Catalyst
dotnet run --project src/MauiSherpa -f net10.0-maccatalyst

# Run tests
dotnet test

# Publish Mac Catalyst (Release)
dotnet publish src/MauiSherpa -f net10.0-maccatalyst -c Release

# Publish Windows (Release)
dotnet publish src/MauiSherpa -f net10.0-windows10.0.19041.0 -c Release

MAUI.Sherpa/
├── src/
│   ├── MauiSherpa/               # Main MAUI Blazor Hybrid app
│   │   ├── Components/           # Reusable Blazor components
│   │   ├── Pages/                # Blazor page components
│   │   ├── Services/             # Platform-specific services
│   │   └── Platforms/            # Platform code (MacCatalyst, Windows)
│   ├── MauiSherpa.Core/          # Business logic library
│   │   ├── Handlers/             # Mediator request handlers
│   │   ├── Requests/             # Request records
│   │   ├── Services/             # Service implementations
│   │   └── ViewModels/           # MVVM ViewModels
│   └── MauiSherpa.Workloads/     # .NET workload querying library
├── tests/
│   ├── MauiSherpa.Core.Tests/    # Core library tests
│   └── MauiSherpa.Workloads.Tests/ # Workloads library tests
└── docs/                         # Documentation and screenshots

# Run all tests
dotnet test

# Run with coverage
dotnet test --collect:"XPlat Code Coverage"

# Run specific test project
dotnet test tests/MauiSherpa.Core.Tests

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• .NET MAUI - Cross-platform UI framework
• Shiny.Mediator - Mediator pattern with caching
• AndroidSdk - Android SDK management APIs
• AppleDev.Tools - Apple Developer Tools APIs and AppStoreConnect API client
• GitHub Copilot - AI-powered assistance via Copilot SDK