https://github.com/redth/maui.sherpa
Let MAUI Sherpa guide you through all your .NET MAUI dev environment needs!
https://github.com/redth/maui.sherpa
Last synced: 3 months ago
JSON representation
Let MAUI Sherpa guide you through all your .NET MAUI dev environment needs!
- Host: GitHub
- URL: https://github.com/redth/maui.sherpa
- Owner: Redth
- License: mit
- Created: 2026-02-02T17:22:25.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-07T21:37:01.000Z (4 months ago)
- Last Synced: 2026-02-07T22:44:56.408Z (4 months ago)
- Language: HTML
- Size: 11.1 MB
- Stars: 22
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
MAUI Sherpa
Your guide to .NET MAUI development
MAUI Sherpa is a desktop application for **macOS**, **Windows**, and **Linux** that helps manage your .NET MAUI development environment. It provides a unified interface for Android SDK management, Apple Developer tools, environment diagnostics, DevFlow app inspection, and GitHub Copilot integration.
🌐 **[Visit the website →](https://redth.github.io/MAUI.Sherpa/)**
## ✨ Features
### 🩺 MAUI Doctor
- Check your development environment health
- Diagnose .NET SDK, workloads, and dependencies
- AI-powered fix suggestions via Copilot
- One-click environment repairs
### 📦 Android SDK Management
- Browse and install SDK packages
- Manage platform tools, build tools, and system images
- Search and filter packages
- Track installed vs available packages
### 📱 Android Emulators
- Create, edit, and delete emulators
- Start and stop emulators
- Create snapshots for quick boot
- View emulator details and configuration
### 🔑 Android Keystores
- Create and manage Android signing keystores
- View certificate signatures and details
- Export PEPK keys for Google Play
- Cloud sync keystores across machines
### 🍎 Apple Developer Tools (macOS only)
- **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
### 🔍 Device Inspectors
- **Android**: Logcat viewer, file browser, shell, screen capture, and device tools
- **iOS Simulator**: Log viewer, app manager, screen capture, and simulator tools
### 🔬 DevFlow App Inspector
- Remote visual tree inspection of running MAUI apps
- Interactive screenshot with element highlighting
- Network request monitoring with detailed views
- Application log streaming (native + WebView)
- Blazor WebView DOM inspection via CDP
- Live property editing (colors, sizes, brushes)
### 📋 Publish Profiles
- Bundle Apple + Android signing configs into reusable profiles
- Publish secrets to GitHub, GitLab, Azure DevOps repositories
- Multi-destination publishing with review workflow
### 🤖 GitHub Copilot Integration
- Chat with Copilot directly in the app
- Get AI-assisted help with your development environment
- Suggested prompts for common tasks
## 📸 Screenshots
🩺 Doctor
📦 Android SDK Packages
📱 Android Emulators
📲 Android Devices
🔑 Android Keystores
🍎 Apple Simulators
🍎 Apple Registered Devices
🍎 Apple Bundle IDs
🍎 Apple Certificates
🍎 Apple Provisioning Profiles
🍎 Root Certificates
🔍 Android Device Inspector
🔍 iOS Simulator Inspector
🔬 DevFlow App Inspector
📋 Publish Profiles
⚙️ Settings
🤖 GitHub Copilot
## 🚀 Getting Started
### Installation
Download the latest release from the [Releases](https://github.com/Redth/MAUI.Sherpa/releases) page, or see the [Getting Started guide](https://redth.github.io/MAUI.Sherpa/getting-started.html) for detailed instructions.
#### macOS (Homebrew)
```bash
brew install --cask redth/tap/maui-sherpa
```
#### macOS (Manual)
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)
#### Windows
1. Download `MAUI-Sherpa.windows-x64.zip` or `MAUI-Sherpa.windows-arm64.zip`
2. Extract to your preferred location
3. Run `MauiSherpa.exe`
#### Linux
Download AppImage, .deb, or Flatpak from the releases page for your architecture (x64 or arm64).
### Apple Developer Tools Setup
To use the Apple Developer tools, you'll need to configure your App Store Connect credentials:
1. Go to [App Store Connect](https://appstoreconnect.apple.com/) → Users and Access → Integrations → Individual 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.
### GitHub Copilot Setup
To use the Copilot integration:
1. Install [GitHub Copilot CLI](https://docs.github.com/en/copilot/github-copilot-in-the-cli)
2. Authenticate with `gh auth login`
3. MAUI Sherpa will automatically detect and connect to Copilot
## 🛠️ Building from Source
```bash
# Clone the repository
git clone https://github.com/Redth/MAUI.Sherpa.git
cd MAUI.Sherpa
# Restore dependencies
dotnet restore
# Build for macOS (AppKit)
dotnet build src/MauiSherpa.MacOS -f net10.0-macos
# 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 tests
dotnet test
```
## 🏗️ Project Structure
```
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.MacOS/ # macOS AppKit app head
│ ├── MauiSherpa.LinuxGtk/ # Linux GTK4 app head
│ ├── 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
├── website/ # GitHub Pages website
└── docs/ # Documentation
```
## 🧪 Running Tests
```bash
# Run all tests
dotnet test
# Run with coverage
dotnet test --collect:"XPlat Code Coverage"
# Run specific test project
dotnet test tests/MauiSherpa.Core.Tests
```
## 🤝 Contributing
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
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- [.NET MAUI](https://github.com/dotnet/maui) - Cross-platform UI framework
- [Platform.Maui.MacOS](https://github.com/nicoleeldridge/mauiplatforms) - macOS AppKit backend for .NET MAUI
- [Platform.Maui.Linux.Gtk4](https://github.com/nicoleeldridge/Maui.Gtk) - Linux GTK4 backend for .NET MAUI
- [Shiny.Mediator](https://github.com/shinyorg/mediator) - Mediator pattern with caching
- [AndroidSdk](https://github.com/redth/androidsdk.tool) - Android SDK management APIs
- [AppleDev.Tools](https://github.com/redth/appledev.tools) - Apple Developer Tools APIs and AppStoreConnect API client
- [MauiDevFlow](https://github.com/Redth/MauiDevFlow) - Remote app inspection agent
- [GitHub Copilot](https://github.com/github/copilot-sdk) - AI-powered assistance via Copilot SDK