Wikimedia Apps/Team/iOS/dtp

This page is a translated version of the page Wikimedia Apps/Team/iOS and the translation is 1% complete.

This page contains information and links specific to the iOS team and codebase.

Get the Wikipedia iOS app from the App Store.

The FAQ is the main documentation for the iOS app.

Active projects

Information and updates

Manom 2024

We launched the Alternative Text experiment to editors on Spanish, Portuguese, French, and Chinese Wikipedias. It will prompt editors to add alternative text to images after they have completed a relevant edit.
We finalized designs for Phase 1 of our Navigation refresh and began development.
- Profile entry point
  - File:IOS_App_Navigation_refresh_first_phase_04.png
- Profile Menu
  - File:IOS_App_Navigation_refresh_first_phase_03.png
We shared results and next steps from our community consultation on the Article Badge fundraising experiment idea.
We completed exploratory work to prepare for upcoming work on a personalized Wikipedia Year in Review feature.
We moved to using Xcode 16, and no longer support iOS 15. T370205
We made several improvements to our in-app donation form:
- Ensuring the maximum and minimum allowed amounts function in all currencies. T365043
- Making the transaction fee match the web’s form. T365306
- Do not show Native ApplePay prompt in countries where it is not supported. T373209
With the help of volunteer developers, we made the following improvements:
- Support for keyboard shortcuts were added to Native Editor. T352881
- The “picture of the day” widget now leads to the correct view. T373126
- Added icons to the article preview menu. T374282

Ahead of the December fundraiser, we updated campaign banners to ensure users have the ability to scroll on smaller screens (SE). T348695

The team’s Product Manager attended the Wiki GLAM Conference to get feedback on a Suggested Edits prototype that encourages users to add alt-text to images. The feature was well received by attendees qualitatively. Before proceeding with iterating and releasing the add alt-text feature to the iOS app, the alt-text added by attendees will be evaluated. Further details about the project are available at iOS Suggested edits project page.
We also fixed a crash that was occurring on Chinese Wikipedia when clicking account or donate. T348723
The team is currently working on updating the navigation of the app. We currently have two variants for an updated app navigation. We will be conducting user testing in the coming months to iterate on the new app navigation concepts. If you are interested in providing feedback on the new navigation of the iOS app, please reach out to ARamadan-WMF.

We made updates to our account authentication to support the upcoming rollout of Temporary accounts. T339378
Bug fixes:
- Fixed issue that was causing app to crash in some settings after opening revision history, watchlist, or notifications center. T372119
- Addressed bugs that were affecting the interface for adding images and links while editing. T372839, T372301
- Solved an issue with Submenu under user button via Watchlist Pop-up, and viewing watchlist after adding an article to your watchlist. T373965 ,T374035
- Fixed a poor transition on iPadOS 18. T370967

Magus 2024

We completed the update, and we are now using revision tags for all app edits. T366732
The team worked to clear out technical debt, to keep our app running smoothly and set us up for quicker development of future features. This involved:
- Renamed Swift Packages. T371736
- Tested app on iOS/iPadOS 18 beta. T369645
- Swapped out page/related API call with MediaWiki API equivalent. T365595
- Fixed project warnings and cleanup console. T369871
- Added defined type styles. T300034
- Remove single root navigation controller. T369567
- Move to Scene Delegate API. T369725
We fixed the following bugs:
- The app was not deep linking (opening links to Wikipedia articles from browsers in the app) after being closed. T371983
- Ampersands and apostrophes were displaying incorrectly T371149 & T371148
- Notification bell was not responding to taps. T370965
- Running out of Image Recommendations caused Add an Image to crash. T371127
- Expanded our check for existing images in articles before suggesting images in Add an Image. T371055
We began work on the Alternative Text experiment. We added a new capability in the app: developer settings. This will allow us to move quickly and deploy things behind feature flags more in the future. Tasks can be viewed in the sub-epic: T357437
We completed analysis for iOS’s “Add an image” feature 30 days after deployment. T362835 & T371906
We calculated the total images added through Apps Image Recommendations on both Android and iOS (more than 20,000!) T372954
We calculated baselines for how many Edits/Unique User are typical for iOS app users in a calendar year. T371555

