Awesome Open Source
Awesome Open Source

Version Swift 5.3




Simple Chat Interface to quick start with built-in message cells.
Fully written in pure SwiftUI.


  • [x] HTML String support like <li>, <a> (not like h1 or font based tag)
  • [x] Attributed string support that contains address, date, phoneNumber, url (text is automatically scanned)
  • [x] Landscape orientation support (autoscales message cells with the given cellWidth property, if exists)
  • [x] User Avatar (with different position options, optional usage)
  • [x] Dismiss keyboard (on tapping outside).
  • [x] Multiline Input Bar added (investigate BasicInputView)
  • [x] Scroll to bottom for iOS14 (use proper init).
  • [ ] Scroll to bottom for iOS13.
  • [ ] Swipe to dismiss keyboard.

Quick Preview

Basic Example Preview
Text (Light) Text (Dark)
Advanced Example Preview
Contact, QuickReply, Text, Carousel Map, Image ContextMenu



Message Kinds

public enum ChatMessageKind {
    /// A text message,
    /// supports emoji 👍🏻 (auto scales if text is all about emojis)
    case text(String)
    /// An image message, from local(UIImage) or remote(URL).
    case image(ImageLoadingKind)
    /// A location message, pins given location & presents on MapKit.
    case location(LocationItem)
    /// A contact message, generally for sharing purpose.
    case contact(ContactItem)
    /// Multiple options, disables itself after selection.
    case quickReply([QuickReplyItem])
    /// `CarouselItem`s that contains title, subtitle, image & button in a scrollable view
    case carousel([CarouselItem])
    /// A video message, opens the given URL.
    case video(VideoItem)


  • ChatView

Here below is minimum code required to get started (see up & running)
For detail, visit example project here

@State var messages: [MockMessages.ChatMessageItem] = [] // for quick test assign MockMessages.generatedMessages()

// ChatMessageItem & ChatUserItem is a sample objects/structs 
// that conforms `ChatMessage` & `ChatUser` protocols.
ChatView<MockMessages.ChatMessageItem, MockMessages.ChatUserItem> {
    // InputView here, continue reading..
// ▼ Required
    // All parameters initialized by default, 
    // change as you want.
  • InputView

You can investigate existing BasicInputView in project.
You can use it if it suits your need, or create a new one.
Recommended way is just clone this BasicInputView and modify (ex. add camera icon etc.)

// InputBarView variables
@State private var message = ""
@State private var isEditing = false

var inputBarView: some View {
        message: $message, // Typed text.
        isEditing: $isEditing,
        placeholder: "Type something",
        onCommit: { messageKind in
                .init(user: MockMessages.sender, messageKind: messageKind, isSender: true)
    .padding(.bottom, isEditing ? 0 : 8)
    // ▼ An extension that wraps view inside AnyView

// Pass in ChatView
ChatView(messages: $messages) {

Style and Customization

public class ChatMessageCellStyle: ObservableObject {
    let incomingTextStyle: TextCellStyle
    let outgoingTextStyle: TextCellStyle
    let incomingCellEdgeInsets: EdgeInsets
    let outgoingCellEdgeInsets: EdgeInsets
    let contactCellStyle: ContactCellStyle
    let imageCellStyle: ImageCellStyle
    let quickReplyCellStyle: QuickReplyCellStyle
    let carouselCellStyle: CarouselCellStyle
    let locationCellStyle: LocationCellStyle
    let incomingAvatarStyle: AvatarStyle
    let outgoingAvatarStyle: AvatarStyle

You must initiate this class to build a proper style & inject it as environmentObject,
All styles has default initializer;

For detail documentation, visit

Please feel free to contribute.
* Create PR for a feature/bug you'd like to add/fix.



Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
swift (7,541
ios (3,492
chat (373
chatbot (289
swiftui (247
messaging (207
chat-application (61
message (54
chatroom (28
chatbot-framework (27

Find Open Source By Browsing 7,000 Topics Across 59 Categories