51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
# Revolt on Android
|
|
|
|
## Description
|
|
|
|
This is the official Android app for the [Revolt](https://revolt.chat) chat platform.
|
|
The codebase includes the app itself, as well as an internal library for interacting with the Revolt
|
|
API.
|
|
|
|
| Module | Package | Description |
|
|
|--------|---------------|----------------------|
|
|
| `:app` | `chat.revolt` | The main app module. |
|
|
|
|
The API library is part of the `app` module, and is not intended to be used as a standalone library,
|
|
as it makes liberal use of Android-specific APIs for reactivity.
|
|
|
|
The app is written in Kotlin, and uses
|
|
the [Jetpack Compose](https://developer.android.com/jetpack/compose) UI toolkit, the current state
|
|
of the art for Android UI development.
|
|
|
|
## Stack
|
|
|
|
- [Kotlin](https://kotlinlang.org/)
|
|
- [Jetpack Compose](https://developer.android.com/jetpack/compose)
|
|
- For some Material components, the View-based
|
|
[Material Components Android](https://github.com/material-components/material-components-android)
|
|
(MDC-Android) library is used.
|
|
- [Ktor](https://ktor.io/)
|
|
- [Dagger](https://dagger.dev/) with [Hilt](https://dagger.dev/hilt/)
|
|
|
|
## Resources
|
|
|
|
### Revolt on Android
|
|
|
|
- [Revolt on Android Technical Documentation](https://revoltchat.github.io/android/)
|
|
- [Android-specific Contribution Guide](https://revoltchat.github.io/android/contributing/guidelines/)
|
|
—**read carefully before contributing!**
|
|
|
|
### Revolt
|
|
|
|
- [Revolt Project Board](https://github.com/revoltchat/revolt/discussions) (Submit feature requests
|
|
here)
|
|
- [Revolt Testers Server](https://app.revolt.chat/invite/Testers)
|
|
- [General Revolt Contribution Guide](https://developers.revolt.chat/contributing)
|
|
|
|
## Quick Start
|
|
|
|
Open the project in Android Studio. You can then run the app on an emulator or a physical device by
|
|
running the `app` module.
|
|
|
|
In-depth setup instructions can be found
|
|
at [Setting up your Development Environment](https://revoltchat.github.io/android/contributing/setup/) |