Madas 2024

At Wikimania 2024, You can find us at Wikimedia Foundation Fundraising Banner Message Workshop on the 7th of August and at the web round table on the 8th of August to discuss a concept for a fundraising experiment in the iOS app.

The team began development on the Alt text experiment, you can follow our work on the Engineering Epic: T357440

We iImproved our tracking of edits made on iPad devices T366756

We investigated the difficulty of adding image recommendations edits automatically into common infoboxes for English Wikipedia T359134

We added an end date to our new feature announcement for Image Recommendations. T364397

We confirmed that iOS will be compatible with upcoming changes to the Reading List API T366630

Chinese Language variants are now working correctly in Notifications Center Inbox T357591

You can now type em dashes ("—") in the wikitext editor. T361868

We added a warning message if users accept an image recommendation very quickly T364049

Mahas 2024

Thanks to volunteer developer support, the bug causing the Picture of the Day Widget to open to Featured Article was fixed. T356255

After the release of “Add an image” suggested edit, we have results for our leading indicators after 15 days. There were 891 edits completed in 15 days using the feature.

App Fundraising campaigns concluded in Japan and Spain.

Thanks to volunteer developer support, the search function within “Add an image” has been improved. T363942

The team worked on tackling tech debt tasks, such as removing Legacy > UIColor+Extensions file. T348031

Mikat 2024

We released “Add an image” suggested edit to production! It is available to all users with more than 50 edits.

Add an image demonstration

We learned that we can improve our default syntax for inserting images, and worked with Android to identify and implement a solution.

We’re scoping the difficulty to implement automatic infobox insertion for images where possible for en.wikipedia.

We improved the edit summary screen. You can now easily add the page to your watchlist, or see if the page is already on your watchlist. The “Publish” option has been de-emphasized until the Edit summary is filled out to encourage users to add edit summaries. T354219

Logged-in users are able to opt-out of donation banners on Web, we added support so that the app also honors these settings. T352306

We fixed a bug to ensure that users are able to successfully unsubscribe from push notifications. T361221

Our analyst has provided preliminary insights following the release of Native Editor
- This work contributes to KR 1.1 of the Annual Plan: Increase unreverted mobile contributions in the main article namespace on Wikipedias by 10%, averaged across a representative set of wikis.
  - In releasing Native Editor, we saw Edits in the article namespace increase by 16.8% for logged in editors during the initial 14 day analysis period.
- KR: 2% decrease in edit abandonment
  - Actual: Native edit abandon rates were 4.2% lower compared to Non-native edit attempts.
- KR: Engagement with full page editing is comparable to Android
  - Android’s avg article edit by editor is still higher than Native iOS by 28.5% (7.2 for Native iOS compared to 10.1 for Android)
  - However, iOS’s Revert rate was lower by 1.7 percentage points. (4.3% vs Android’s 6.0%)
- KR: Increase in unique user edit rate
  - The average number of edits per logged in editor increased to 7.2 for Native users as compared to 6.2 for Web edit users in app, an 18.8% change.

Ngiop 2024

The team met for an offsite in San Francisco at the Wikimedia Foundation office, where we drafted our roadmap for the coming fiscal year.

We continued development work on Image Recommendations and released the feature to Beta testers at the end of April. We expect it to be available in production early May.

The Alt Text scaled experiment within Suggested Edits will be a part of the FY24245 Annual plan’s Key Result, Wiki experiences 1.2 for Constructive activation. Our hypothesis is: If we conduct an A/B/C test with the alt-text suggested edits prototype in the production version of the iOS app we can determine if adding alt-text to images is a good task for newcomers or should be reserved for experienced users.

