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:

1. Sign up for our team site
2. Join the Native Mobile Apps channel to see what's new
3. Sign up to be a beta tester

• Android
• iOS

4. Install the Mattermost 2017 (Beta) app

• Note: Due to recent changes the new app only works with master - you can test using our team site https://pre-release.mattermost.com/

5. Check the Native Mobile Apps channel or search for #rnchangelog for an outline of the latest changes (example here)
6. File any bugs you find by posting in the Native Mobile Apps channel with:

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

Contribute Code

1. Look in GitHub issues for issues marked as [Help Wanted]
2. Comment to let people know you’re working on it
3. Follow these instructions to set up your developer environment
4. 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.