README.md

MAS server and web app

MAS is a web group chat application with a sleek windowed UI.

NOTE: The project is archived. Can't be recommended for any kind of general use.

For more info, see

• Architecture page
• MAS client API

Main features

• Next generation windowed UI
• Messages can include mentions, links, emojis, markdown, images, and youtube videos
• Opt-in email alerts of missed messages
• Infinite scrolling to see older messages
• Another view to browse messages by group and date
• Contacts list with precense information
• Support for 1on1s, local groups and IRC channels (IRC backend implements RFC 2812)
• IRC connections are kept active also when the user is not logged in
• Separate mobile mode

Status

TBD

Dependencies

• Node.js: http://nodejs.org/
• Yarn: https://yarnpkg.com/
• Redis: http://redis.io/
• Elasticsearch: https://www.elastic.co/products/elasticsearch/ (optional)

Development setup on Mac

1. Install Redis, yarn, and latest release of node.js (version 7.6 or later is required)

   On Mac you can do this by installing first Homebrew and then

   $ brew install node yarn redis

2. Build different components and install required npm modules using the dev script

   $ ./dev.sh build

3. Launch the server components and redis in foreground

   $ ./dev.sh start

4. Run the frontend

   $ cd new-client
   $ yarn run dev

Production like setup

$ docker-compose up -d

When everything is running, navigate to http://localhost/. MAS frontend server is listening on port 80 on all interfaces.

Docker compose will create three data volumes. One of the is for the frontend server. Frontend server needs it to store uploaded files. Also if HTTPS is enabled, one option is to place the certs to this volume. In that case it's simplest to use a volume that is mounted from the host.

Feedback

[email protected]