๐Ÿ‘จโ€๐Ÿ’ป Setting up a development environment

January 24, 2026 ยท View on GitHub

To start developing patches with Morphe Patcher, you must prepare a development environment.

๐Ÿ“ Prerequisites

๐Ÿƒ Prepare the environment

Throughout the documentation, Morphe Patches will be used as an example project.

Note

To start a fresh project, you can use the Morphe Patches template.

  1. Clone the repository

    git clone https://github.com/MorpheApp/morphe-patches
    cd morphe-patches
    
  2. Build the project

    ./gradlew buildAndroid
    

Note

If the build fails due to authentication, you need to add github authentication authenticate to your command line environment. Create a PAT with the scope read:packages here and add your token to ~/.gradle/gradle.properties

Example gradle.properties file in your user folder (usually found in ~/.gradle/gradle.properties)

gpr.user = github_account_name
gpr.key = gph_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Alternatively, instead of modifying your gradle file, your you can install GitHub CLI and login using:

gh auth
  1. Open the project in your IDE

Tip

It is a good idea to set up a complete development environment for Morphe, so that you can also test your patches by following the Morphe documentation.

โญ๏ธ What's next

The next page will go into details about a Morphe patch.

Continue: ๐Ÿงฉ Anatomy of a patch