No description
Find a file
Christopher Speller 6000e69886
Agents "RHS" view (#9318)
* Add agents RHS functionality for mobile

Implements a dedicated agents interface accessible from the home screen, featuring:
- Agent chat screen with bot selector and message input
- Thread list screen showing all agent conversations
- Remote actions for fetching bots and threads from plugin API
- Navigation between chat, threads, and individual conversations
- Integration with plus menu for easy access

Follows similar pattern to playbooks with modal screens and navigation helpers.

* Fix icon name for agents menu item

Change robot-happy-outline to robot-happy to resolve PropType validation error.

* Add agents button to sidebar and fix agent chat issues

- Add AgentsButton component to channel list sidebar below Drafts
- Fix thread navigation to use fetchAndSwitchToThread instead of switchToChannelById
- Replace custom TextInput with PostDraft component in agent_chat
- Fix icon name from message-reply-text-outline to reply-outline
- Add missing i18n translations for agents UI

* Implement automatic navigation to thread after sending agent message

* Implement bot selector bottom sheet with avatars. Replace click-and-cycle behavior with a proper bottom sheet menu showing all available agents with their profile pictures. Add bot avatar display to the dropdown button for better visual identification.

* Top bar design modifications.

* Add intro graphic and text

* Fix autocomplete not working

* Tweak styles and icons.

* Remove unused

* Add version/enabled check

* Remove excessive agent button

* Style fixes

* Use non-blocking then() for onPostCreated callback in send message hook

* Add unit tests for agents product components and actions

* Review feedback, offline support

* I18n

* Tests

* Address PR review feedback: deletion handling, UI fixes, schema docs

* Remove unnecessary deleteNotPresent flag from agents handlers

* Fix agents archived channel, empty data guard, and stale relative time

* Add smoke test for AgentChat and extend ToolCard test coverage

* Fix test quality issues: remove useless tests, strengthen assertions

* Address PR review: remove barrel file, add version comment

* Mock reanimated in CitationsList test to fix CI failure

* Fix CitationsList tests after always-mounted animation change

* Address PR review: typography, Pressable, FormattedText, schema bump, and cleanup

* Apply CLAUDE.md patterns across agents codebase: Pressable, typography, FormattedText, logDebug

* Fix schema test to expect version 19
2026-03-16 09:48:32 -07:00
.github workflows: fix bucket names (#9566) 2026-03-04 11:18:26 +01:00
.husky Push react native to 0.73.6 (#7863) 2024-04-22 12:44:39 +02:00
android Bump app build number to 730 (#9590) 2026-03-13 11:25:09 +02:00
app Agents "RHS" view (#9318) 2026-03-16 09:48:32 -07:00
assets Agents "RHS" view (#9318) 2026-03-16 09:48:32 -07:00
build/notice-file Add "APNG4Android" to ignoreDependencies in config.yaml (#8741) 2025-04-02 09:34:25 +03:00
detox Add two-phase tool call approval for agents in channels (#9506) 2026-02-19 11:20:25 -05:00
docs Agents "RHS" view (#9318) 2026-03-16 09:48:32 -07:00
eslint Refactor gallery gestures (#8752) 2025-07-22 14:00:57 +08:00
fastlane e2e: don't upload artifacts to s3 in e2e pipeline (#9546) 2026-02-25 14:48:31 -05:00
ios Bump app build number to 730 (#9590) 2026-03-13 11:25:09 +02:00
libraries/@mattermost fix(MM-67224): MM Mobile v2.36.0 crash on iOS 16 and below (#9421) 2026-01-19 16:45:56 -07:00
patches feat(MM-65147): upgrade to react-native 0.77.3 (#9253) 2025-12-22 07:35:38 -07:00
scripts Fix Android image loads by attaching auth headers (#9554) 2026-02-26 21:36:03 -05:00
share_extension Enable exhaustive deps in the repo (#9508) 2026-02-18 11:56:16 +01:00
test Database changes for autotranslations (#9495) 2026-02-10 15:04:35 +01:00
types Add autotranslations to permalink previews (#9540) 2026-03-05 12:47:18 +01:00
.buckconfig Barebones code for v2 2020-11-17 14:20:58 -03:00
.editorconfig MM-35115 [Gekidou] Login flow - Email and Password (#5402) 2021-06-18 00:57:40 -04:00
.flowconfig [Gekidou] Upgrade to RN 0.70 (#6690) 2022-10-20 10:18:25 -03:00
.gitattributes Update v2 dependencies (#5312) 2021-04-14 10:55:29 -04:00
.gitignore feat(iOS): Add Microsoft Intune MAM integration with multi-server support (#9312) 2025-12-10 13:07:28 +02:00
.gitmodules feat(iOS): Add Microsoft Intune MAM integration with multi-server support (#9312) 2025-12-10 13:07:28 +02:00
.node-version chore(deps-dev): allow devs to use Node.js 22 (LTS) (#8657) 2025-03-24 16:28:11 -06:00
.npmrc MM-54535 Fixed hang when using the magic keyboard on iPadOS 17 (#7555) 2023-09-27 18:54:33 +03:00
.nvmrc chore(deps-dev): allow devs to use Node.js 22 (LTS) (#8657) 2025-03-24 16:28:11 -06:00
.ruby-version bump Ruby verison (#8315) 2024-11-07 12:34:24 -04:00
.solidarity Update dependencies and upgrade to RN 0.76.5 (#8421) 2025-01-16 07:11:32 -07:00
.watchmanconfig Barebones code for v2 2020-11-17 14:20:58 -03:00
app.json Barebones code for v2 2020-11-17 14:20:58 -03:00
babel.config.js Agents posts on mobile (#9317) 2025-12-09 03:56:12 -08:00
CHANGELOG.md Barebones code for v2 2020-11-17 14:20:58 -03:00
CLAUDE-IOS-SIMULATOR.md [MM-66591] Channel Summaries with Agents (#9405) 2026-02-13 07:00:43 -05:00
CLAUDE.md Agents "RHS" view (#9318) 2026-03-16 09:48:32 -07:00
CONTRIBUTING.md Barebones code for v2 2020-11-17 14:20:58 -03:00
env.d.ts E2E feature schedule posts (#8709) 2025-04-23 12:10:37 +05:30
eslint.config.mjs Enable exhaustive deps in the repo (#9508) 2026-02-18 11:56:16 +01:00
Gemfile pin rexml to >=3.4.2 (#9533) 2026-03-11 10:52:43 +01:00
Gemfile.lock pin rexml to >=3.4.2 (#9533) 2026-03-11 10:52:43 +01:00
index.ts Add autotranslations (#9324) 2026-02-10 17:50:39 +01:00
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md (#7080) 2023-02-03 08:55:40 -05:00
jest.config.js feat(iOS): Add Microsoft Intune MAM integration with multi-server support (#9312) 2025-12-10 13:07:28 +02:00
jsconfig.json Secure Files and preview PDF inline (#8844) 2025-06-19 15:30:56 +08:00
LICENSE.txt Barebones code for v2 2020-11-17 14:20:58 -03:00
metro.config.js Upgrade RN as well as update or replace other dependencies (#8011) 2024-06-19 09:33:45 +08:00
NOTICE.txt chore: Update NOTICE.txt file with updated dependencies (#9513) 2026-02-16 12:43:21 +02:00
package-lock.json feat: AI rewrite (#9280) 2026-02-16 16:48:57 +01:00
package.json Bump app build and version number (#9501) 2026-02-11 09:55:31 +02:00
PULL_REQUEST_TEMPLATE.md Barebones code for v2 2020-11-17 14:20:58 -03:00
react-native.config.js Update v2 dependencies (#5312) 2021-04-14 10:55:29 -04:00
README.md Update README.md (#9443) 2026-01-21 08:08:41 +02:00
SECURITY.md Barebones code for v2 2020-11-17 14:20:58 -03:00
tsconfig.json Agents posts on mobile (#9317) 2025-12-09 03:56:12 -08:00
tsconfig.test.json Barebones code for v2 2020-11-17 14:20:58 -03:00

Mattermost Mobile v2

  • Minimum Server versions: Current ESR version (10.11.0+)
  • Supported iOS versions: 16.0+
  • Supported Android versions: 7.0+

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

You can download our apps from the App Store or Google Play Store, or build them yourself.

We plan on releasing monthly updates with new features - check the changelog for what features are currently supported!

Important: If you self-compile the Mattermost Mobile apps you also need to deploy your own Mattermost Push Notification Service.

Android 16KB Page Size Support

Temporary Requirement: To comply with Google Play's 16KB page size requirement for Android devices, this project includes a compatibility patch that must be applied before building for Android.

When to Apply the Patch

  • CI/CD Builds: The patch is automatically applied in GitHub Actions for Android builds
  • Local Development: If you're building Android locally and encounter 16KB page size related issues, run:
npm run apply-16kb-pagesize-patch

This script will:

  1. Update package dependencies to compatible versions
  2. Apply necessary code changes for 16KB page size support
  3. Update patch files for modified dependencies
  4. Regenerate package-lock.json

⚠️ Important Warnings

  • DO NOT commit the changes applied by this patch to the repository
  • These changes will break iOS builds if committed
  • The patch is designed to be applied only during Android CI builds
  • For local development, revert all changes after building Android

Note: This is a temporary solution until all dependencies natively support 16KB page sizes.

How to Contribute

Testing

To help with testing app updates before they're released, you can:

  1. Sign up to be a beta tester
    • Android
    • iOS - Open this link from your iOS device
  2. Install the Mattermost Beta app. New updates in the Beta app are released periodically. You will receive a notification when the new updates are available.
  3. File any bugs you find by filing a GitHub issue with:
    • Device information
    • Repro steps
    • Observed behavior (including screenshot / video when possible)
    • Expected behavior
  4. (Optional) Sign up for our team site

You can leave the Beta testing program at any time:

  • On Android, click this link while logged in with your Google Play email address used to opt-in for the Beta program, then click Leave the program.
  • On iOS, access the Mattermost Beta app page in TestFlight and click Stop Testing.

Contribute Code

  1. Look in GitHub issues for issues marked as [Help Wanted]
  2. Comment to let people know youre 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

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.

I need the code for the v1 version

You can still access it! We have moved the code from master to the v1 branch. Be aware that we will not be providing any more v1 versions or updates in the public stores.

Troubleshooting

I keep getting a message "Cannot connect to the server. Please check your server URL and internet connection."

This sometimes appears when there is an issue with the SSL certificate configuration.

To check that your SSL certificate is set up correctly, test the SSL certificate by visiting a site such as https://www.ssllabs.com/ssltest/index.html. If theres an error about the missing chain or certificate path, there is likely an intermediate certificate missing that needs to be included.

Please note that the apps cannot connect to servers with self-signed certificates, consider using Let's Encrypt instead.

I see a “Connecting…” bar that does not go away

If your app is working properly, you should see a grey “Connecting…” bar that clears or says “Connected” after the app reconnects.

If you are seeing this message all the time, and your internet connection seems fine:

Ask your server administrator if the server uses NGINX or another webserver as a reverse proxy. If so, they should check that it is configured correctly for supporting the websocket connection for APIv4 endpoints.