https://github.com/sama-communications/sama-client

SAMA - Simple but Advanced Messaging Alternative chat client
https://github.com/sama-communications/sama-client

chat chat-application chat-server chat-server-application react websocket xmpp

Last synced: 4 months ago
JSON representation

SAMA - Simple but Advanced Messaging Alternative chat client

• Host: GitHub
• URL: https://github.com/sama-communications/sama-client
• Owner: SAMA-Communications
• License: mit
• Created: 2022-10-05T08:25:56.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-09T15:22:59.000Z (4 months ago)
• Last Synced: 2024-10-10T01:06:13.769Z (4 months ago)
• Topics: chat, chat-application, chat-server, chat-server-application, react, websocket, xmpp
• Language: JavaScript
• Homepage: https://samacloud.io
• Size: 15.9 MB
• Stars: 32
• Watchers: 3
• Forks: 2
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# SAMA - Simple but Advanced Messaging Alternative - Client app 



## Overview 

This is a frontend demo app for the SAMA server https://github.com/SAMA-Communications/sama-server

Read a complete medium post **Introducing SAMA** about what is SAMA and what problems we are trying to solve with it https://medium.com/sama-communications/introducing-sama-simple-but-advanced-messaging-alternative-chat-server-524a532e2040

## Public cloud

The whole SAMA stack can be tested using https://app.samacloud.io public cloud.

## Development

### To run Web

- Make sure you followed SAMA server Development guide first https://github.com/SAMA-Communications/sama-server/blob/main/README.md#development

- Copy `.env.example` to `.env`.

- generate VAPID keys via `npx web-push generate-vapid-keys` and set Public Key to `REACT_APP_PUBLIC_VAPID_KEY` in `.env` file

- `npm install` to install dependencies 

- `npm run start` to run server

- access http://localhost:3000 in your browser

There are also other components. Make sure to check [Deploying SAMA chat server stack: a comprehensive guide](https://medium.com/sama-communications/deploying-sama-chat-server-stack-a-comprehensive-guide-294ddb9a2d78)

### To run iOS and Android

#### Preparations

- In order to develop any application with Capacitor, you will need NodeJS 18 or higher installed

- Follow https://capacitorjs.com/docs/getting-started/environment-setup#ios-requirements guide to make sure you meet iOS requirements

- Follow https://capacitorjs.com/docs/getting-started/environment-setup#android-requirements guide to make sure you meet Android requirements

#### How to run

- Copy `.env.example` to `.env` (use `REACT_APP_SOCKET_CONNECT=wss://api.samacloud.io/` to connect to PROD live env)

- Run `npm run capacitor:build`

- To run ios: `npm run ios` or android: `npm run android`

## Community and Support

Join our community for support and discussions:

- [GitHub Issues - SAMA server](https://github.com/SAMA-Communications/sama-server/issues), [GitHub Issues - SAMA client](https://github.com/SAMA-Communications/sama-client/issues)

- [SAMA on Medium](https://medium.com/sama-communications)

- Get help - [Discord 💬](https://discord.gg/bHSm9a7DpC)

## License 

[MIT](LICENSE)

## Help us!

Any thoughts, feedback is welcome! Please create a GitHub issue for any feedback you have.

Want to support us?