React Native's Share API: Use the Native Share Sheet

WHY IT EXISTS: Apps often need to let users share content like articles, scores, or links with other apps or contacts. Building a custom sharing interface for every possible destination is impractical and results in an unfamiliar user experience. The Share API solves this by providing a unified way to invoke the operating system's built-in sharing functionality.

THE MENTAL MODEL: Think of the Share API as a "hand-off" mechanism. Your app prepares the content (a message and/or a URL) and hands it to the operating system. The OS then presents its native, familiar share sheet to the user, who decides where and how to share it. Your app gets a simple notification back about whether the user completed the action (on iOS) or just opened the dialog (on Android).

HOW IT WORKS: You call the static method Share.share(), an async function that returns a Promise. You pass it a content object, which must contain a message string, a url string, or both. The Promise resolves after the user interacts with the share dialog. On iOS, the resolved object tells you if the action was Share.sharedAction or the user-cancelled Share.dismissedAction. On Android, it always resolves with Share.sharedAction, regardless of whether the user shared or backed out.

WHEN TO USE IT: Use this API whenever you want to enable sharing of simple text or a URL from your app. It's perfect for "Share this article," "Invite a friend," or "Post this to social media" features. It ensures a consistent user experience by using the UI that users already know and trust.

WHEN NOT TO USE IT: The Share API is for simple content. It does not support sharing local files, images, or complex data directly, though you could share a URL pointing to them. Also, do not rely on its return value for critical success tracking on Android, since it cannot distinguish a completed share from a cancellation. For sharing files, you'll need a different, more complex solution.

ONE CANONICAL EXAMPLE: To share a link, you might write an async function: const shareContent = async () => { try { await Share.share({ message: 'Check out this awesome article!', url: 'https://example.com' }); } catch (error) { console.error(error.message); } };. This function calls Share.share with a message and a URL, wrapped in a try/catch block to handle potential errors during the share process.