maui-secure-storage

Store and retrieve sensitive data via SecureStorage.Default in MAUI apps.

Updated Dec 25, 2025
One-click install
npx skills add https://github.com/heldercsousa/MyVocaList --skill maui-secure-storage-heldercsousa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-secure-storage
Source: https://github.com/heldercsousa/MyVocaList/tree/main/.claude/skills/maui-secure-storage
Command: npx skills add https://github.com/heldercsousa/MyVocaList --skill maui-secure-storage-heldercsousa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing secure storage for tokens and secrets across MAUI platforms is error-prone without a consistent API and proper platform-specific considerations. This skill provides a unified wrapper around SecureStorage.Default to simplify storing, retrieving, and removing sensitive values while handling common pitfalls.

Core Features & Use Cases

  • Store and retrieve small strings securely via SecureStorage.Default, with a DI-friendly service for testability.
  • Platform setup guidance for Android backup rules, iOS Keychain entitlements, and Windows storage limits.
  • Includes a minimal DI wrapper (ISecureStorageService) and sample usage for MVVM architectures.

Quick Start

Add the SecureStorageService to your MauiProgram DI container and call SetAsync to store a token.

Frequently Asked Questions about maui-secure-storage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I securely store tokens in a .NET MAUI app across iOS and Android?

Securely store tokens in a .NET MAUI app by using a DI wrapper service around SecureStorage.Default. This handles cross-platform token storage, retrieval, and removal consistently across iOS Keychain, Android Keystore, macOS, and Windows.

What platform configurations are needed for secure storage in MAUI?

Secure storage in MAUI requires configuring Android backup rules, iOS Keychain entitlements, and understanding Windows storage limits. Proper platform setup ensures sensitive data like tokens are safely persisted without triggering OS-level security errors.

How do I add a secure storage service to my MAUI dependency injection container?

Add the secure storage service to your MAUI DI container by registering the included ISecureStorageService interface in MauiProgram. This enables testable, MVVM-friendly asynchronous storage and retrieval of small sensitive strings via SecureStorage.Default.

Why does secure storage fail after enabling Android backup in my MAUI app?

Secure storage can fail on Android if backup rules are not configured to exclude sensitive data. The skill provides guidance on setting correct Android backup rules so tokens and secrets stored via SecureStorage.Default are not backed up insecurely.

Can I use MAUI SecureStorage.Default to store large sensitive strings on Windows?

Storing large sensitive strings using MAUI SecureStorage.Default on Windows is not recommended due to platform storage limits. The skill is designed for small string values like authentication tokens and handles safe backup limitations across all platforms.

What is the best way to remove a secure token from MAUI cross-platform storage?

The best way to remove a secure token from MAUI cross-platform storage is through the provided ISecureStorageService DI wrapper. It safely executes removal operations via SecureStorage.Default across Android, iOS, macOS, and Windows.