Repolode
wordpress-mobile

wordpress-mobile/WordPress-iOS

Official open-source iOS app repository for WordPress, letting users build and run the WordPress mobile app from source in Xcode.

Stars
3,910
Forks
1,174
Open issues
421
Last commit
20 hours ago

What is it?

This repository contains the source code for the official WordPress app for iOS, maintained by Automattic. It is written primarily in Swift, with some Objective-C, and is intended for developers who want to compile the app themselves, contribute changes, or log into WordPress.com from a development build.

Setup centers on a command-line workflow: install the Xcode version and Ruby version specified in the repository, run dependency setup with Rake, and create a WordPress.com OAuth application to obtain a client ID and secret. Once credentials are configured, the project opens in Xcode as a workspace and can run on a simulator or a device.

The repository also links to contributing guidelines, development practice docs, and the WordPress Mobile handbook. Security issues are directed to the HackerOne program rather than public issues.

Key features

  • 01Builds the WordPress iOS app from source in Xcode.
  • 02Uses Rake tasks to install dependencies and configure credentials.
  • 03Supports logging into WordPress.com through OAuth2 credentials you create.
  • 04Pins the required Xcode and Ruby versions in the repository.

Use cases

  • Compiling the WordPress iOS app for a simulator or personal device.
  • Contributing bug fixes or features to the official mobile app.
  • Studying how a large production Swift app is structured and configured.

Quick start

  1. 1

    Download and install Xcode (minimum version in .xcode-version)

  2. 2

    Clone the repository

  3. 3

    Open WordPress.xcworkspace in Xcode and build the Jetpack or WordPress scheme

    open WordPress.xcworkspace
  4. 4

    Run the OSS setup task from the command line

    rake init:oss

Things to know

  • Requires macOS with Xcode to build and run.
  • Logging in requires your own WordPress.com API client ID and secret, and only the account that created that application can log in.
  • Setup requires Ruby (via rbenv) and the rake tooling.

Topics

FAQ

What is WordPress-iOS?
Official open-source iOS app repository for WordPress, letting users build and run the WordPress mobile app from source in Xcode. This repository contains the source code for the official WordPress app for iOS, maintained by Automattic. It is written primarily in Swift, with some Objective-C, and is intended for developers who want to compile the app themselves, contribute changes, or log into WordPress.com from a development build.
Is WordPress-iOS free to use? What license does it have?
WordPress-iOS is open source under the GPL-2.0 license. Check the license terms before using it in commercial products.
Is WordPress-iOS still maintained?
Actively maintained. The last commit to WordPress-iOS was on Nov 5, 2026.
What can I use WordPress-iOS for?
Compiling the WordPress iOS app for a simulator or personal device. Contributing bug fixes or features to the official mobile app. Studying how a large production Swift app is structured and configured.
How do I install WordPress-iOS?
Download and install Xcode (minimum version in .xcode-version) Clone the repository Open WordPress.xcworkspace in Xcode and build the Jetpack or WordPress scheme: open WordPress.xcworkspace Run the OSS setup task from the command line: rake init:oss
Where can I get WordPress-iOS?
The source code and installation instructions are on GitHub: https://github.com/wordpress-mobile/WordPress-iOS

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

Related projects