Mattermost Mobile (unreleased)

Supported Server Versions: Master (no released versions are currently supported)

This is an unreleased project for replacing the Mattermost iOS and Android apps with new mobile apps using React Native and Redux. The project is not yet stable, and the instructions are for internal use currently (i.e. probably out-of-date until we stablize).

We'll post updates to our Forums and Twitter when we're ready to bring in more community contributors.

Our early roadmap was discussed on the Mattermost forums in October 2016 and we'll have more updates as the project evolves. Priorities are shifting so please only use the dates in the post as a highly approximate guide.

Mattermost is an open source Slack-alternative used by thousands of companies around the world in 11 languages. Learn more at https://mattermost.com.

How to Contribute

Testing

The apps are currently under development with a beta release planned for March. We cut a new build every Monday, so people can test it out and see what's new.

If you would like to help with testing the apps, you can:

(Optional) Sign up for our team site

Join the Native Mobile Apps channel to see what's new and discuss feedback with the contributors and the core team

Android
iOS

Install the Mattermost 2017 (Beta) app

Note: The app only works with server version 3.7+, you can test using our team site https://pre-release.mattermost.com/

Check the changelog for what's currently supported
File any bugs you find by filing a GitHub issue with:

Device information
Repro steps
Observed behavior (including screenshot / video when possible)
Expected behavior

Contribute Code

Look in GitHub issues for issues marked as [Help Wanted]
Comment to let people know you’re working on it
Follow these instructions to set up your developer environment
Join the Native Mobile Apps channel on our team site to ask questions

Installing Dependencies

Follow the React Native Getting Started Guide for detailed instructions on setting up your local machine for development.

Detailed configuration:

Mac

General requirements
- XCode 8.1
- Install watchman $ brew install watchman

Clone repository and configure:

$ git clone git@github.com:mattermost/mattermost-mobile.git
$ cd mattermost-mobile
$ npm install
$ npm install -g react-native-cli

Run application
```
$ make run
```
Stop the packager server
```
$ make stop
```

Linux:

General requiriments:
- JDK 7 or greater
- Android SDK
- Virtualbox
- An Android emulator: Genymotion or Android emulator. If using genymotion ensure that it uses existing adb tools (Settings: "Use custom Android SDK Tools")
- Install watchman (do this globally):
```
$ git clone https://github.com/facebook/watchman.git
$ cd watchman
$ git checkout master
$ ./autogen.sh
$ ./configure make
$ sudo make install
```
  Configure your kernel to accept a lot of file watches, using a command like:
```
$ sudo sysctl -w fs.inotify.max_user_watches=1048576
```
Clone repository and configure:
```
$ git clone git@github.com:mattermost/mattermost-mobile.git
$ cd mattermost-mobile
$ npm install
$ npm install -g react-native-cli
```
- Add or edit file src/config/config.secret.json and add the url to the Mattermost server that you will use to develop: { "DefaultServerUrl": "https://pre-release.mattermost.com" }
  
  To use a local Mattermost server you will need to configure the "DefaultServerUrl" depending on the emulator you will use:
  - IOs: "DefaultServerUrl": "http://localhost:8065"
  - Android: "DefaultServerUrl": "http://10.0.2.2:3000"
  - Genymotion: "DefaultServerUrl": "http://10.0.3.2:8065"
Run application
- Start emulator
- Start react packager: $ react-native start
- Run in emulator: $ react-native run-android

Frequently Asked Questions

How is data handled on mobile devices after a user account is deactivated?

App data is wiped from the device when a user logs out of the app. If the user is logged in when the account is deactivated, then within one minute the system logs the user out, and as a result all app data is wiped from the device.

simcha / mattermost-mobile