We launched usability testing of our Alt-text suggested edit prototypes in English and Chinese.

We improved the Voice Over support for Diff view. T343582

We updated license information is displayed. T341144

We fixed a bug that was preventing some users from opening revision history of non-mainspace pages. T343494

Thanks to volunteer developer support, PDFs can be reviewed in full-screen view without errors T357266, and published article descriptions will include edit summaries. T351649

Gomot 2024

The “Add an image” suggested edit is in development, with a planned release of early May.
Our analyst shared some early insights regarding the Native Editor: the new native editor has a 20.3% higher edit rate per unique editor. Edits made through the new native editor have a 1% lower revert rate than the wrapped in web view.
We are reviewing the latest designs for the Alt-text experiment before starting usability testing.
We heard feedback surrounding the alt-text experiment.
The team is investigating using the new hidden LINT rules created by the Content Transform Team for creating a feed of images that need Alt-text.

Mansak 2024

The team received feedback from Arabic, English, and German Wikipedian about a redesign of the navigation of the app. We are waiting for Chinese Wikipedians' feedback to wrap up to finalize the initial analysis.
We fixed a bug to help widgets display properly T346810
Designs are complete for the Add an Image suggested edit task Image iOS, and development will begin. The flow is similar to the existing Add an Image suggested edit in the Android App. Learn more on the iOS Suggested edits project page.
We updated our article view to allow for full page editing T331935, and we now also support full-page editing on Talk pages: T331936
We released Native Editor to all users. This should reduce the number of bugs experienced when editing with iOS, improve loading times and performance of editing actions, and allows for full-page editing. T344282
- As part of this work, we worked to add formatting options into Native editor T347928, paragraph heading and styling, T348073, undo and redo functionality T348088, find and replace tool T348091, list formatting T348090, link formatting T348071, and template formatting T348074.

Syntax highlighting in the native text editor (theme default).
Text formatting toolbar (first options) in the native text editor (theme default).
Text formatting toolbar (more options) in the native text editor (theme default).
Text formatting sheet in the native text editor (theme default).
Syntax highlighting in the native text editor (theme black).
Text formatting toolbar (first options) in the native text editor (theme black).
Text formatting toolbar (more options) in the native text editor (theme black).
Text formatting sheet in the native text editor (theme black).

Milatok 2024

Native editor is in development and user testing, we are anticipating release in February.

We are pivoting for our next step in the Suggested Edits project, moving forward with Image recommendations first, and then developing an integrated alt-text experiment.

Designs are in review for image recommendations.

Momuhau 2023

We connected with Wiki Editoras Lx and joined their editathon December 16th to gather feedback about an alt-text Suggested Edit task on iOS. In preparation we made our feedback form automatically appear after a first edit to increase the feedback we receive. Attendees were generally positive about the prospect of the feature. Experienced editors thought it could be a good task for onboarding new editors, but also a more casual way of contributing for new editors. Attendees of the edit-a-thon expressed that editing alt-text on the Web is currently difficult because it takes you out of context of the article. There was also an expression of interest in the feature being brought to Android.
The team has started working on a refresh of the navigation of the app. As we start adding more features to the app it is becoming increasingly difficult to choose an appropriate entry point to surface to iOS app users. We invite you to be a part of our decision making process as we explore some changes to the app’s navigation.
The team made progress making the iOS app editor a native editor. This will improve the performance of editing within the app. In December we focused on formatting options in the new native editor.

Milau 2023

Option A: Homepage with a 'Profile' and 'Tabs' option in the tab bar.
Option A: 'Notices' include 'Notifications' and 'Watchlist.
Option A: 'Watchlist.
Option A: 'Profile' page.
Option A: 'Search' with 'History'.
Option A: Tabs
Option A: Article view.
Option A: Saving articles.

