|
1 | | -<div style="width:100%"> |
2 | | - <div style="width:50%;"> |
3 | | - <div align="center"> |
4 | | - <img align="center" width="180" height="180" alt="CometChat" src="./Screenshots/logo.png"> |
5 | | - </div> |
6 | | - </div> |
7 | | -</div> |
8 | | - |
9 | | -</br></br> |
10 | | - |
11 | | -> **Note** |
12 | | -
|
13 | | -Version 4 CometChat UI Kits |
14 | | - |
15 | | -We’ve introduced a major update to CometChat UI kits. Version 4 features a modular architecture that gives you enhanced flexibility to build and customize your web and mobile apps. Please switch to the branch [v4](https://github.com/cometchat-pro/cometchat-chat-sample-app-react/tree/v4) to check out the sample app based on this version. [Visit our documentation](https://www.cometchat.com/docs/react-v4-uikit/overview) to read more about this. |
16 | | -<br/><br/> |
17 | | - |
18 | | -# CometChat Kitchen Sink Sample App (React) |
19 | | - |
20 | | -<p align="left"> |
21 | | - <a href="https://github.com/cometchat-pro/cometchat-pro-react-sample-app/releases/" alt="Releases"> |
22 | | - <img src="https://img.shields.io/github/v/release/cometchat-pro/cometchat-pro-react-sample-app" /> |
23 | | - </a> |
24 | | - <a href="https://img.shields.io/github/languages/top/cometchat-pro/cometchat-pro-react-sample-app"> |
25 | | - <img src="https://img.shields.io/github/languages/top/cometchat-pro/cometchat-pro-react-sample-app" /> |
26 | | - </a> |
27 | | - <a href="https://github.com/cometchat-pro/cometchat-pro-react-sample-app/stargazers"> |
28 | | - <img src="https://img.shields.io/github/stars/cometchat-pro/cometchat-pro-react-sample-app?style=social" /> |
29 | | - </a> |
30 | | - <a href="https://twitter.com/CometChat"> |
31 | | - <img src="https://img.shields.io/twitter/follow/CometChat?label=CometChat&style=social" /> |
32 | | - </a> |
| 1 | +<!-- PROJECT LOGO --> |
| 2 | +<div> |
| 3 | + <img alt="CometChat" src="https://avatars2.githubusercontent.com/u/45484907?s=200&v=4" width="180" height="180" alt="CometChat" /> |
| 4 | +</div> |
| 5 | +<h2>CometChat React Sample App</h3> |
| 6 | +<p> |
| 7 | + CometChat Kitchen Sink Sample App (built using <b>CometChat UI Kits</b>) is a fully functional real-time messaging app capable of private (one-on-one), group messaging, voice & video calling. |
| 8 | + <br /> |
| 9 | + <a href="https://www.cometchat.com/docs/v4/react-uikit/overview"><strong>Explore the docs »</strong></a> |
| 10 | + <br /> |
| 11 | + <br /> |
| 12 | + <a href="https://github.com/cometchat-pro/cometchat-chat-sample-app-react/issues">Report Bug</a> |
33 | 13 | </p> |
34 | 14 |
|
35 | | - |
| 15 | +## |
| 16 | + |
| 17 | +[](#) [](#) |
| 18 | +[](#) |
| 19 | +<a href="https://github.com/cometchat-pro/cometchat-chat-sample-app-react/releases/" alt="Releases"> |
| 20 | +<img src="https://img.shields.io/github/v/release/cometchat-pro/cometchat-chat-sample-app-react?label=Release&color=brightgreen" /> |
| 21 | +</a> |
| 22 | +<a href="https://github.com/cometchat-pro/javascript-react-chat-ui-kit/stargazers"> |
| 23 | +<img src="https://img.shields.io/github/stars/cometchat-pro/javascript-react-chat-ui-kit?style=social" /> |
| 24 | +</a> |
| 25 | +<a href="https://twitter.com/CometChat"> |
| 26 | +<img src="https://img.shields.io/twitter/follow/CometChat?label=CometChat&style=social" /> |
| 27 | +</a> |
| 28 | + |
| 29 | +<!-- TABLE OF CONTENTS --> |
| 30 | + |
| 31 | +## Table of Contents |
| 32 | + |
| 33 | +- [About the Project](#about-the-project) |
| 34 | + - [Built With](#built-with) |
| 35 | +- [Getting Started](#getting-started) |
| 36 | + - [Dependencies](#dependencies) |
| 37 | + - [Installing](#installing) |
| 38 | + - [Usage](#usage) |
| 39 | + - [Run locally](#run-project-locally) |
| 40 | + - [Help](#help) |
| 41 | +- [Contributing](#contributing) |
| 42 | +- [Support](#support) |
| 43 | +- [License](#license) |
| 44 | +- [About Authors](#about-authors) |
| 45 | + |
| 46 | +<!-- ABOUT THE PROJECT --> |
| 47 | + |
| 48 | +## About The Project |
36 | 49 |
|
37 | 50 | CometChat Kitchen Sink Sample App (built using **CometChat UI Kit**) is a fully functional real-time messaging app capable of private (one-on-one), group messaging, voice & video calling. |
38 | 51 |
|
39 | | -## Features |
40 | | -- Login |
41 | | -- Private(1-1) & Group Conversations |
42 | | -- Voice & video calling & conferencing |
43 | | -- Rich Media Attachments |
44 | | -- Typing Indicators |
45 | | -- Text, Media and Custom messages |
46 | | -- Read receipts |
47 | | -- Online Presence Indicators |
48 | | -- Message History |
49 | | -- Users & Friends List |
50 | | -- Groups List |
51 | | -- Search by users and groups |
52 | | -- Conversations List |
53 | | -- Threaded Conversations |
| 52 | +### Built With |
54 | 53 |
|
55 | | - ## Extensions |
| 54 | +- [React](https://react.dev) |
| 55 | +- [CometChat](https://cometchat.com) |
56 | 56 |
|
57 | | - [Thumbnail Generation](https://www.cometchat.com/docs/extensions/thumbnail-generation) | [Link Preview](https://www.cometchat.com/docs/extensions/link-preview) | [Rich Media Preview](https://www.cometchat.com/docs/extensions/rich-media-preview) | [Smart Replies](https://www.cometchat.com/docs/extensions/smart-replies)| [Emojis](https://www.cometchat.com/docs/extensions/emojis) | [Polls](https://www.cometchat.com/docs/extensions/polls) | [Reactions](https://www.cometchat.com/docs/extensions/reactions) | [Stickers](https://www.cometchat.com/docs/extensions/stickers) |
| 57 | +<!-- GETTING STARTED --> |
58 | 58 |
|
59 | | -<hr/> |
| 59 | +## Getting Started |
60 | 60 |
|
61 | | -## Prerequisites |
| 61 | +Simply clone or fork this repo and run it using the instructions below to see all features in action. Or use it as a starter template/boilerplate and make edits to suit your needs. |
62 | 62 |
|
63 | | -Before you begin, ensure you have met the following requirements: |
| 63 | +## Dependencies |
64 | 64 |
|
65 | | -- React `npm install react@17.0.2` |
| 65 | +- CometChat - [Sign up for CometChat](https://app.cometchat.com) and create an app to obtain your keys and other credentials |
66 | 66 |
|
67 | | -- React DOM `npm install react-dom@17.0.2` |
| 67 | +- npm |
68 | 68 |
|
69 | | -- React scripts `npm install react-scripts@4.0.3` |
| 69 | + ```sh |
| 70 | + npm install npm@latest -g |
| 71 | + ``` |
70 | 72 |
|
71 | | -___ |
| 73 | +## Installing |
72 | 74 |
|
73 | | -## Installing React Sample App |
| 75 | +1. Clone the repo |
74 | 76 |
|
75 | | -1. Clone this repository `git clone https://github.com/cometchat-pro/javascript-react-chat-app.git` |
76 | | -2. Navigate to the root directory and replace `APP_ID`, `REGION` and `AUTH_KEY` with your CometChat `App ID`, `Region` and `Auth Key` in src/consts.js file. |
| 77 | + ```sh |
| 78 | + git clone https://github.com/cometchat-pro/cometchat-chat-sample-app-react.git -b v4 |
| 79 | + ``` |
77 | 80 |
|
78 | | - |
| 81 | +2. Change to the working directory |
79 | 82 |
|
80 | | -3. Install dependencies |
| 83 | + ```sh |
| 84 | + cd cometchat-chat-sample-app-react |
| 85 | + ``` |
81 | 86 |
|
82 | | - a. Add node-sass dependency in your project. |
83 | | - ```javascript |
84 | | - npm install node-sass@version |
85 | | - ``` |
86 | | - <b> Note</b>: Cross check for the compatible version of this dependency with your system's node version in the link given below <br /> |
87 | | - <a href="https://www.npmjs.com/package/node-sass">https://www.npmjs.com/package/node-sass</a> |
| 87 | +3. Install dependencies via NPM |
88 | 88 |
|
89 | | - b. |
| 89 | + ```sh |
| 90 | + npm install |
| 91 | + ``` |
90 | 92 |
|
91 | | - ```javascript |
92 | | - npm install |
93 | | - ``` |
94 | | -___ |
| 93 | +4. Replace `APP_ID`, `REGION` and `AUTH_KEY` with your CometChat `App ID`, `Region` and `Auth Key` in `src/constants.ts` file. |
95 | 94 |
|
96 | | -## Running the sample app |
| 95 | +  |
97 | 96 |
|
98 | | -```javascript |
99 | | - npm start |
| 97 | +<!-- USAGE EXAMPLES --> |
| 98 | + |
| 99 | +## Usage |
| 100 | + |
| 101 | +This app contains all features offered by CometChat through its UI Kit. [Read more about the React UI Kit here.](https://www.cometchat.com/docs/v4/react-uikit/overview) |
| 102 | + |
| 103 | +### Run project locally |
| 104 | + |
| 105 | +```sh |
| 106 | +npm start |
100 | 107 | ``` |
101 | | -___ |
102 | 108 |
|
103 | | -## Add UI Kit to your project |
| 109 | +To learn about React UI Kit Integration, please [click here](https://www.cometchat.com/docs/v4/react-uikit/integration). |
104 | 110 |
|
105 | | -Learn more about how to integrate [UI Kit](https://github.com/cometchat-pro/cometchat-chat-uikit-react/) inside your app. |
| 111 | +## Help |
106 | 112 |
|
107 | | ---- |
| 113 | +To learn more about our UI kits, visit our [documentation](https://www.cometchat.com/docs/v4/react-uikit/overview). |
108 | 114 |
|
109 | | -# Troubleshooting |
| 115 | +If you are still facing issues while running this project or integrating with our UI Kits, please connect with our real time support via the [CometChat Dashboard](https://app.cometchat.com/). |
110 | 116 |
|
111 | | -- To read the full dcoumentation on UI Kit integration visit our [Documentation](https://www.cometchat.com/docs/react-chat-ui-kit/overview). |
| 117 | +<!-- CONTRIBUTING --> |
112 | 118 |
|
113 | | -- Facing any issues while integrating or installing the UI Kit please connect with us via real time support present in <a href="https://app.cometchat.com/">CometChat Dashboard.</a> |
| 119 | +## Contributing |
114 | 120 |
|
115 | | ---- |
116 | | -# Contributors |
| 121 | +Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. Sincere thanks to all our [contributors](https://github.com/cometchat-pro/cometchat-chat-sample-app-react/graphs/contributors)! |
117 | 122 |
|
118 | | -Thanks to the following people who have contributed to this project: |
| 123 | +You are requested to follow the contribution guidelines specified in [CONTRIBUTING.md](./CONTRIBUTING.md) while contributing to the project :smile:. |
119 | 124 |
|
120 | | -[@priyadarshininadar](https://github.com/priyadarshininadar) <br> |
121 | | -[@ajaygajra](https://github.com/ajaygajra) <br> |
122 | | -[@prathamesh-majgaonkar](https://github.com/prathamesh-majgaonkar) <br> |
123 | | -[@mayur-bhandari](https://github.com/mayur-bhandari) |
| 125 | +## Support |
124 | 126 |
|
| 127 | +Please connect with our real time support via the [CometChat Dashboard](https://app.cometchat.com/). |
125 | 128 |
|
126 | | ---- |
| 129 | +<!-- LICENSE --> |
127 | 130 |
|
128 | | -# Contact |
| 131 | +## License |
129 | 132 |
|
130 | | -Contact us via real time support present in [CometChat Dashboard.](https://app.cometchat.com/) |
| 133 | +This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details. |
131 | 134 |
|
132 | | ---- |
| 135 | +## About Authors |
133 | 136 |
|
134 | | -# License |
| 137 | +This project is created & maintained by: <br/> |
| 138 | +[⚔️ @priyadarshininadar](https://github.com/priyadarshininadar) 🛡 <br> |
| 139 | +[⚔️ @juhi-saha](https://github.com/juhi-saha) 🛡 <br> |
| 140 | +[⚔️ @raj-dubey](https://github.com/raj-dubey1) 🛡 |
135 | 141 |
|
136 | | ---- |
| 142 | +The names and logos for CometChat are trademarks of CometChat, Inc. |
137 | 143 |
|
138 | | -This project uses the following [license](https://github.com/cometchat-pro/javascript-react-chat-app/blob/master/LICENSE). |
| 144 | +We love open source software! See [our other projects](https://github.com/cometchat-pro) or [sign up with us](https://app.cometchat.com/signup) to start using our product. |
0 commit comments