brave-chat

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 27 Open GitHub ↗

The ultimate slack alternative built with React, MUI, Redux, and friends.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Brave Chat

[![Demo on Cloudflare](https://badgen.net/badge/icon/cloudflare/green?icon=telegram&label=brave-chat)](https://brave-chat.net/)
[![Status](https://badgen.net/uptime-robot/status/m780862024-50db2c44c703e5c68d6b1ebb)](https://brave-chat-demo.herokuapp.com/)
[![Tag](https://badgen.net/github/tag/brave-chat/brave-chat)](https://github.com/brave-chat/brave-chat/releases/tag/v0.4.0)
[![Docs](https://badgen.net/badge/icon/docs?icon=wiki&label)](https://docs.brave-chat.wiseai.dev)
[![All Contributors](https://img.shields.io/badge/all_contributors-3-blue.svg?style=flat)](https://raw.githubusercontent.com/brave-chat/brave-chat/main/)

![Brave Chat](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/banner.PNG "Brave Chat")

Brave Chat is a fully featured chat application developed to bring the power back to people. It's designed to be the ultimate open source slack alternative with privacy in mind. It is user-friendly with a clean interface that is easy to navigate.

As well as being feature-rich, Brave Chat is also fully responsive, meaning it will work seamlessly on a wide range of devices. So whether you're chatting on your desktop or your mobile, you'll always have a great experience.

## Supported Features

- Forms validations.

![Email validation.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/input-validation.png)

![Email validation.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/password-validation.png)

- Keyboard shortcuts.

![Keyboard shortcuts.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/keyboard-shortcuts.png)

- Sending and receiving text messages in real time.

![Sending and receiving text messages.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/snd-rcv-text.gif)

- Sending and receiving images in real time.

![Sending and receiving images.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/snd-rcv-img.gif)

- Instant notifications when submitting a form.

![Joining a room notification.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/join-room-notification.png)

![add contact notification.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/add-contact-notification.png)

- Adding and removing a contact using an email address of a registered user.

![Add contact form.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/add-contact-form.png)

- Display chat list with unread messages count as a badge and timestamps.

![Custom badges, unread messages count, and timestamps.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/custom-badges.png)

- Joining and creating rooms given a room name and or description.

![Create room form.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/create-room.png)

- The ability to click on an avatar in a room to reveal detailed information about a given user.

![Room User Details.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/room-user-details.png)

- Emojies support.

![Emojies support.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/emojies.png)

- The ability to leave a room, and delete sent messages.

![Delete messages.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/delete-messages.png)

![Deleted messages.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/deleted-messages.png)

- The ability to render HTML tags, links, emails.

![HTML tags being rendered.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/bold-italic.png)

- The ability to render Markdown text.

![HTML tags being rendered.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/render-markdown.png)

- The ability to ban and unban room members.

![HTML tags being rendered.](https://raw.githubusercontent.com/brave-chat/brave-chat/main/docs/static/images/moderation.gif)

## 2023 Roadmap

- Enrypt and decrypt text messages on the client side using the signal protocol.
- Add support for voice, videos, files messages.
- Add support for voice and video calls.

## Components

Brave Chat code base is written to be developer-friendly, with code that is both standards-compliant and optimised for performance. It contains a handful list of reusable components. You can take a look at various components in [this section](https://chat-docs.wiseai.dev/folder-structure) of the docs, or expand the following collapsed section.

```sh
├── 📂 src
│
│   │
│   ├── 📂 components
│   │
│   │   ├──  📂 AddContact
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 AddRoom
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 AppTextInput
│   │   │ 
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 ChatContainer
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 ChatFooter
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 ContentHeader
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 ContentLoader
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 Conversation
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    │
│   │   │    ├── 📂 ReceivedMessageCell
│   │   │    │
│   │   │    │   ├── 📄 index.js
│   │   │    │   └── 📄 TypingMessage.js
│   │   │    │
│   │   │    ├── 📂  SentMessageCell
│   │   │    │
│   │   │    │   └── 📄 index.js
│   │   │    │
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 CustomAlert
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 CustomAvatar
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 CustomCarousel
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 CustomImage
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 CustomList
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    ├── 📄 ListEmptyResult.js
│   │   │    ├── 📄 ListFooter.js
│   │   │    ├── 📄 ListView.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 CustomPassword
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 CustomTextInput
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 DropdownMenu
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 EditInfo
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 EmojiPicker
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 GridContainer
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 Helper
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 MediaViewer
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 PageLoader
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 RoomContentHeader
│   │   │
│   │   │    └── 📄 index.js
│   │   │
│   │   ├──  📂 RoomConversation
│   │   │
│   │   │    ├── 📄 index.js
│   │   │    │
│   │   │    ├── 📂 ReceivedMessageCell
│   │   │    │
│   │   │    │   ├── 📄 index.js
│   │   │    │   └── 📄 TypingMessage.js
│   │   │    │ 
│   │   │    ├── 📂 SentMessageCell
│   │   │    │  
│   │   │    │   └── 📄 index.js
│   │   │    │
│   │   │    └── 📄 style.css
│   │   │
│   │   ├──  📂 Sidebar
│   │   │
│   │   │    ├── 📂 ChatUserCell
│   │   │    │
│   │   │    │   └── 📄 index.js
│   │   │    │
│   │   │    ├── 📂 ChatUserList
│   │   │    │ 
│   │   │    │   └── 📄 index.js
│   │   │    │
│   │   │    ├── 📂 ContactCell
│   │   │    │ 
│   │   │    │   └── 📄 index.js
│   │   │    │ 
│   │   │    ├── 📂 ContactList
│   │   │    │ 
│   │   │    │   └── 📄 index.js
│   │   │    │  
│   │   │    ├── index.js
│   │   │    │ 
│   │   │    ├── 📂 NoRecordFound
│   │   │    │ 
│   │   │    │   ├── 📄 index.js
│   │   │    │   └── 📄 style.css
│   │   │    │ 
│   │   │    ├── 📂 ProfileDetail
│   │   │    │ 
│   │   │    │   └── 📄 index.js
│   │   │    │    
│   │   │    ├── 📂 RoomCell
│   │   │    │ 
│   │   │    │   └── 📄 index.js
│   │   │    ├── 📂 RoomList
│   │   │    │ 
│   │   │    │   └── 📄 index.js
│   │   │    │ 
│   │   │    ├── 📂 SidebarHeader
│   │   │    │  
│   │   │    │   └── 📄 index.js
│   │   │    │  
│   │   │    ├── 📄 style.css
│   │   │    │ 
│   │   │    └── 📂 UserStatus
│   │   │ 
│   │   │        └── 📄 index.js
│   │   │ 
│   │   ├── 📂 SignIn
│   │   │ 
│   │   │   ├── 📄 index.js
│   │   │   └── 📄 style.css
│   │   │ 
│   │   ├── 📂 SignUp
│   │   │ 
│   │   │   └── 📄 index.js
│   │   │ 
│   │   ├── 📄 style.css
```

</details>

### Running locally with NPM

> **Note** 
Make sure you have [`pnpm`](https://pnpm.io/installation) installed on your machine.

1. Fork/Clone the repo:

```sh
	git clone git@github.com:brave-chat/brave-chat.git
	```

1. Open the newly created directory:

```sh
	cd brave-chat
	pnpm install
	```

> **Warning** 
In order to run the project locally or build for production use, you will need to set the following environment variables to connect with the server.

```sh
REACT_APP_SERVER_URL=http://localhost:8000/api/v1
REACT_APP_SOCKET_URL=ws://localhost:8000/api/v1/ws
```

1. Now, you can run the client:

```sh
	pnpm run dev
	```

1. Navigate to [http://localhost:3000](http://localhost:3000) to explore the landing page.

## Running locally with Compose v2

Navigate to [the server repository](https://github.com/brave-chat/brave-chat-server) and follow the instructions listed in [this section](https://github.com/brave-chat/brave-chat-server#running-locally-with-compose-v2) to run both the client and the server in docker containers.

## Deployment

> **Warning** 
To deploy the client, you will need to set the following environment variables that help the client connect to the server.

```sh
* REACT_APP_SERVER_URL - Your deployed server APIs url.
* REACT_APP_SOCKET_URL - Your deployed server Sockets url.
```

### **Deploy to a Static Hosting Provider**

### **CloudFlare**

1. Install [Wrangler CLI](https://developers.cloudflare.com/workers/wrangler/get-started/):

To get started with Cloudflare Workers, you'll need to install the Wrangler CLI, which is a powerful tool for managing your deployments. Open up your command-line interface and enter the following command to globally install Wrangler:

```sh
   npm install -g wrangler
   ```

1. Login to Cloudflare Account from the CLI:

To seamlessly interact with your Cloudflare account, you'll need to log in using Wrangler. Run the following command in your terminal:

```sh
   wrangler login
   ```

1. Configure Environment Variables for Client-Server Connection:

For your React app to communicate effectively with the server, you need to set a couple of environment variables. Replace the placeholders with actual URLs:

```sh
   export REACT_APP_SERVER_URL=Your_deployed_server_APIs_url
   export REACT_APP_SOCKET_URL=Your_deployed_server_Sockets_url
   ```

1. Run Your Build Command:

Before deployment, ensure your project is finely tuned. Execute your build command to prepare your app for the world:

```sh
   pnpm run build
   ```

1. Create a New Deployment:

The moment has come to launch your creation into the online realm! Execute the following command to deploy your app with Wrangler Pages:

```sh
   wrangler pages deploy dist
   ```

### **Netlify**

[![Deploy on Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/brave-chat/brave-chat)

## Documentation

You can refer to [the official documentation](https://docs.brave-chat.wiseai.dev) for additional guides, examples, and APIs.

## Contributors

<table>
 <tbody>
 <tr>
 <td align="center"><a href="https://github.com/wiseaidev"><img src="https://avatars.githubusercontent.com/u/62179149?v=4?s=100" width="100px;" alt="Mahmoud Harmouch"/> Mahmoud Harmouch</a> <a href="#maintenance-wiseaidev" title="Maintenance">🚧</a></td>
 <td align="center"><a href="https://www.linkedin.com/in/andrewkykoo/"><img src="https://avatars.githubusercontent.com/u/47183818?v=4?s=100" width="100px;" alt="Andrew Koo "/> Andrew Koo </a> <a href="https://github.com/brave-chat/brave-chat/commits?author=andrewkykoo" title="Code">💻</a></td>
 <td align="center"><a href="http://linkedin.com/in/princewill-asotibe-b31036204/"><img src="https://avatars.githubusercontent.com/u/100746581?v=4?s=100" width="100px;" alt="Princewill Asotibe"/> Princewill Asotibe</a> <a href="https://github.com/brave-chat/brave-chat/commits?author=MaverickDe" title="Code">💻</a></td>
 </tr>
 </tbody>
 <tfoot>
 <tr>
 <td align="center" size="13px" colspan="7">
 <img src="https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg">
 <a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
 </img>
 </td>
 </tr>
 </tfoot>
</table>

brave-chat

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README