Option B: 'Homepage' with 'Activity' and 'Notifications' options in the tab bar.
Option B: Pages and settings.
Option B:'Notifications'.
Option B: 'Activity' page with 'Recent History'.
Option B: 'Search' page with 'Recommended content'.
Option B: Article view with options to add to lists.

Gumas 2023

We are happy to bring Watchlist to the iOS app. You can now add articles to your watchlist to monitor the edits of Wikipedia articles you care about the most. You can access and, filter your watchlist through the Account option in your Settings. Read more about thus feature on the Watchlist project page.

The team ran user testing for a prototype of Suggested Edits on iOS, a microcontribution feature. The Suggested Edit type we are exploring allows contributors to add alt-text to images. You can read more about the project and the outcome of the user testing on the iOS Suggested Edits project page. After several requests to improve the donation flows in the app, the team made a number of changes:

Ability to pay using Native Apple Pay T288285
When using non-native methods of payment, users are taken to an in-app web view instead of their app browse T345851, T333108
Give potential donors more control over seeing campaign banners with the introduction of an option of Maybe Later or selecting I already donated T346823
Support multi-lingual campaigns in the app T347352
Ensure campaign language can be updated faster T348278

Sample campaign banner with new options to select Maybe Later or Already Donated
New Modal that allows donors to pay using Apple Pay or an alternative payment method
New confirmation modal after a donation is made

We also worked on some minor improvements to the app which included:

Updating the notifications project selection icons to be more consistent with other the filter views in the app T343266
Its now possible to share sections of an article T345436
Bug fixes related to app navigation T347581 and T344005
The app should no longer freeze when swiping down and back up T300321
With Apple’s release of iOS 17, we dropped support for iOS 14. T343038

In October the apps team held office hours. You can see the recap on our office hours page.

End of Manom 2023 Update

The team created low fidelity mockups and a design clickable prototype for an exploration of bringing Suggested Edits to the iOS app. The first iOS suggested edit task we are exploring is to add alt-text to images.

We ran a consultation with Global Renamers to understand how we can improve the account deletion flow in the apps. This information was used to create a set of requirements, which will be implemented by a service team:

Must Haves:

Auto verify email and username association.

Requests with a verified email go directly to Special:GlobalRenameQueue and includes the user’s email and user name.

Requests to Global Rename Queue includes a note that the request is a deletion request from the app and rationale for the request.

Users that can not be verified by email and username should go to trust & safety.

This can be handled app-side for the purpose of the apps team but if this has to serve web and apps needs for account deletion then the web flow would need to account for this (perhaps via something like a Special:ContactForm).

Nice to Have :

Auto account deletion (renaming) for users with:
- Zero edits.
- Zero Actions.
- No active blocks (by Account or by IP).
- DEPENDENCY: In order for this to take place an additional consultation would have to take place with the broader community because it requires a modification to community renaming policy.

Manom 2023, Special Mid Month Update

Watchlist on iOS is available to test via Test Flight. You can go to the Apple App store and download the testflight app and join Beta Testing for the Wikipedia iOS app. Once you’ve downloaded the Wikipedia app through test flight, add at least one article to your watchlist via the more button in the bottom toolbar. If you already have items in your Watchlist and you are logged into your account you can access your Watchlist by going to Settings → Account → Watchlist. Feel free to leave feedback on the Watchlist project discussion page.

Magus 2023

We Released 7.4.0 and 7.4.1. The releases included:

An updated Diff view with the ability to undo destructive edits T335579.
The app now supports Tachelhit (Tifinagh/ⵜⴰⵛⵍⵃⵉⵜ ). T333596 and hardcoded language variant codes T338079.
We fixed the issue with the purge function not completely clearing all stored data Moving forward if there is vandalism T341104.
We also fixed a bug of the scroll-down behavior on the Diff View where it would get stuck T339302.

Madas 2023

Released 7.3.1,with updates that included

