Search packages, repositories and app categories

fast_contacts cover
Package detailsv6.0.0

fast_contacts

A faster way of accessing the device's contacts list. Allows fetching the whole contacts list in a sane amount of time.

AndroidiOS
30-day downloads
79.5K
Likes
120
Pub points
150

Install package

flutter pub add fast_contacts

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

fast_contacts is a Flutter package that provides a high-performance solution for accessing the device's contacts list. It enables developers to fetch the entire contacts database efficiently, significantly reducing load times compared to standard approaches. Designed with simplicity and speed in mind, it integrates seamlessly into Android and iOS apps, offering a reliable way to retrieve contact data without excessive delays. The package is ideal for applications requiring quick access to user contacts, such as messaging or social networking apps.

Use cases

  • Fetching all contacts quickly
  • Integrating contact search features
  • Building contact picker interfaces
  • Enabling user connection features
  • Supporting messaging app contact lists

Key features

  • Fast contact retrieval
  • Cross-platform support (Android & iOS)
  • Simple API integration
  • Efficient memory usage
  • Minimal latency when loading contacts

Suitable for

  • Contact picker implementations
  • Apps needing rapid contact access
  • User onboarding with contact import
  • Social or communication platforms
  • Performance-sensitive contact operations

Considerations

  • Requires proper permissions on Android and iOS
  • May need handling of large contact datasets
  • Limited to basic contact data (name, phone, email)
  • Not suitable for real-time contact sync
  • Depends on native platform contact APIs

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

fast_contacts

Version Likes Points Downloads

A much faster alternative to contacts_service and flutter_contact for reading the device's contact book.

This plugin was tuned to achieve optimal performance for fetching the whole list of contacts. Loading 1000 contacts with this plugin should take ~200ms or less depending on the device.

Usage

To use this plugin, add fast_contacts as a dependency in your pubspec.yaml file.

Permissions

Android

Add the following permission to your AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_CONTACTS" />
iOS

Set the NSContactsUsageDescription in your Info.plist file

<key>NSContactsUsageDescription</key>
<string>Description of why you need the contacts permission.</string>

Note fast_contacts doesn't handle permissions. Use special plugins (like permission_handler) to ask for the permission before accessing contacts.

Available contact info

  • ID
  • Display name
  • Structured name (prefix, given name, middle name, family name, suffix)
  • Emails
  • Phones
  • Organization (company, department, job description)

Example

// Import package
import 'package:fast_contacts/fast_contacts.dart';

// Get all contacts
final contacts = await FastContacts.getAllContacts();

// Get single contact by ID
final contact = await FastContacts.getContact(contactId);

// Get contact's image (thumbnail)
final thumbnail = await FastContacts.getContactImage(contact.id);

// Get contact's image (full size)
final thumbnail = await FastContacts.getContactImage(contact.id, size: ContactImageSize.fullSize);

For a more complete usage example, see example project.

Performance

Loading 1000+ contacts (display name, structured name, phones, emails) at once takes ~200ms on both Android (Samsung Galaxy S8) and iOS (iPhone 8).

Android: Samsung Galaxy S8

iOS: iPhone 8

Categories

Source repository

Projects using this package