/Mattermost-iOS

Native Mattermost iOS application

Primary LanguageObjective-CApache License 2.0Apache-2.0

Build Status

Mattermost iOS Native Application

This is fully native Mattermost iOS application written in pure Obj-C.

Note The iOS app is not an official and made by enthusiasts. So any backend changes might take some time to be implemented in the app. But no worries. We use the app for own needs so an update will be not long in coming.

iOS application for use with Mattermost server 3.0 and higher (http://www.mattermost.org/download/)

Supported Platforms

  • iOS 8.1+ iPhone and iPod Touch devices (iPad is coming soon)

Requirements for Deployment

  1. Understanding of Mattermost push notifications.
  2. Experience compiling and deploying iOS applications either to iTunes or an Enterprise App Store
  3. An Apple Developer account and appropriate Apple devices to compiled, test and deploy the application
  4. Cocoapods & Carthage installed

Installation

  1. Install Mattermost 3.0 or higher.
  2. Change the app bundle id to your own.
  3. Run pod install in the project's root directory. This will fetch Cocoapods dependencies. If CocoaPods is not already available it could be installed by:
$ [sudo] gem install cocoapods
  1. Run carthage update --platform iOS. This will fetch Carthage dependencies. If Carthage is not already available it could be installed using this tutorial
  2. Compile and deploy this iOS application to your Enterprise AppStore or publicly.
  3. Install the latest stable release of the Mattermost Push Notifications Server using the private and public keys generated for your iOS application from step 2.
  4. In the Mattermost Platform Server go to System Console > Email Settings > Push Notifications Server and add the web address of the Mattermost Push Notifications Server. Set System Console > Send Push Notifications to true.
  5. On your iOS device, download and install your app and enter the Team URL and credentials based on a team set up on your Mattermost Platform Server

Beta Alert

Mind that the application is in beta state. A lot of bugs and lack on functionality may be faced. If you find any obstacle while using our app feel free to open a ticket.

Completed

  • Markdown
  • Emoji
  • Chat history
  • Commands
  • Outgoing indicator
  • Failure incicator

Roadmap

  • Joining new channels
  • Channels settings
  • Deleting messages
  • Editing messages
  • Replying to messages
  • Fixing bugs
  • Swift migration

Frameworks and Instruments

License

The app is under Apache Lisense, version 2.0