Maui Safe Area
dotnet/skills
.NET MAUI safe area and edge-to-edge layout guidance for .NET 10+.
Guidance for embedding web content in .NET MAUI apps using HybridWebView, including JavaScript–C interop, bidirectional communication, raw messaging, and trimming/NativeAOT considerations.
$ npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install davidortinau/maui-skills maui-hybridwebview --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/maui-skills/skills/maui-hybridwebview .claude/skills/maui-hybridwebview && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "maui-hybridwebview" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-hybridwebview into .claude/skills/maui-hybridwebview/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-hybridwebview", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-hybridwebviewType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install davidortinau/maui-skills maui-hybridwebview --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/maui-skills/skills/maui-hybridwebview .agents/skills/maui-hybridwebview && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "maui-hybridwebview" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-hybridwebview into .agents/skills/maui-hybridwebview/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-hybridwebview", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install davidortinau/maui-skills maui-hybridwebview --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/maui-skills/skills/maui-hybridwebview .cursor/skills/maui-hybridwebview && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "maui-hybridwebview" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-hybridwebview into .cursor/skills/maui-hybridwebview/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-hybridwebview", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/davidortinau/maui-skills.git --path plugins/maui-skills/skills/maui-hybridwebview--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install davidortinau/maui-skills maui-hybridwebview --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/maui-skills/skills/maui-hybridwebview .gemini/skills/maui-hybridwebview && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "maui-hybridwebview" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-hybridwebview into .gemini/skills/maui-hybridwebview/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-hybridwebview", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install davidortinau/maui-skills maui-hybridwebviewInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/maui-skills/skills/maui-hybridwebview .github/skills/maui-hybridwebview && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "maui-hybridwebview" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-hybridwebview into .github/skills/maui-hybridwebview/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-hybridwebview", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install davidortinau/maui-skills maui-hybridwebview --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/maui-skills/skills/maui-hybridwebview .opencode/skills/maui-hybridwebview && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "maui-hybridwebview" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-hybridwebview into .opencode/skills/maui-hybridwebview/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-hybridwebview", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
maui-hybridwebviewGuidance for embedding web content in .NET MAUI apps using HybridWebView, including JavaScript–C interop, bidirectional communication, raw messaging, and trimming/NativeAOT considerations.
Maui Hybridwebview is an agent skill from davidortinau/maui-skills. Guidance for embedding web content in .NET MAUI apps using HybridWebView, including JavaScript–C interop, bidirectional communication, raw messaging, and trimming/NativeAOT considerations. USE FOR: "HybridWebView", "JavaScript interop", "embed web content", "JS to C interop", "C to JavaScript", "web view interop", "raw message", "InvokeJavaScriptAsync", "web content MAUI". DO NOT USE FOR: deep linking from external URLs (use maui-deep-linking), REST API calls (use maui-rest-api), or Blazor Hybrid apps (different…
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/hybridwebview-api.md`).
It sits in Mobile, covering Cross-platform mobile apps. It works with C#, JavaScript and Blazor. The repository describes itself as: .NET MAUI skills for GitHub Copilot and Claude Code. The licence is MIT.
Read from SKILL.md and the folder at commit 79bb4bf. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are csharp, html and xml).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Maui Hybridwebview loads about 1.2k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 140 tokens; SKILL.md has 328 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from davidortinau/maui-skills at commit 79bb4bf, republished under its MIT licence (© davidortinau). 328 words, ~1,239 tokens.
.claude/skills/maui-hybridwebview/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.HybridWebView hosts HTML/JS/CSS content inside a .NET MAUI app with bidirectional C#↔JS communication. It is not a general browser control — it is designed for local web content shipped with the app.
| Issue | Fix |
|---|---|
| Blank white screen | Web assets missing from Resources/Raw/wwwroot or DefaultFile not set |
| JS interop silently fails | Missing <script src="_hwv/HybridWebView.js"></script> in HTML |
InvokeJavaScriptAsync returns null | Return type missing [JsonSerializable] attribute in JsonSerializerContext |
| JS → C# calls do nothing | SetInvokeJavaScriptTarget not called before JS invokes C# methods |
| Serialization crash with trimming | Not using source-generated JsonSerializerContext |
The HTML page must include the bridge script before any app scripts:
<!-- ✅ Correct order -->
<script src="_hwv/HybridWebView.js"></script>
<script src="scripts/app.js"></script>
<!-- ❌ Wrong — app.js loads before bridge, interop calls fail silently -->
<script src="scripts/app.js"></script>
<script src="_hwv/HybridWebView.js"></script>Every parameter type and return type used in InvokeJavaScriptAsync must have a [JsonSerializable] entry:
// ✅ Correct — all interop types registered
[JsonSerializable(typeof(int))]
[JsonSerializable(typeof(string))]
[JsonSerializable(typeof(Person))]
internal partial class MyJsonContext : JsonSerializerContext { }
// ❌ Wrong — adding a new type to interop without registering it
// This causes silent null returns or runtime exceptionsRule: When you add a new type to the interop surface, you must add a
[JsonSerializable(typeof(T))]attribute to the context. Forgetting this is the #1 cause of mysterious interop failures.
// ✅ Set target BEFORE the web page loads and JS calls C#
myHybridWebView.SetInvokeJavaScriptTarget(new MyJsBridge());
// ❌ Setting it after JS already tried to call — calls are lost⚠️ Call SetInvokeJavaScriptTarget during page construction or OnAppearing, not lazily.
JS exceptions thrown during InvokeJavaScriptAsync are forwarded to .NET. Always wrap interop calls:
// ✅ Catches JS errors
try
{
var result = await myHybridWebView.InvokeJavaScriptAsync<string>(
"riskyFunction", MyJsonContext.Default.String);
}
catch (Exception ex)
{
Debug.WriteLine($"JS error: {ex.Message}");
}
// ❌ Unhandled JS exception crashes the interop pipeline
var result = await myHybridWebView.InvokeJavaScriptAsync<string>(
"riskyFunction", MyJsonContext.Default.String);Trimming is disabled by default in MAUI projects. If you enable it:
JsonSerializerContext (not reflection-based serialization)JsonSerializerIsReflectionEnabledByDefault to falseJsonSerializerContext as shown above is recommended regardless of trimming settings<PropertyGroup>
<PublishTrimmed>true</PublishTrimmed>
<JsonSerializerIsReflectionEnabledByDefault>false</JsonSerializerIsReflectionEnabledByDefault>
</PropertyGroup>| Need | Use |
|---|---|
| Structured data exchange with type safety | InvokeJavaScriptAsync / InvokeDotNet with JsonSerializerContext |
| Simple string payloads, fire-and-forget | SendRawMessage / RawMessageReceived |
| Calling C# from JS with return values | InvokeDotNet (target must be set first) |
| Multiple JS functions to call | Typed interop — one InvokeJavaScriptAsync per function |
Resources/Raw/wwwrootindex.html includes <script src="_hwv/HybridWebView.js"></script> before app scriptsDefaultFile is set (or defaults to index.html)[JsonSerializable] entry in a JsonSerializerContextSetInvokeJavaScriptTarget is called before JS invokes C# methodsInvokeJavaScriptAsync calls are wrapped in try/catch (.NET 9+)© davidortinau, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file (references) in plugins/maui-skills/skills/maui-hybridwebview of davidortinau/maui-skills.
Open the folder on GitHubat commit 79bb4bf
Maui Hybridwebview next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Maui Hybridwebview this skilldavidortinau/maui-skills | 175 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Maui Safe Areadotnet/skills | 5.6k | 1 repos | ~3.2k | Automated safety check: Pass | MIT | |
| Wallet QuickstartNethereum/Nethereum | 2.3k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Csharp Expertmicrosoft/testfx | 1k | 2 repos | ~5.4k | Automated safety check: Pass | MIT | |
| Sentry Dotnet SDKgetsentry/sentry-for-ai | 268 | — | ~5.8k | Automated safety check: Pass | Apache-2.0 | |
| Using Dotnetnovotnyllc/dotnet-artisan | 232 | — | ~2.3k | Automated safety check: Warn | MIT |
dotnet/skills
.NET MAUI safe area and edge-to-edge layout guidance for .NET 10+.
Nethereum/Nethereum
Build a multi-platform wallet application using the Nethereum Wallet SDK with MVVM architecture (.NET/C).
microsoft/testfx
Route C and .NET requests to the exact installed specialist or smallest dotnet/skills marketplace plugin.
getsentry/sentry-for-ai
Full Sentry SDK setup for .NET. An agent skill from getsentry/sentry-for-ai.
novotnyllc/dotnet-artisan
Detects .NET intent for any C, ASP.NET Core, EF Core, Blazor, MAUI, Uno Platform, WPF, WinUI, SignalR, gRPC, xUnit, NuGet, or MSBuild request from prompt keywords and repository signals (.sln…
dotnet/skills
Add, review, or fix JavaScript interop in Blazor components.
davidortinau/maui-skills
Diagnose and troubleshoot .NET MAUI Hot Reload issues (C Hot Reload, XAML Hot Reload, Blazor Hybrid).
davidortinau/maui-skills
Guide for making .NET MAUI apps accessible — screen reader support via SemanticProperties, heading levels, AutomationProperties visibility control, programmatic focus and announcements, and…
davidortinau/maui-skills
.NET MAUI view animations, custom animations, easing functions, rotation, scale, translation, and fade effects.
davidortinau/maui-skills
.NET MAUI app icon configuration, splash screen setup, SVG to PNG conversion at build time, composed/adaptive icons, and platform-specific icon and splash screen requirements for Android, iOS, Mac…
davidortinau/maui-skills
.NET MAUI app lifecycle guidance covering the four app states (not running, running, deactivated, stopped), cross-platform Window lifecycle events, backgrounding and resume behaviour…
davidortinau/maui-skills
Guide for .NET MAUI apps consuming .NET Aspire-hosted backend services.
Works with
Categories
Guidance for embedding web content in .NET MAUI apps using HybridWebView, including JavaScript–C interop, bidirectional communication, raw messaging, and trimming/NativeAOT considerations. Maui Hybridwebview is an agent skill from davidortinau/maui-skills.NET MAUI apps using HybridWebView, including JavaScript–C interop, bidirectional communication, raw messaging, and trimming/NativeAOT considerations.
Maui Hybridwebview fits situations like: : HybridWebView; javaScript interop; embed web content; JS to C interop.
Run `npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a claude-code`. Or copy the skill folder (plugins/maui-skills/skills/maui-hybridwebview in davidortinau/maui-skills) into .claude/skills/maui-hybridwebview in your project. Claude Code loads it when a task matches its description.
Run `npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a codex`. Or copy the skill folder (plugins/maui-skills/skills/maui-hybridwebview in davidortinau/maui-skills) into .agents/skills/maui-hybridwebview in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davidortinau/maui-skills --skill maui-hybridwebview -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/maui-hybridwebview, .gemini/skills/maui-hybridwebview, .github/skills/maui-hybridwebview and .opencode/skills/maui-hybridwebview in your project.
SKILL.md names no scripts, command-line tools or credentials: Maui Hybridwebview is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Maui Hybridwebview is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Maui Hybridwebview: Maui Safe Area (dotnet/skills, 5.6k stars), Wallet Quickstart (Nethereum/Nethereum, 2.3k stars), Csharp Expert (microsoft/testfx, 1k stars) and Sentry Dotnet SDK (getsentry/sentry-for-ai, 268 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
davidortinau (a GitHub user) maintains it in davidortinau/maui-skills, which has 175 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on July 6, 2026.
Source: davidortinau/maui-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.