Agent skill

Maui Push Notifications

by davidortinau in davidortinau/maui-skills

End-to-end guide for adding push notifications to .NET MAUI apps.

MITAuto-check passedMobile

Install Maui Push Notifications

skills CLI
$ npx skills add davidortinau/maui-skills --skill maui-push-notifications -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davidortinau/maui-skills maui-push-notifications --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ 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-push-notifications .claude/skills/maui-push-notifications && rm -rf skills-src

Use ~/.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/

Facts

Skill name
maui-push-notifications
GitHub stars
175
Token cost
~1.2k tokens
SKILL.md length
369 words
Files
2 (incl. references)
Skills in repo
41
Repo updated
First seen
Licence
MIT

At a glance

End-to-end guide for adding push notifications to .NET MAUI apps.

  • : push notification
  • SKILL.md covers Troubleshooting Table, Critical Gotchas, Platform Checklist and Architecture Overview
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Firebase Cloud Messaging

What it does

Maui Push Notifications is an agent skill from davidortinau/maui-skills. End-to-end guide for adding push notifications to .NET MAUI apps. Covers Firebase Cloud Messaging (Android), Apple Push Notification Service (iOS), Azure Notification Hubs as the cross-platform broker, an ASP.NET Core backend API, and the MAUI client wiring on every platform. USE FOR: "push notification", "FCM", "APNS", "Firebase Cloud Messaging", "Azure Notification Hubs", "device registration", "remote notification", "send push notification", "notification token". DO NOT USE FOR: local/scheduled notifications…

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/push-notifications-api.md`).

It sits in Mobile, covering Cross-platform mobile apps. It works with Android, iOS, Microsoft Azure and Firebase. The repository describes itself as: .NET MAUI skills for GitHub Copilot and Claude Code. The licence is MIT.

When your agent uses it

  • : push notification
  • Firebase Cloud Messaging
  • Azure Notification Hubs
  • Device registration

Example prompts

  • “push notification”
  • “Firebase Cloud Messaging”
  • “Azure Notification Hubs”
  • “/maui-push-notifications”

What it can do on your machine

Read from SKILL.md and the folder at commit 79bb4bf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are csharp).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Maui Push Notifications loads about 1.2k tokens when it runs, and up to ~4.9k if it reads all its reference files. Until then it costs about 173 tokens; SKILL.md has 369 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~173
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.9k

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.

Safety

Auto-check passed

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.

SKILL.md

The full file from davidortinau/maui-skills at commit 79bb4bf, republished under its MIT licence (© davidortinau). 369 words, ~1,227 tokens.

Download SKILL.mdSave it as .claude/skills/maui-push-notifications/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
maui-push-notifications
description
End-to-end guide for adding push notifications to .NET MAUI apps. Covers Firebase Cloud Messaging (Android), Apple Push Notification Service (iOS), Azure Notification Hubs as the cross-platform broker, an ASP.NET Core backend API, and the MAUI client wiring on every platform. USE FOR: "push notification", "FCM", "APNS", "Firebase Cloud Messaging", "Azure Notification Hubs", "device registration", "remote notification", "send push notification", "notification token". DO NOT USE FOR: local/scheduled notifications (use maui-local-notifications), general permission handling (use maui-permissions), or background tasks without notifications (use maui-app-lifecycle).

Push Notifications — Gotchas & Best Practices

Troubleshooting Table

IssueCauseFix
Token changes every debug run (Android)Debug builds regenerate Firebase tokensAlways re-register in OnNewToken
HttpClient requests fail silentlyBaseAddress missing trailing /Ensure endpoint ends with /
iOS push won't arrive on simulatorSimulators don't support APNSUse a physical iOS device
No notifications on Android 13+POST_NOTIFICATIONS required (API 33+)Call RequestPermissions in OnCreate
Notification channel missing (API 26+)Android requires explicit channel creationCreate channel before sending
SendNotificationAsync throws for >20 tagsAzure NH tag expression limitBatch tags in groups of 20
422 on device registrationPlatform string mismatchUse "fcmv1" (not "gcm") and "apns"
Token empty at RegisterAsyncRace condition on cold startGuard with IsNullOrWhiteSpace check

Critical Gotchas

⚠️ BaseAddress trailing slash

HttpClient.BaseAddress must end with /. Without it, relative URI resolution silently breaks.

csharp
// ❌ Relative URIs resolve incorrectly
_http = new HttpClient { BaseAddress = new Uri("https://example.com") };

// ✅ Trailing slash required
_http = new HttpClient { BaseAddress = new Uri("https://example.com/") };
⚠️ Android: Always re-register on token refresh

Firebase tokens regenerate frequently in debug builds. If you skip OnNewToken, the backend holds a stale token and pushes silently fail.

csharp
// ❌ Only registering once at startup
// (token may change later without re-registration)

// ✅ Always re-register in OnNewToken
public override void OnNewToken(string token)
{
    var svc = IPlatformApplication.Current?.Services.GetService<IPushNotificationService>();
    if (svc is null) return;
    svc.Token = token;
    _ = svc.RegisterAsync();
}
⚠️ Android 13+ requires POST_NOTIFICATIONS permission

Without explicitly requesting POST_NOTIFICATIONS on API 33+, notifications are silently dropped.

⚠️ Azure NH tag expression limit: 20 tags

SendNotificationAsync throws if a tag expression references more than 20 tags. Batch into chunks:

csharp
// ✅ Batch tags to stay under the limit
var batches = request.Tags.Chunk(20);
foreach (var batch in batches)
{
    var tagExpr = string.Join(" || ", batch);
    await _hub.SendFcmV1NativeNotificationAsync(payload, tagExpr, ct);
}
⚠️ Use "fcmv1" not "gcm"

The legacy "gcm" platform string causes 422 errors on device registration. Always use "fcmv1" for Android and "apns" for iOS.

Show full SKILL.md (145 more words)Show less
⚠️ iOS simulators cannot receive push notifications

APNS only works on physical iOS devices. Simulators silently ignore push registrations.

Platform Checklist

Android
  • google-services.json in Platforms/Android/ with <GoogleServicesJson> in .csproj
  • Xamarin.Firebase.Messaging NuGet package added (Android-only condition)
  • POST_NOTIFICATIONS permission requested on API 33+
  • Notification channel created before first notification (API 26+)
  • OnNewToken always calls RegisterAsync
  • FirebaseMessagingService registered in manifest with MESSAGING_EVENT intent filter
iOS
  • Push Notifications capability enabled in Apple Developer portal
  • APNs key (.p8) uploaded to Azure Notification Hub
  • Entitlements.plist with aps-environment set to development or production
  • CodesignEntitlements set in .csproj
  • RegisterForRemoteNotifications called on main thread after authorization grant
  • Device token converted to lowercase hex string (no dashes)
Backend
  • Azure Notification Hub configured with FCM V1 JSON and APNS key
  • BaseAddress ends with trailing /
  • Tag expressions batched in groups of ≤20
  • Platform strings: "fcmv1" and "apns" (not legacy values)

Architecture Overview

MAUI app → ASP.NET Core backend → Azure Notification Hub → FCM / APNS → device

See references/push-notifications-api.md for full implementation templates.

© davidortinau, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/maui-skills/skills/maui-push-notifications of davidortinau/maui-skills.

  • SKILL.md
  • references/push-notifications-api.md

Open the folder on GitHubat commit 79bb4bf

Compare with similar skills

Maui Push Notifications 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.

Maui Push Notifications compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Maui Push Notifications this skilldavidortinau/maui-skills175—~1.2kAutomated safety check: PassMIT
Cometchat Flutter V6 Pushcometchat/cometchat-skills132—~1.4kAutomated safety check: PassMIT
Cometchat React Native Pushcometchat/cometchat-skills132—~1.3kAutomated safety check: PassMIT
Web3authWeb3Auth/web3auth-examples144—~1.4kAutomated safety check: PassMIT
Offensive MobileSnailSploit/Claude-Red7.4k—~3.5kAutomated safety check: PassMIT
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause

Similar skills

  • Cometchat Flutter V6 Push

    cometchat/cometchat-skills

    Add push notifications to a Flutter app with CometChat — FCM on Android, FCM/APNs on iOS, registered through CometChatNotifications with the Dashboard provider as the sender.

    132 GitHub stars~1.4k tokensUpdated 5 days ago
    MobileAuto-check passed
  • Cometchat React Native Push

    cometchat/cometchat-skills

    Push notifications for CometChat in React Native — FCM on Android, APNs on iOS, registering the device token with CometChatNotifications, and why none of it can be verified without a real device.

    132 GitHub stars~1.3k tokensUpdated 5 days ago
    MobileAuto-check passed
  • Web3auth

    Web3Auth/web3auth-examples

    Integrates MetaMask Embedded Wallets (Web3Auth) for non-custodial wallets via social login or custom JWT (Firebase, Auth0, Cognito).

    144 GitHub stars~1.4k tokensUpdated 7 days ago
    Backend & APIsAuto-check passed
  • Offensive Mobile

    SnailSploit/Claude-Red

    Mobile (Android + iOS) application penetration testing methodology.

    7.4k GitHub stars~3.5k tokensUpdated 20 days ago
    SecurityAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Rnn Codebase

    wix/react-native-navigation

    Official

    Navigate and work with the react-native-navigation (RNN) codebase.

    13k GitHub stars~2k tokensUpdated 4 days ago
    MobileAuto-check passed

More from davidortinau/maui-skills

All 41 skills in this repo
  • Maui Hot Reload Diagnostics

    davidortinau/maui-skills

    Diagnose and troubleshoot .NET MAUI Hot Reload issues (C Hot Reload, XAML Hot Reload, Blazor Hybrid).

    175 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Maui Accessibility

    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…

    175 GitHub stars~974 tokensUpdated 3 mo ago
    Auto-check passed
  • Maui Animations

    davidortinau/maui-skills

    .NET MAUI view animations, custom animations, easing functions, rotation, scale, translation, and fade effects.

    175 GitHub stars~911 tokensUpdated 3 mo ago
    Auto-check passed
  • Maui App Icons Splash

    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…

    175 GitHub stars~995 tokensUpdated 3 mo ago
    Auto-check passed
  • Maui App Lifecycle

    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…

    175 GitHub stars~947 tokensUpdated 3 mo ago
    Auto-check passed
  • Maui Aspire

    davidortinau/maui-skills

    Guide for .NET MAUI apps consuming .NET Aspire-hosted backend services.

    175 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Maui Push Notifications

What does Maui Push Notifications do?

End-to-end guide for adding push notifications to .NET MAUI apps. Maui Push Notifications is an agent skill from davidortinau/maui-skills.NET MAUI apps.

When should I use Maui Push Notifications?

Maui Push Notifications fits situations like: : push notification; firebase Cloud Messaging; azure Notification Hubs; device registration.

How do I install Maui Push Notifications in Claude Code?

Run `npx skills add davidortinau/maui-skills --skill maui-push-notifications -a claude-code`. Or copy the skill folder (plugins/maui-skills/skills/maui-push-notifications in davidortinau/maui-skills) into .claude/skills/maui-push-notifications in your project. Claude Code loads it when a task matches its description.

How do I install Maui Push Notifications in Codex?

Run `npx skills add davidortinau/maui-skills --skill maui-push-notifications -a codex`. Or copy the skill folder (plugins/maui-skills/skills/maui-push-notifications in davidortinau/maui-skills) into .agents/skills/maui-push-notifications in your project. Codex loads it when a task matches its description.

Can I use Maui Push Notifications in Cursor, Gemini CLI or GitHub Copilot?

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-push-notifications -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-push-notifications, .gemini/skills/maui-push-notifications, .github/skills/maui-push-notifications and .opencode/skills/maui-push-notifications in your project.

What does Maui Push Notifications need to run?

SKILL.md names no scripts, command-line tools or credentials: Maui Push Notifications is instructions for the agent only.

Does Maui Push Notifications access the network?

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.

Is Maui Push Notifications safe to install?

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.

What licence does Maui Push Notifications use?

Maui Push Notifications is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Maui Push Notifications use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 3.7k tokens, read only when the agent opens those files.

What are the alternatives to Maui Push Notifications?

Skills that share tags, products or a category with Maui Push Notifications: Cometchat Flutter V6 Push (cometchat/cometchat-skills, 132 stars), Cometchat React Native Push (cometchat/cometchat-skills, 132 stars), Web3auth (Web3Auth/web3auth-examples, 144 stars) and Offensive Mobile (SnailSploit/Claude-Red, 7.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Maui Push Notifications?

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.