Repolode
wikimedia

wikimedia/wikipedia-ios

The official Wikipedia app for iOS, built in Swift and Objective-C, for reading and browsing Wikipedia on iPhone and iPad.

Stars
3,471
Forks
942
Open issues
43
Last commit
15 hours ago

What is it?

Wikipedia iOS is the official Wikipedia app for Apple devices, maintained by the Wikimedia Foundation. It lets users read and browse Wikipedia articles on iOS, and its source code is published under the MIT license so developers can build and run it themselves.

The project is written mainly in Swift, with Objective-C code still present. Building it requires Xcode 16.0 or later. A setup script installs the required tools, including SwiftLint and ClangFormat, and sets up a pre-commit hook for code formatting. The app has several build schemes: a production target, an Alpha target with in-development feature flags, an Experimental target for prototypes, and debug schemes that can point to local staging services.

The article view and some other components rely on web components, which are developed separately and documented in the repository. Unit tests run from Xcode and expect the device language and region to be set to en-US.

Key features

  • 01Browse and read Wikipedia articles on iOS devices
  • 02Open-source under the MIT license
  • 03Multiple build schemes for production, alpha, experimental and local debugging
  • 04Automated setup script for installing Xcode-related lint and format tools
  • 05Article view built partly on web components

Use cases

  • Reading Wikipedia on an iPhone or iPad
  • Studying how a large, production iOS app is structured in Swift and Objective-C
  • Contributing fixes or features to the official Wikipedia iOS client

Quick start

  1. 1

    Install Xcode 16.0 or newer from the App Store

  2. 2

    In the repository root, run the setup script

    ./scripts/setup
  3. 3

    Open Wikipedia.xcodeproj and run the Wikipedia scheme on the iOS Simulator

Things to know

  • Requires a Mac with Xcode 16.0 or newer, so it only builds on Apple platforms.
  • Development setup depends on Xcode and the setup script installing Homebrew and other tools.

Topics

FAQ

What is wikipedia-ios?
The official Wikipedia app for iOS, built in Swift and Objective-C, for reading and browsing Wikipedia on iPhone and iPad. Wikipedia iOS is the official Wikipedia app for Apple devices, maintained by the Wikimedia Foundation. It lets users read and browse Wikipedia articles on iOS, and its source code is published under the MIT license so developers can build and run it themselves.
Is wikipedia-ios free to use? What license does it have?
wikipedia-ios is open source under the MIT license. Check the license terms before using it in commercial products.
Is wikipedia-ios still maintained?
Actively maintained. The last commit to wikipedia-ios was on Nov 6, 2026.
What can I use wikipedia-ios for?
Reading Wikipedia on an iPhone or iPad Studying how a large, production iOS app is structured in Swift and Objective-C Contributing fixes or features to the official Wikipedia iOS client
How do I install wikipedia-ios?
Install Xcode 16.0 or newer from the App Store In the repository root, run the setup script: ./scripts/setup Open Wikipedia.xcodeproj and run the Wikipedia scheme on the iOS Simulator
Where can I get wikipedia-ios?
The source code and installation instructions are on GitHub: https://github.com/wikimedia/wikipedia-ios

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

Related projects