The addition of GUR Wikipedia to supported languages T331550.
A fix to the character count display for article short descriptions T332320.
Resolution of a bug with the app theme misaligning with the system theme T336093.
An improved app launch time for faster access to reading all of your favorite articles T340489.
We finalized designs for full page editing on articles and talk pages T331935 and T331936. In order to make full page editing work, we must make our editor native, which is what we are in the process of working on once Wathclist on iOS is complete.

Full page editing mode

We received feedback on the latest designs for Watchlist on iOS.

Mahas 2023

We have successfully launched Release 7.3.0 (2242) (T337792). In this new release, we have made improvements to the user interface and the overall performance of the iOS app.

To ensure smooth navigation and usability, we have adjusted the interface to present a warning for semi-protected pages earlier in the process before edit mode (T313772).

The following are designs for two scenarios:

Editor taps to edit a fully-protected page:

Editor taps to edit a semi-protected page
Editing screens open with an alert
Tapping 'Ok' brings the editor to the editing screen that is disabled
Tapping on the 'X' icon takes you back to the article

Editor that is blocked tries to edit a semi-protected page:

Blocked editor taps to edit a semi-protected page
Block message appears

Editor that is blocked tries to edit a semi-protected page

Enhancements have been made to the Picture of the Day and Top Read widgets, which now fetch data independently from Wikifeeds, ensuring consistent performance and data availability (T327554, T327556).
We have created guidelines to standardize the colors used across the app, resulting in improved UI consistency and accessibility (T299793).
We have addressed theme switching issues that surfaced in the user talk revision history and the Link editor, ensuring that these elements now adapt correctly to all theme variations (T330320, T326207).
We have also optimized the app's launch time. This was achieved by simplifying the state restoration process and reducing the number of navigation modals, thereby significantly enhancing the user experience (T337073).
We also introduced a new feature flag in the client app for the watchlist feature. This provides a safeguard for rollback without affecting other work. Flag checks are in place at key points including the watchlist, diff view, and article view entries (T336200)
This month we also examined design component patterns with emphasis on theming, font application, automatic updates for dark mode/dynamic type changes, and integration with UIKit and SwiftUI. After finalization, we provided guidelines for design requirements, focusing on defining inputs and outputs (T329329).

Mikat 2023

