Proof Of Concept to run a Matrix client on Android devices using the Matrix Rust Sdk and Jetpack Compose
Go to file
Benoit Marty 492b0120f8
Merge pull request #2750 from element-hq/renovate/com.posthog-posthog-android-3.x
Update dependency com.posthog:posthog-android to v3.1.18
2024-04-24 16:30:35 +02:00
.github Update danger/danger-js action to v12 2024-04-16 19:44:41 +00:00
.idea Room directory : add tests and cleanup 2024-03-28 17:03:34 +01:00
.maestro Improve session recovery screens (#2657) 2024-04-09 17:01:06 +00:00
anvilannotations Update Gradle to 8.1 and AGP to v8.0 (#329) 2023-04-17 08:49:52 +00:00
anvilcodegen Fix ktlint issues 2024-01-10 19:33:39 +01:00
app Implement a migration mechanism to handle internal stuff which need to occur during application upgrade. 2024-04-24 11:17:23 +02:00
appconfig Add ApplicationConfig object to help tweaking the application / brand name used across the application. 2024-04-10 16:57:18 +02:00
appnav Rename Preview to follow code convention 2024-04-19 14:30:45 +02:00
changelog.d Remove `SessionData.needsVerification` as the source of truth for session verification status (#2748) 2024-04-24 13:55:25 +00:00
docs Fix small typos 2024-01-31 11:51:30 +01:00
fastlane/metadata/android/en-US Adding fastlane file for version 0.4.10 2024-04-17 08:24:30 +02:00
features Remove `SessionData.needsVerification` as the source of truth for session verification status (#2748) 2024-04-24 13:55:25 +00:00
gradle Update dependency com.posthog:posthog-android to v3.1.18 2024-04-24 12:18:39 +00:00
libraries Remove `SessionData.needsVerification` as the source of truth for session verification status (#2748) 2024-04-24 13:55:25 +00:00
plugins version++ 2024-04-17 08:25:59 +02:00
samples/minimal Merge pull request #2714 from element-hq/feature/fga/room_list_invites 2024-04-17 23:04:31 +02:00
screenshots Sync Strings from Localazy 2024-04-22 00:18:11 +00:00
services Fix compile with noop analytics provider 2024-04-12 21:12:44 +02:00
tests Update screenshots 2024-04-24 11:17:23 +02:00
tools Remove empty line and ensure check.sh script run ktlint. 2024-04-19 10:02:39 +02:00
.editorconfig Ktlint: disable rule standard:blank-line-before-declaration. 2024-01-10 19:31:36 +01:00
.gitattributes Generate screenshots for foreign languages ("de" and "fr" for now). #2454 2024-02-28 14:30:34 +01:00
.gitignore Git ignore copilot folder. 2024-03-12 10:52:30 +01:00
AUTHORS.md Organization renaming: replace all `https://github.com/vector-im` by `https://github.com/element-hq` 2023-12-13 09:40:07 +01:00
CHANGES.md Changelog for version 0.4.10 2024-04-17 08:23:45 +02:00
CODEOWNERS Update CODEOWNERS after organization renaming 2023-12-12 13:54:32 +01:00
CONTRIBUTING.md Add documentation about Element X Android Gallery. 2024-04-12 12:04:59 +02:00
Gemfile Add Gemfile to be able to run danger locally. 2023-01-19 11:13:48 +01:00
LICENSE Initial commit 2022-10-06 09:59:25 +02:00
README.md Add documentation about Element X Android Gallery. 2024-04-12 12:04:59 +02:00
build.gradle.kts Move `Konsist` tests to quality checks (#2558) 2024-03-15 18:03:13 +01:00
gradle.properties Update android.gradle.plugin to v8.3.1 (#2471) 2024-03-21 09:47:17 +01:00
gradlew Update dependency gradle to v8.4 (#1496) 2023-10-06 08:38:36 +02:00
gradlew.bat Update dependency gradle to v8.7 (#2597) 2024-04-01 10:05:00 +02:00
settings.gradle.kts StartDM : add tests 2023-11-30 18:05:26 +01:00
towncrier.toml Organization renaming: replace all `https://github.com/vector-im` by `https://github.com/element-hq` 2023-12-13 09:40:07 +01:00

README.md

Latest build Quality Gate Status Vulnerabilities Bugs codecov Element X Android Matrix room #element-x-android:matrix.org Localazy

Element X Android

Element X Android is a Matrix Android Client provided by element.io. This app is currently in a pre-alpha release stage with only basic functionalities.

The application is a total rewrite of Element-Android using the Matrix Rust SDK underneath and targeting devices running Android 6+. The UI layer is written using Jetpack Compose, and the navigation is managed using Appyx.

Learn more about why we are building Element X in our blog post: https://element.io/blog/element-x-experience-the-future-of-element/.

Table of contents

Screenshots

Here are some early screenshots of the application:

Translations

Element X Android supports many languages. You can help us to translate the app in your language by joining our Localazy project. You can also help us to improve the existing translations.

Note that for now, we keep control on the French and German translations.

Translations can be checked screen per screen using our tool Element X Android Gallery, available at https://element-hq.github.io/element-x-android/. Note that this page is updated every Tuesday.

More instructions about translating the application can be found at CONTRIBUTING.md.

Rust SDK

Element X leverages the Matrix Rust SDK through an FFI layer that the final client can directly import and use.

We're doing this as a way to share code between platforms and while we've seen promising results it's still in the experimental stage and bound to change.

Status

This project is in work in progress. The app does not cover yet all functionalities we expect. The list of supported features can be found in this issue.

Contributing

Want to get actively involved in the project? You're more than welcome! A good way to start is to check the issues that are labelled with the good first issue label. Let us know by commenting the issue that you're starting working on it.

But first make sure to read our contribution guide first.

You can also come chat with the community in the Matrix room dedicated to the project.

Build instructions

Just clone the project and open it in Android Studio. Makes sure to select the app configuration when building (as we also have sample apps in the project).

Support

When you are experiencing an issue on Element X Android, please first search in GitHub issues and then in #element-x-android:matrix.org. If after your research you still have a question, ask at #element-x-android:matrix.org. Otherwise feel free to create a GitHub issue if you encounter a bug or a crash, by explaining clearly in detail what happened. You can also perform bug reporting from the application settings. This is especially recommended when you encounter a crash.

Copyright © New Vector Ltd

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.