WordPress for iOS - Official repository


License: GPL-2.0

Language: Swift

Keywords: cocoapods, ios, objective-c, swift, wordpress, xcode

WordPress for iOS


Build Instructions

Download Xcode

At the moment WordPress for iOS requires Swift 2.2 and Xcode 7.3 or newer. Previous versions of Xcode can be downloaded from Apple.

Third party tools

We use a few tools to help with development. To install or update the required dependencies, run the follow command on the command line:

rake dependencies


WordPress for iOS uses CocoaPods to manage third party libraries.
Trying to build the project by itself (WordPress.xcproj) after launching will result in an error, as the resources managed by CocoaPods are not included. To install and configure the third party libraries just run the following in the command line:

pod install


We use SwiftLint to enforce a common style for Swift code. Xcode will show a warning if you don't have it installed. The app should build and work without it, but if you plan to write code, you are encouraged to install it. No commit should have lint warnings or errors.

SwiftLint runs automatically when you build the project, but you can run it manually from the command line with:

rake lint

If your code has any style violations, you can try to automatically correct them by running:

rake lint:autocorrect

Otherwise you have to fix them manually.

Open Xcode

Launch the workspace by running the following from the command line:

rake xcode

This will ensure any dependencies are ready before launching Xcode.

You can also open the project by double clicking on WordPress.xcworkspace file, or launching Xcode and choose File > Open and browse to WordPress.xcworkspace.

Setup Credentials

In order to login to WordPress.com using the app you will need to create an account over at the WordPress.com Developer Portal.

After you created an account you can create an application on the WordPress.com applications manager.

When creating your application, you should select "Native client" for the application type. The applications manager currently requires a "redirect URL", but this isn't used for mobile apps. Just use "https://localhost".

After you created an application you will have an associated a client ID and a client secret key. These details will be used to authenticate your application and verify that the API calls being made are valid.

In order to use these details, you'll need to create a credential file in your build machine. Start by copying the sample credentials file to your home folder by doing this:

cp ./WordPress/Credentials/wpcom_app_credentials.txt ~/.wpcom_app_credentials

Then edit the ~/.wpcom_app_credentials file and change the WPCOM_APP_ID and WPCOM_APP_SECRET fields to the values you got for your app.

Then you can compile and run the app on a device or an emulator and login with a WordPress.com account.

Remember the only account you will be able to login in with is the one affiliated with your developer account.

Read more about OAuth2 and the WordPress.com REST endpoint.

How we work

You can read more about Code Style Guidelines we adopted, and how we're organizing branches in our repository in the Contribution Guide.

Need help to build or hack?

Say hello on our Slack channel: #mobile.


WordPress for iOS is an Open Source project covered by the GNU General Public License version 2.


Developer blog & Handbook

Blog: http://make.wordpress.org/mobile

Handbook: http://make.wordpress.org/mobile/handbook/

To report an issue


Source Code

GitHub: https://github.com/wordpress-mobile/WordPress-iOS/

How to Contribute


Project Statistics

Sourcerank 8
Repository Size 596 MB
Stars 2,786
Forks 926
Watchers 174
Open issues 693
Dependencies 103
Contributors 62
Tags 377
Last updated
Last pushed

Top Contributors See all

Jorge Leandro Perez Eric Jorge Bernal Sendhil Panchadsaram Sérgio Estêvão Aaron Douglas Brent Coursey Diego Rey Mendez Dan Roundhill James Frost tomwitkin Will Kwon Mike Johnston Robert “Beau” Collins Matt Bumgardner Oguz Kocer Alex Curylo Matt Miklic Brad Angelcyk Nate Heagy

Recent Tags See all April 08, 2019 April 08, 2019
12.1 April 05, 2019
12.0 March 22, 2019 March 20, 2019 March 20, 2019 March 14, 2019 March 14, 2019
11.9.1 March 13, 2019 March 11, 2019 March 11, 2019
11.9 March 08, 2019 February 26, 2019 February 26, 2019 February 25, 2019

Interesting Forks See all

WordPress for iOS - Official repository
GPL-2.0 - Updated - 2 stars
WordPress for iOS - Official repository
Swift - GPL-2.0 - Updated - 1 stars
WordPress for iOS - Official repository
Objective-C - GPL-2.0 - Updated - 1 stars - 1 forks
WordPress for iOS - Official repository
Swift - GPL-2.0 - Updated - 1 stars - 1 forks
WordPress for iOS - Official repository
Objective-C - Updated - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2016-12-13 12:25:28 UTC

Login to resync this repository