In May, our team successfully rolled out version 7.2.2 of the application, which included performance improvements ( T335077, T335075, T335134). We released 7.3.0 to Beta testers which includes performance improvements to widgets and the last of our edit notices work (/T337792#8935018) .
We have also been investigating and testing a solution for a bug that can cause our app to freeze, potentially due to outdated offline reading code (T336804). The fix will go out in release 7.3.1.
Further, we are enhancing our native source editor to facilitate full page source editing (T331936).

Ngiop 2023

We fixed some issues with background crashes and long app launch times. These will be released in version 7.2.2 in May. Extra thanks to all of the users who helped us troubleshoot this! T335077 T335075 T335134

We worked on technical debt surrounding widgets, to make them more stable. T327553

We worked on a native wikitext editor to improve editor performance and prep for supporting full page article and talk page editing. T331936 T331935

We started work on supporting images in talk pages. T329843

We also started preparations for building Watchlist. T334212 check the Watchlist's project's page.

Gomot 2023

We fixed some crashes related to the article display T280700 T280699.

We improved the featured article widget caching T331902.

Note: Those 3 tasks above were released as a part of 7.2.1 on April 14.

We also continued to update the app’s colors T299793.

We continued to work on moving over the app’s analytics to a new system T327341.

We worked on technical debt surrounding widgets, to make them more stable T327553.

We worked on a native wikitext editor to improve editor performance and prep for supporting full page article and talk page editing T331936 T331935.

Mansak 2023

We have continued work on our 7.2.0 release, which is in external beta and final testing now. It includes displaying edit noticesphab:T201596,abuse filter messages phab:T327418, as well as blocked message improvements phab:T169013, phab:T275118, phab:T201640.

We have also continued to work on addressing some underlying analytics technical debt phab:T327341, and began work on our design components phab:T329329, phab:T299793, phab:T329559 to be used in a later release.

7.2.0 will include the following volunteer fixes:
- By GitHub username aria1991:
  - Improved localization script - https://github.com/wikimedia/wikipedia-ios/pull/4462.
  - Improved copy code mirror resources script - https://github.com/wikimedia/wikipedia-ios/pull/4457.
  - Improved fix reverse dollar signs script - https://github.com/wikimedia/wikipedia-ios/pull/4451.
- By GitHub username junholee61:

We have been working on designs and improvements for edit notices, block, AbuseFilter and protected/semi-protected page messages to further improve and fill the on-wiki communication gaps.

You can follow the work at T278838 and soon you will be able to read about this work on our Team/iOS/Communication project page.

Milatok 2023

We worked on our 7.1.0 release, it includes tasks below. 7.1.0 release is currently in external beta testing, and should be released to the App Store soon.

A new talk page archives menu option in the overflow menu.

phab:T321853

A few keyboard formatting buttons for inserting wikitext on talk pages.

phab:T315606

Various bug fixes with article links (all fixed by a volunteer!)

phab:T294157, phab:T283846,phab:T321066,phab:T324307,phab:T316495,phab:T321064.

Other bug fixes: The first two are volunteer fixes!

phab:T317587,phab:T322955,phab:T320738,phab:T323519,phab:T322160,phab:T324862,phab:T314809

We also began working on our next release, 7.2.0. It includes addressing some underlying analytics technical debt phab:T327341, displaying edit notices phab:T201596, as well as blocked message improvements phab:T169013, phab:T275118, phab:T201640.

Talk pages have been fully released to the App Store. As we conclude this first version of talk pages we are recruiting experienced Wikipedia contributors with iOS devices to participate in a multilingual survey (Arabic, German, English, Chinese (Simplified)). If you are interested in participating you can use the survey. If you have any questions email otichonova@wikimedia.org; thank you!

Dokumentasi

Work

The team

Jazmin Tanner – Product Owner
Toni Sevener – Tech Lead/Lead Engineer
Marina Azevedo - Sr Engineer
Carolyn Li-Madeo – User Experience (UX) Designer
Amal Ramadan - Sr Movement Communications Specialist

Contribute to development

We welcome volunteers to contribute to the Wikipedia iOS app codebase.

Be a beta tester

Go to testflight.apple.com to help us as a beta tester!

What can I work on?

If you are looking for easy work, look at the tasks marked with the "Easy" tag. This phabricator workboard will show you all the "Easy" tasks in the iOS backlog.

If you are ready to pick up more difficult work, look at the iOS backlog and pick something from the Bug Backlog column. This workboard will show you all the tasks in the iOS backlog. If the status of the task is unclear or you need more information, feel free to leave a comment and we will try to respond as soon as possible.

I found my task. What next?

Now you want to let the team know what you are working on.

In Phabricator, assign the task to yourself.
Add the tag representing the current release to the task. This link will take you to currently open releases. Tagging your task with the name of the release will add it to the release board.
On the release board, move the task to the "Doing" column.
When you are done developing, move the task to the "Needs Code Review" column.

I don't want to work on my task any more.

You can let us know by unassigning the task and moving it back to the "Tasks from Product Backlog" column.

How will I know that my contribution was accepted?

If your task gets moved to the "Ready for PM Signoff" column, it means that your contribution will be included in the upcoming release.

Tips

How to use Phabricator

Code this way

Developer README

Repositories

The Wikipedia iOS app code is hosted on both GitHub and Gerrit.

GitHub

This is the main repository, where iOS developers at the Foundation operate and release public betas via TestFlight. Pull requests via GitHub are the preferred contribution method.