Contact Store | Getting Started

A cross-platform .NET MAUI library for accessing device contacts on Android and iOS. Provides full CRUD operations, LINQ query support, MAUI permission classes, and dependency injection integration.

GitHub
Downloads

Frameworks

.NET MAUI

Features

• Full CRUD — create, read, update, and delete device contacts
• LINQ queries — IQueryable<Contact> with native translation on both platforms
• MAUI permissions — ContactPermission class for requesting read/write access
• Permission extensions — RequestPermissionsAsync() and CheckPermissionStatusAsync() on IContactStore
• AOT compatible — trimmer and AOT safe
• Dependency injection — register with a single AddContactStore() call

Platforms

Platform	Minimum Version
Android	API 24
iOS	15.0

Setup

• NuGet Packages
• Project File
• MauiProgram.cs
• AndroidManifest.xml
• Info.plist
• PrivacyInfo.xcprivacy

Shiny.Maui.ContactStore

Quick Example

// Request permissions
var status = await contactStore.RequestPermissionsAsync();

// Get all contacts
var contacts = await contactStore.GetAll();

// Query with LINQ
var results = contactStore.Query()
    .Where(c => c.GivenName.Contains("John"))
    .ToList();

// Create a contact
var contact = new Contact { GivenName = "John", FamilyName = "Doe" };
contact.Phones.Add(new ContactPhone("555-1234", PhoneType.Mobile));
string id = await contactStore.Create(contact);

// Update
contact.GivenName = "Jane";
await contactStore.Update(contact);

// Delete
await contactStore.Delete(id);

AI Coding Assistant

Claude Code GitHub Copilot

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny-maui@shiny

Step 1 — Add the marketplace:

copilot plugin marketplace add https://github.com/shinyorg/skills

Step 2 — Install the plugin:

copilot plugin install shiny-maui@shiny

View shiny-maui Plugin

Next Steps

• Permissions — MAUI permission classes and status handling
• Querying — LINQ queries with native translation
• Release Notes — Version history