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.

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

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

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny-maui@shiny

Coming soon — Copilot plugin install instructions will be added here.

View shiny-maui Plugin

Next Steps

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