+
+# ๐ Contribution guidelines
+
+Welcome to contribution guidelines, this document contains
+everything you'll need to contribute to ReVanced Manager (and might even possibly apply to our other project like ReVanced Patches!)
+
+There are many ways to contribute like writing docs and code, opening issues,
+helping people out in our community, translating or sponsoring our project, etc.
+
+## ๐ Resources to help you get started
+
+* The [documentation](/docs/developer/README.md) provides steps to build ReVanced Manager from source
+* Our [backlog](https://github.com/orgs/ReVanced/projects/12) is where we keep track of what we're working on
+* [Issues](https://github.com/ReVanced/revanced-manager/issues) are where we keep track of bugs and feature requests
+
+## ๐ Submitting a feature request
+
+Features can be requested by opening an issue using the
+[feature request issue template](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=feature-request&projects=&template=feature-issue.yml&title=feat%3A+%3Ctitle%3E).
+
+> [!NOTE]
+> Requests can be accepted or rejected at the discretion of maintainers of ReVanced Manager.
+> Good motivation has to be provided for a request to be accepted.
+
+## ๐ Submitting a bug report
+
+If you encounter a bug while using the ReVanced Manager app, open an issue using the
+[bug report issue template](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=bug&projects=&template=bug-issue.yml&title=bug%3A+%3Ctitle%3E).
+
+## ๐ Submitting translations
+
+You can contribute translations at translate.revanced.app
+
+> [!TIP]
+> * Try to keep the translated text roughly the same length as the original.
+> * Consider opting for gender-neutral words for language with variations of words based on gender.
+
+## ๐งโ๐ป Developing for ReVanced Manager
+
+See the guidelines for developing for ReVanced Manager [here](/docs/developer/README.md)
+
+## ๐ Submitting a vulnerability
+
+See the guideline for reporting security vulnerability [here](/SECURITY.md)
+
+## ๐ค I don't want to do any of that but I want to contribute either way
+
+You can still contribute by spreading positive word about us or if you'd like to sponsor us, checkout https://revanced.app/donate
+to learn more about how you can sponsor via GitHub, Open Collective, and cryptocurrencies.
+
+โค๏ธ Thank you for considering contributing to ReVanced Manager,
+ReVanced
diff --git a/README.md b/README.md
index c742bcab29..95db690a47 100644
--- a/README.md
+++ b/README.md
@@ -1,55 +1,104 @@
-# ReVanced Manager (Compose Rewrite)
-
-[](../../blob/main/LICENSE)
-[](https://github.com/ReVanced/revanced-manager/commits/compose-dev)
-[](https://github.com/ReVanced/revanced-manager/commits/compose-dev)
-
-_(Yet another)_ rewrite of the ReVanced Manager using Kotlin and Jetpack Compose.
-
-## Design system
-
-In this rewrite, we are adopting the latest Material Design principles and guidelines by using Material 3 and Material You.
-
-Material Design is a design system developed by Google that provides a unified visual language for building beautiful and consistent user interfaces across all platforms and devices. Material You is an extension of Material Design that provides even more customization options for users, making it possible for them to personalize their device and create a unique look and feel.
-
-### Why Material 3?
-
-* **Consistent design language**
-* **Improved accessibility**
-* **Better user experience**
-
-By using Material 3 and Material You, we are ensuring that the app's user interface is consistent, customizable, accessible, and engaging for our users. This will help to improve the overall user experience and increase user satisfaction with the the manager.
-
-## Technology stack
-
-* Kotlin: Kotlin is a modern and concise programming language that is fully interoperable with Java and provides improved safety, readability, and maintainability compared to Java.
-* Jetpack Compose: Jetpack Compose is a modern UI toolkit for Android development that allows developers to build beautiful and performant user interfaces using declarative programming. It provides a unified and efficient way of building UI that is well-integrated with the Android framework.
-
-## Why Kotlin and Compose?
-
-* **Improved safety:** Kotlin provides improved safety compared to Java, which reduces the likelihood of common programming mistakes that can cause security vulnerabilities or crashes.
-* **Concise and readable code:** Kotlin's concise syntax and expressive type system make the code more readable, which makes it easier for developers to understand and maintain the codebase.
-* **Better performance:** Jetpack Compose uses the power of the Android framework to provide smooth and fast performance, which enhances the user experience.
-* **Modern and efficient UI development:** Jetpack Compose provides a modern and efficient way of building UI, which makes it easier for developers to create beautiful and performant user interfaces.
+
+
+# ๐ ReVanced Manager
+
+[](https://github.com/ReVanced/revanced-manager/actions/workflows/release.yml)
+[](#๏ธ-license)
+
+Application to use ReVanced on Android
+
+## โ About
+
+ReVanced Manager is an application that uses [ReVanced Patcher](https://github.com/revanced/revanced-patcher) to patch Android apps.
+
+## ๐ช Features
+
+Some of the features ReVanced Manager provides are:
+
+- ๐ **Patch apps**: Apply any patch of your choice to Android apps
+- ๐ฑ **Portable**: ReVanced Patcher that fits in your pocket
+- ๐ค **Simple UI**: Quickly understand the ins and outs of ReVanced Manager
+- ๐ ๏ธ **Customization**: Configurable API, custom sources, language, signing keystore, theme and more
## ๐ฝ Download
-You can obtain ReVanced Manager by downloading it from either [revanced.app/download](https://revanced.app/download) or [GitHub Releases](https://github.com/ReVanced/revanced-manager/releases)
+You can get the most recent version of ReVanced Manager by downloading from
+the [ReVanced site](https://revanced.app/download).
-## ๐ Prerequisites
+Learn how to use ReVanced Manager by following the [documentation](/docs).
-For a list of prerequisites, refer to [docs/0_prerequisites.md](docs/0_prerequisites.md)
+## ๐ Everything else
-## ๐ด Issues
+### ๐ Contributing
-For suggestions and bug reports, open an issue [here](https://github.com/revanced/revanced-manager/issues/new/choose).
+Thank you for considering contributing to ReVanced Manager.
-## ๐ Translation
+The [contribution guidelines](CONTRIBUTING.md) provides information you'll need to open an issue, develop for ReVanced Manager and translations.
-[](https://crowdin.com/project/revanced)
+### ๐ Documentation
-We're accepting translations on [Crowdin](https://translate.revanced.app)
+You can find the documentation for ReVanced Manager [here](/docs).
-## ๐ ๏ธ Building Manager from source
+## โ๏ธ License
-For instructions on how to build ReVanced Manager from source, refer to [docs/4_building.md](docs/4_building.md)
\ No newline at end of file
+ReVanced Manager is licensed under the GPLv3 license. Please see the [license file](LICENSE) for more information.
+[tl;dr](https://www.tldrlegal.com/license/gnu-general-public-license-v3-gpl-3) you may copy, distribute and modify ReVanced Manager as long as you track changes/dates in source files.
+Any modifications to ReVanced Manager must also be made available under the GPL, along with build & install instructions.
diff --git a/SECURITY.md b/SECURITY.md
index 15e3660da6..4833f35725 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -64,14 +64,20 @@ This document describes how to report security vulnerabilities for ReVanced Mana
## ๐จ Reporting a Vulnerability
-Please open an issue in our [advisory tracker](https://github.com/ReVanced/revanced-manager/security/advisories/new) or reach out privately to us on [Discord](https://discord.gg/revanced).
+Please open an issue in our [advisory tracker](https://github.com/ReVanced/revanced-manager/security/advisories/new)
+or reach out privately to us on [Discord](https://discord.gg/revanced).
-If a vulnerability is confirmed and accepted, you can join our [Discord](https://discord.gg/revanced) server to receive a special contributor role.
+If a vulnerability is confirmed and accepted, they will be published and
+you can join our [Discord](https://discord.gg/revanced) server to receive a
+special contributor role.
### โณ Supported Versions
-| Version | Branch | Supported |
-| --------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------ |
-|  | main | :white_check_mark: |
-|  | dev | :white_check_mark: |
-|  | compose-dev | :white_check_mark: |
+| Version | Branch | Supported |
+|------------------------------------------|---------------|--------------------|
+| ![Latest stable release][LatestRelBadge] | `main` | :white_check_mark: |
+| ![Latest version][LatestVerBadge] | `dev` | :white_check_mark: |
+| ![Latest version][LatestVerBadge] | `compose-dev` | :white_check_mark: |
+
+[LatestRelBadge]: https://img.shields.io/github/v/release/ReVanced/revanced-manager?style=for-the-badge "Latest stable release"
+[LatestVerBadge]: https://img.shields.io/badge/version-latest-brightgreen?style=for-the-badge "Latest version"
diff --git a/assets/revanced-logo/revanced-logo-round.svg b/assets/revanced-logo/revanced-logo.svg
similarity index 100%
rename from assets/revanced-logo/revanced-logo-round.svg
rename to assets/revanced-logo/revanced-logo.svg
diff --git a/docs/0_prerequisites.md b/docs/0_prerequisites.md
index 9d86cd5438..06076aa553 100644
--- a/docs/0_prerequisites.md
+++ b/docs/0_prerequisites.md
@@ -1,10 +1,15 @@
# ๐ผ Prerequisites
-In order to use ReVanced Manager, certain requirements must be met.
+To use ReVanced Manager, certain requirements have to be met.
## ๐ค Requirements
-- An Android device running Android 8 or higher
+- Android device running Android 8.0 or higher
+- System that support running at least `arm64-v8a`, `armeabi-v7a`, `x86_64`, or `x86` application
+
+### Optional Requirements
+
+- Rooted Android device with latest version of [KernelSU](https://github.com/tiann/KernelSU) or [Magisk](https://github.com/topjohnwu/Magisk)
## โญ๏ธ What's next
diff --git a/docs/1_installation.md b/docs/1_installation.md
index d4c08984af..38bcd961a1 100644
--- a/docs/1_installation.md
+++ b/docs/1_installation.md
@@ -1,14 +1,26 @@
# โฌ๏ธ Installation
-In order to use ReVanced on your Android device, ReVanced Manager must be installed.
+To use ReVanced on your Android device, ReVanced Manager have to be install,
+refer to the [Prerequisites](0_prerequisites.md) if haven't already.
-## โ Installation steps
+## ๐ช Installation steps
-1. Download the latest version of ReVanced Manager from [here](https://github.com/revanced/revanced-manager/releases/latest)
+1. Get the latest version of ReVanced Manager from the [ReVanced site][Official ReVanced Download].
2. Install ReVanced Manager
+### โ๏ธ Verifying authenticity of ReVanced Manager
+
+> [!NOTE]
+> It's always advisable that you download from trusted sources like the [ReVanced site][Official ReVanced Download]
+> or GitHub releases as it's the safest way to download ReVanced without potential risk of malware.
+
+To verify if your ReVanced Manager is provided without sign of tampering,
+we have signed the APK with hashes corresponding to `b6362c6ea7888efd15c0800f480786ad0f5b133b4f84e12d46afba5f9eac1223` *unless otherwise stated*.
+
## โญ๏ธ What's next
The next page will guide you through using ReVanced Manager.
Continue: [๐ ๏ธ Usage](2_usage.md)
+
+[Official ReVanced Download]: https://revanced.app/download
diff --git a/docs/2_1_patching.md b/docs/2_1_patching.md
index 7203affa2a..28b9903b7f 100644
--- a/docs/2_1_patching.md
+++ b/docs/2_1_patching.md
@@ -8,16 +8,26 @@ The following pages will guide you through using ReVanced Manager to patch apps.
2. Tap the + button in the bottom right corner
3. Choose an app to patch[^1]
4. Tap on the version of the app you want to patch[^2]
-5. Select the patches you want to apply
-6. Tap the Patch button
-7. Tap on the **Install** button
- > **Note**: If you are rooted, you can mount the patched app on top of the original app.[^3]
- > Optionally, you may export the patched app to storage using the options in the top right corner.
+5. Tap the ๐ช **Patch** button
+6. Tap on the ๐ฒ **Install** button
+ > [!Note]
+ > If the **Install** Button isn't there, it could be that something went wrong. Refer to [3. โ Troubleshooting](3_troubleshooting.md)
+ > [!Tip]
+ > If you are rooted, you can mount the patched app on top of the original app.[^3]
+ > Optionally, you may export the patched app to storage using the options in the bottom left corner.
-[^1]: Non-root users may be prompted to select an APK from storage, in which case you have to source the APK file yourself. ReVanced does not provide any APK files.
+[^1]: You need to select an APK from storage, in which case you have to source the APK file yourself. ReVanced does not provide any APK files.
[^2]: It is suggested to use the version with the most patches to get the most out of ReVanced.
[^3]: Mounting the patched app on top of the original app will only work if the installed app version matches the version of the app selected in step 4. above.
+### Change patch selection and options
+
+Before you can change the selection of patches, follow the step below to allow changing the selection of patches.
+
+1. Tap โ๏ธ Settings button in the top right corner
+2. Go to Advanced Settings
+3. Toggle "Allow changing patch selection" on
+
## โญ๏ธ What's next
The next page will bring you back to the usage page.
diff --git a/docs/2_2_managing.md b/docs/2_2_managing.md
index 29ec56fc4f..02fa9d00f1 100644
--- a/docs/2_2_managing.md
+++ b/docs/2_2_managing.md
@@ -6,10 +6,13 @@ After patching an app, you may want to manage it. This page will guide you throu
1. Navigate to the Apps tab from the top navigation bar
2. Select the app you want to manage
-3.
+
+Inside you will be able to open, and uninstall the app within the manager,
+additionally you will be able to repatch the app by patching the app again, see [๐งฉ Patching apps](2_1_patching.md),
+and view all patches applied to the patched app.
+
## โญ๏ธ What's next
The next page will bring you back to the usage page.
Continue: [๐ ๏ธ Usage](2_usage.md)
-
diff --git a/docs/2_3_updating.md b/docs/2_3_updating.md
index 2b42104cf1..fa04cc1181 100644
--- a/docs/2_3_updating.md
+++ b/docs/2_3_updating.md
@@ -4,7 +4,25 @@ In order to keep up with the latest features and bug fixes, it is recommended to
## โ Updating steps
-> Currently not implemented
+1. Tap the โป Update button in the top right corner right next to the โ๏ธ Settings icon
+2. Tap the **Update** button in the bottom right corner
+3. Wait for the update to be downloaded
+4. Tap the **Install** button to install[^1]
+ > [!Note]
+ > If you see a prompt regarding your device is unable to install application for security reason
+ > you may need to allow ReVanced Manager to install APK file on your device.
+ > 1. Tap on Settings
+ > 2. Toggle "Allow from this source" on
+5. Wait for installation prompt to show then tap **Install** again
+6. Open ReVanced Manager again to see the new version
+
+## ๐ Check for update
+
+Usually ReVanced Manager always check update on first startup, so it's not need to manually check for update yourself.
+To trigger the check for update function follow the step bellow:
+
+1. Go to โ๏ธ Settings menu and โป Update section
+2. Tap on "Check for updates"
## โญ๏ธ What's next
diff --git a/docs/2_4_settings.md b/docs/2_4_settings.md
index 008cda463b..2d2dae4655 100644
--- a/docs/2_4_settings.md
+++ b/docs/2_4_settings.md
@@ -8,30 +8,44 @@ ReVanced Manager has settings that can be configured to your liking.
Specify the URL of the API to use. This is used to fetch ReVanced Patches and update ReVanced Manager.
+ Location: `โ๏ธ Settings -> Advanced -> API URL`
+
- ### ๐งฌ Sources
Override the API and change the source of ReVanced Patches.
+ Location: `Patch bundles -> + Button`
+
- ### ๐งช Experimental ReVanced Patches support
Lift app version constraints from ReVanced Patches. This allows you to patch any version of an app, even if the patch is not explicitly compatible with it.
+ Location: `โ๏ธ Settings -> Advanced -> Safeguards`
+
- ### ๐งโ๐ฌ Experimental universal support
This will show or hide ReVanced Patches, which are not meant for any app in particular but rather for all apps but may not work on all apps.
+ Location: `โ๏ธ Settings -> Advanced -> Safeguards`
+
- ### ๐ Export, import or delete keystore
Manage the keystore used to sign patched apps.
+ Location: `โ๏ธ Settings -> Import & export -> Signing`
+
- ### ๐ Export, import or reset ReVanced Patches selection
Manage the ReVanced Patches selection. This is useful if you want to share your ReVanced Patches selection with others or reset it to the default selection.
+ Location: `โ๏ธ Settings -> Import & export -> Patches`
+
- ### โน๏ธ About
View information about your device and ReVanced Manager. This includes the version of ReVanced Manager and supported architectures of your device.
+ Location: `โ๏ธ Settings -> About`
+
## โญ๏ธ What's next
The next page will bring you back to the usage page.
diff --git a/docs/3_troubleshooting.md b/docs/3_troubleshooting.md
index 5a860c6b12..6776d256fc 100644
--- a/docs/3_troubleshooting.md
+++ b/docs/3_troubleshooting.md
@@ -10,11 +10,19 @@ In case you encounter any issues while using ReVanced Manager, please refer to t
An existing installation of the app you're trying to patch is conflicting with the patched app. Uninstall the existing app before installing the patched app.
+- ๐ฅ Out Of Memory error
+
+ This indicate that your device doesn't have enough memory to patch the app. Try patching on another device that's have more memory.
+
+ In the meantime there's a remedy fix by going to `โ๏ธ Settings -> Advanced -> toggle "Run Patcher in another process (experimental)"` on
+
- โ๏ธ Error code `135`, `139` or `1` when patching the app
Your device is not supported. Refer to the [Prerequisites](0_prerequisites.md) page for supported devices.
- Alternatively, you can use [ReVanced CLI](https://github.com/revanced/revanced-cli) to patch the app.
+ Alternatively, you can use [ReVanced CLI][ReVanced CLI GitHub]) to patch the app.
+
+ [ReVanced CLI GitHub]: https://github.com/revanced/revanced-cli
- ๐ซ Non-root install is not possible with the current patches selection
@@ -22,10 +30,14 @@ In case you encounter any issues while using ReVanced Manager, please refer to t
- ๐จ Patched app crashes on launch
- Select the **Default** button when choosing patches.
+ Try selecting the **Default** button when choosing patches, if the patched app still failed, file an issue at [ReVanced Patches][ReVanced Patches GitHub].
+
+ [ReVanced Patches GitHub]: https://github.com/revanced/revanced-patches
## โญ๏ธ What's next
-The next page will teach you how to build ReVanced Manager from source.
+You have successfully finished the guide for on how to use ReVanced Manager.
+
+If you wish to review the Table of Content for how to use ReVanced Manager, feel free to do so.
-Continue: [๐จ Building from source](4_building.md)
+Continue: [๐ ReVanced Manager](/docs/README.md)
diff --git a/docs/4_building.md b/docs/4_building.md
deleted file mode 100644
index 56917e5fad..0000000000
--- a/docs/4_building.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# ๐ ๏ธ Building from source
-
-This page will guide you through building ReVanced Manager from source.
-
-1. Download Java SDK 17 ([Azul JDK](https://www.azul.com/downloads/?version=java-17-lts&package=jdk#zulu) or [OpenJDK](https://jdk.java.net/java-se-ri/17)) and add it to path
-
-2. Clone the repository
-
- ```sh
- git clone https://github.com/revanced/revanced-manager.git && cd revanced-manager
- ```
-
-3. Create a GitHub personal access token with the `read:packages` scope [here](https://github.com/settings/tokens/new?scopes=read:packages&description=ReVanced)
-
-4. Add your GitHub username and the token to `~/.gradle/gradle.properties`
-
- ```properties
- gpr.user = YourUsername
- gpr.key = ghp_longrandomkey
- ```
-
-5. Set the `sdk.dir` property in `local.properties` to your Android SDK location
-
- ```properties
- sdk.dir = /path/to/android/sdk
- ```
-
-6. Build the APK
-
- Debug:
- ```sh
- ./gradlew assembleDebug
- ```
-
- Release:
- ```sh
- ./gradlew assembleRelease -Psign
- ```
diff --git a/docs/README.md b/docs/README.md
index af2926b6c1..26ed78b342 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,6 +1,6 @@
# ๐ ReVanced Manager
-This documentation explains how to use [ReVanced Manager](https://github.com/revanced/revanced-manager).
+This documentation explains how to use [ReVanced Manager](https://github.com/ReVanced/revanced-manager).
## ๐ Table of contents
@@ -12,7 +12,10 @@ This documentation explains how to use [ReVanced Manager](https://github.com/rev
3. [๐ Updating ReVanced Manager](2_3_updating.md)
4. [โ๏ธ Configuring ReVanced Manager](2_4_settings.md)
3. [โ Troubleshooting](3_troubleshooting.md)
-4. [๐จ Building from source](4_building.md)
+
+## ๐งโ๐ป Developing for ReVanced Manager
+
+Checkout the documentation for developer [here](developer/README.md).
## โญ๏ธ Start here
diff --git a/docs/developer/0_prerequisites.md b/docs/developer/0_prerequisites.md
new file mode 100644
index 0000000000..c5624e95d1
--- /dev/null
+++ b/docs/developer/0_prerequisites.md
@@ -0,0 +1,31 @@
+# ๐ผ Prerequisites
+
+Here's everything you'll need to develop on ReVanced Manager
+
+## ๐ค Recommended environment
+
+- Any environment that is capable of running the latest Android Studio, latest Android SDK, and JDK 17 with at least 4 GB of memory for coding
+- Any devices with preferably the latest Android version or at least higher than the [`minSdk`](/app/build.gradle.kts) for testing
+
+### Additional Requirements
+
+- A device with root capabilities using the latest version of [KernelSU](https://github.com/tiann/KernelSU) or [Magisk](https://github.com/topjohnwu/Magisk)
+
+## โ๏ธ Setting up
+
+### Authenticating to GitHub Registry
+
+ReVanced Manager uses dependency from the GitHub Registry (i.e., [ReVanced Patcher](https://github.com/ReVanced/revanced-patcher/packages)) and so your build may fail without authenticating to the service,
+to authenticate you must create a personal access token with the scope `read:packages` [here](https://github.com/settings/tokens/new?scopes=read:packages&description=ReVanced)
+and add your token to `~/.gradle/gradle.properties`, create the file if it does not exist.
+
+```properties
+gpr.user = username
+gpr.key = ghp_******************************
+```
+
+## โญ๏ธ What's next
+
+The next page will guide you through developing for ReVanced Manager.
+
+Continue: [๐งโ๐ป Developing for ReVanced Manager](1_develop.md)
diff --git a/docs/developer/1_develop.md b/docs/developer/1_develop.md
new file mode 100644
index 0000000000..596ab2fc56
--- /dev/null
+++ b/docs/developer/1_develop.md
@@ -0,0 +1,25 @@
+# ๐งโ๐ป Developing for ReVanced Manager
+
+ReVanced Manager is developed on Kotlin using [Jetpack Compose](https://developer.android.com/compose), here are some tips to help you get started.
+
+## Code style
+
+The styling is based on https://kotlinlang.org/docs/coding-conventions.html
+
+## Commit
+
+At ReVanced, we adopt a naming convention for commit called [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) so for example when you're adding a new feature you must add `feat: ` before the description of your commit.
+
+## Building
+
+To build ReVanced Manager, simply hit build button on your IDE or run:
+
+```sh
+./gradlew assembleDebug
+```
+
+## โญ๏ธ What's next
+
+The next page will guide you through developing for ReVanced Manager.
+
+Continue: [๐ Submitting your Pull Request](2_submitting.md)
diff --git a/docs/developer/2_submitting.md b/docs/developer/2_submitting.md
new file mode 100644
index 0000000000..3bc9ce73e3
--- /dev/null
+++ b/docs/developer/2_submitting.md
@@ -0,0 +1,21 @@
+# ๐ Submitting your Pull Request
+
+> [!TIP]
+> We recommend that you discuss your changes with
+> the maintainers of ReVanced Manager before contributing.
+> This will help you determine whether your change is acceptable.
+
+1. Fork the repository and create your branch from `dev`
+2. Commit your changes in [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) style
+3. Submit a pull request to the `dev` branch of the repository and reference issues that your pull request closes in the description of your pull request
+4. Our team will review your pull request and provide feedback. Once your pull request is approved, it will be merged into the `dev` branch and will be included in
+ the next release of ReVanced Manager
+
+## โญ๏ธ What's next
+
+You have successfully finished the guide for developing for ReVanced Manager.
+
+This next section will be verifying the authenticity of ReVanced Manager
+which may be relevant for store provider or those who's looking to verify prebuilt librar(ies).
+
+Continue: [โ๏ธ Verification and Authenticity of ReVanced Manager](3_verifying.md)
diff --git a/docs/developer/3_verifying.md b/docs/developer/3_verifying.md
new file mode 100644
index 0000000000..b7cd69df5e
--- /dev/null
+++ b/docs/developer/3_verifying.md
@@ -0,0 +1,19 @@
+# โ๏ธ Verification and Authenticity of ReVanced Manager
+
+> [!NOTE]
+> This information is more relevant to alternative store providers
+
+To distribute ReVanced Manager safely and recommended way is to provide the users with a link to
+[1. โฌ๏ธ Installation, โ๏ธ Verifying authenticity of ReVanced Manager (user-side)][installation authenticity].
+
+The certificate SHA-256 of the APK will always be `b6362c6ea7888efd15c0800f480786ad0f5b133b4f84e12d46afba5f9eac1223` unless otherwise noted.
+
+[installation authenticity]: /docs/1_installation.md#%EF%B8%8F-verifying-authenticity-of-revanced-manager
+
+## `libaapt2.so`
+
+ReVanced Manager includes prebuilt binaries of [`libaapt2.so`][location of libaapt2.so] from https://github.com/ReVanced/aapt2
+
+which fixes issue on ARM32-based system, attestation is provided here: https://github.com/ReVanced/aapt2/attestations
+
+[location of libaapt2.so]: /app/src/main/jniLibs/
diff --git a/docs/developer/README.md b/docs/developer/README.md
new file mode 100644
index 0000000000..d3e78b6fd1
--- /dev/null
+++ b/docs/developer/README.md
@@ -0,0 +1,25 @@
+# ๐ ReVanced Manager
+
+> [!WARNING]
+> This guide is for people who want to develop for ReVanced Manager, may feature technical words or jargons.
+> For regular user you may want to view this [documentation](/docs/README.md) instead.
+
+This documentation explains how to develop for [ReVanced Manager](https://github.com/ReVanced/revanced-manager).
+
+## ๐ Table of contents
+
+## Developing
+
+0. [๐ผ Prerequisites](0_prerequisites.md)
+1. [๐งโ๐ป Developing for ReVanced Manager](1_developing.md)
+2. [๐ Submitting your Pull Request](2_submitting.md)
+
+## Transparency
+
+1. [โ๏ธ Verification and Authenticity of ReVanced Manager](3_verifying.md)
+
+## โญ๏ธ Start here
+
+The next page will tell you about the prerequisites for developing for ReVanced Manager.
+
+Continue: [๐ผ Prerequisites](0_prerequisites.md)
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+