Repolode
wordpress-mobile

wordpress-mobile/WordPress-Android

The official WordPress client for Android, letting users manage self-hosted WordPress sites and WordPress.com accounts from a phone.

Stars
3,153
Forks
1,367
Open issues
788
Last commit
yesterday

What is it?

WordPress for Android is the open-source Kotlin codebase behind the official WordPress app on Google Play. Users can sign in to a self-hosted WordPress site by entering its address and credentials, or log in with a WordPress.com account.

The repository is aimed at developers who want to build, run, or contribute to the app. It includes Gradle commands for assembling the debug APK, installing it on an emulator or device, and running unit and Android instrumented tests. Full WordPress.com features such as the Reader and Stats require the developer to supply their own OAuth2 client ID and secret, and Google Sign-In is only functional in the official build.

The project is distributed under GPL-2.0, and the code in its libs directory comes from external libraries that may carry compatible licenses.

Key features

  • 01Sign in to self-hosted WordPress sites or WordPress.com accounts.
  • 02Gradle tasks to build, install, and test the debug app from the command line.
  • 03Written in Kotlin with an Android Studio project setup.
  • 04Includes unit tests and Android instrumented tests.

Use cases

  • Developers who want to contribute features or fixes to the official WordPress Android app.
  • Engineers studying a large, production-scale Kotlin Android codebase.
  • Testers setting up a local build with their own WordPress.com OAuth2 credentials.

Quick start

  1. 1

    Install Android Studio

  2. 2

    Open the project from the local repository in Android Studio

  3. 3

    Build the debug APK from the command line

    ./gradlew assembleWordPressDebug
  4. 4

    Install the debug APK on a connected emulator or device

    ./gradlew installWordPressDebug

Things to know

  • WordPress.com features such as sign-in, Reader and Stats require your own OAuth2 client ID and secret.
  • Google Sign-In always fails for contributors building from source.
  • Licensed under GPL-2.0, a copyleft license.

In collections

Topics

FAQ

What is WordPress-Android?
The official WordPress client for Android, letting users manage self-hosted WordPress sites and WordPress.com accounts from a phone. WordPress for Android is the open-source Kotlin codebase behind the official WordPress app on Google Play. Users can sign in to a self-hosted WordPress site by entering its address and credentials, or log in with a WordPress.com account.
Is WordPress-Android free to use? What license does it have?
WordPress-Android is open source under the GPL-2.0 license. Check the license terms before using it in commercial products.
Is WordPress-Android still maintained?
Actively maintained. The last commit to WordPress-Android was on Nov 6, 2026.
What can I use WordPress-Android for?
Developers who want to contribute features or fixes to the official WordPress Android app. Engineers studying a large, production-scale Kotlin Android codebase. Testers setting up a local build with their own WordPress.com OAuth2 credentials.
How do I install WordPress-Android?
Install Android Studio Open the project from the local repository in Android Studio Build the debug APK from the command line: ./gradlew assembleWordPressDebug Install the debug APK on a connected emulator or device: ./gradlew installWordPressDebug
Where can I get WordPress-Android?
The source code and installation instructions are on GitHub: https://github.com/wordpress-mobile/WordPress-Android

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects