react-chat-engine-components
v0.1.3
Published
<p align="center" > <p align="center" > <a href="https://chatengine.io/"> <img alt="react-chat-engine" style='max-height: 333px; max-width: 100%;' src="https://chat-engine-assets
Downloads
7
Readme
Chat Engine
Chat Engine is a devevloper friendly Chat UI Kit.
Setup a free plan at chatengine.io
Features
- Typescript (since 2.0.0)
- Sign Up / Authentication
- Setup chats
- Send messages
- Send files and photos
- Subscribe to Chats via Sockets
- Invite / Remove chat members
- Endless Chat scrolling
- Endless Message scrolling
Installation
Quick Start
Add serverless chat to your React app in 3 minutes.
Register then create a project and user at chatengine.io
Collect the Project ID / myUsername / User Secret
Install
yarn add react-chat-engine
Import the
ChatEngine
component and pass inprojectId
,myUsername
, andmySecret
propsVoila! You're done
Example implementation ⬇️
import React from 'react';
import { ChatEngine } from 'react-chat-engine';
export function App() {
return (
<ChatEngine
projectId="b75e5bd5-cd84-404c-b820-06feff8c98c0"
myUsername="john_smith"
mySecret="secret_1234"
/>
);
}
Props
projectId
(String REQUIRED) - Public API key for your chatengine.io projectmyUsername
(String REQUIRED) - myUsername of a person in this projectmySecret
(String REQUIRED) - Set a secret for this person and use it to authenticate.onConnect
(Function) - Callback when the connection/authentication is completeonFailAuth
(Function) - Callback when the connection/authentication failsonGetChats
(Function) Callback when the person fetches their chats arrayonNewChat
(Function) - Callback when the person creates a new chatonEditChat
(Function) - Callback when the person edits a chat titleonDeleteChat
(Function) - Callback when the person deletes one of their chats (must the chat's admin)onAddPerson
(Function) - Callback when a person is added to a chatonRemovePerson
(Function) - Callback when a person is removed/deleted from a chatonGetMessages
(Function) - Callback when the person gets a chat's messagesonNewMessage
(Function) - Callback when a person posts a new message in one of the chatsonEditMessage
(Function) - Callback when a person edits a new message in one of the chatsonDeleteMessage
(Function) - Callback when a person deletes a new message in one of the chatshideUI
(Boolean) - Hides all UI components for a custom implementation (Warning: Advanced)