react-native-gifted-chat

<p align="center">
  <a href="https://www.npmjs.com/package/react-native-gifted-chat"><img alt="npm version" src="https://badge.fury.io/js/react-native-gifted-chat.svg"/></a>
  <a href="https://www.npmjs.com/package/react-native-gifted-chat"><img alt="npm downloads" src="https://img.shields.io/npm/dm/react-native-gifted-chat.svg"/></a>
  <a href="https://circleci.com/gh/FaridSafi/react-native-gifted-chat"><img src="https://circleci.com/gh/FaridSafi/react-native-gifted-chat.svg?style=shield" alt="build"></a>
  <img src="https://img.shields.io/badge/platforms-iOS%20%7C%20Android%20%7C%20Web-lightgrey.svg" alt="platforms">
  <img src="https://img.shields.io/badge/TypeScript-supported-blue.svg" alt="TypeScript">
  <img src="https://img.shields.io/badge/Expo-compatible-000020.svg" alt="Expo compatible">
</p>

<h1 align="center">React Native Gifted Chat</h1>

<p align="center">
  The most complete chat UI for React Native & Web
</p>

<p align="center">
  <a href="https://snack.expo.dev/@kesha-antonov/gifted-chat-playground" target="_blank">
    <img src="https://img.shields.io/badge/▶️_Try_in_Browser-4630EB?style=for-the-badge&logo=expo&logoColor=white" alt="Try GiftedChat on Expo Snack"/>
  </a>
</p>

> [!NOTE]
> **Active development has moved.** This package is now in maintenance mode and isn't receiving new features. Development continues - including streaming AI messages and the latest fixes - in a maintained fork: **[@kesha-antonov/react-native-chat](https://github.com/kesha-antonov/react-native-chat)**. New projects are encouraged to use it; migrating is mostly a rename ([migration guide with a codemod](https://github.com/kesha-antonov/react-native-chat/blob/main/docs/MIGRATION.md)).
>
> In development builds, `GiftedChat` logs this notice once per session (never in production). To hide it, call `disableMaintenanceNotice()` (exported from `react-native-gifted-chat`) before the first render.

---

## ✨ Features

- 🎨 **[Fully Customizable](#-props-reference)** - Override any component with your own implementation
- 📎 **[Composer Actions](#actions--action-sheet)** - Attach photos, files, or trigger custom actions
- ↩️ **[Reply to Messages](#reply-to-messages)** - Swipe-to-reply with reply preview and message threading
- ⏮️ **[Load Earlier Messages](#load-earlier-messages)** - Infinite scroll with pagination support
- 📋 **[Copy to Clipboard](#copy-to-clipboard)** - Long-press messages to copy text
- 🔗 **[Smart Link Parsing](#smart-link-parsing)** - Auto-detect URLs, emails, phone numbers, hashtags, mentions
- 👤 **[Avatars](#avatars)** - User initials or custom avatar images
- 🌍 **[Localized Dates](#date--time)** - Full i18n support via Day.js
- ⌨️ **[Keyboard Handling](#keyboard--layout)** - Smart keyboard avoidance for all platforms
- 💬 **[System Messages](#system-messages)** - Display system notifications in chat
- ⚡ **[Quick Replies](#quick-replies)** - Bot-style quick reply buttons
- 😀 **[Emoji Reactions](#emoji-reactions)** - Long-press to react