Background

The explore feed has been redesigned to offer both community curated content and a personalized "For You" experience. Existing users who update the app will not have gone through the new onboarding flow, so they need a lightweight introduction to the changes. Rather than forcing them through the full onboarding, we want to surface a one-time interstitial that explains the redesign and gives them a clear choice: set up their feed manually, or let us do it for them. This ensures no existing user lands in a broken or confusing experience after updating, while also creating a natural entry point into the new personalization features.

User Story

As an existing Wikipedia app user who has just updated the app, I want to understand what has changed in the explore feed and choose how I want it set up, so that I can continue using the app without disruption and benefit from the new experience on my own terms.

Requirements

• On the first app open after updating to the version containing the new explore feed, existing users should see a one-time interstitial explaining that the explore feed has been redesigned, and is now "Home".
• Only display the interstitial on top of Home (not article view or other locations in the app)
• The interstitial should only be shown once. If the user dismisses it or backgrounds the app during it, it should not reappear on subsequent opens. Although they will get the opportunity to customize their feed through affordances in the new feed.
• Users should be presented with two options: "Set it up myself" which launches the condensed onboarding flow (interests and feed preference screens only, skipping welcome and privacy screens), or "Set it up for me" which dismisses the interstitial and takes them directly to the feed.
• For users who choose "Set it up for me", the default active tab should be the Community curated tab. However, the For You tab should be populated using their existing reading history so that it is ready with relevant content if and when they switch to it. (e.g. Because you read & Continue reading)
• Users who go through "Set it up myself" should land in the explore feed after completing the condensed flow, with their selections applied. The condensed flow is the Interests Selection, Feed Preference and Feed Loading screens

Design Link

Figma link (one-time interstitial) →

Android task for reference

https://phabricator.wikimedia.org/T418788

Toni Handoff Notes

Based on progress at PR https://github.com/wikimedia/wikipedia-ios/pull/5995

Most of this task has not been started. However:

For users who choose "Set it up for me", the default active tab should be the Community curated tab. However, the For You tab should be populated using their existing reading history so that it is ready with relevant content if and when they switch to it. (e.g. Because you read & Continue reading)

The For You tab is already set up to reference their existing reading history, so no work is needed for that piece.

---

Derived Requirement

Ensure existing users who update to the version containing the redesigned Explore feed see a one-time interstitial introducing the redesigned Home feed when they first open the app.
Ensure the interstitial is displayed only when the user is on Home and is not displayed over an article or another location in the app.
Ensure dismissing the interstitial or backgrounding the app during the interstitial prevents it from appearing again on subsequent app opens.
Ensure Set it up myself launches the condensed onboarding flow containing only Interests Selection, Feed Preference, and Feed Loading, while skipping the Welcome and Privacy screens.
Ensure users who select Set it up myself are returned to Home after completing the condensed onboarding flow and that their selected interests and feed preference are applied.
Ensure Set it up for me dismisses the interstitial and takes the user directly to Home with the Community tab active by default.
Ensure users who select Set it up for me have their For You feed populated using their existing reading history so relevant content is available when they switch to For You.

Test Steps

Test Case 1: Ensure the section header is visible when entering edit mode

1. Open the Wikipedia iOS app.
2. Navigate to the La Primavera Biosphere Reserve article.
3. Tap Edit for the Geography section.
4. Enter edit mode.
5. Observe the top of the editor.
6. ✅❓❌⬜ AC1: The section header is visible when the editor opens.

Test Case 2: Ensure users can scroll to the beginning of the edited section

1. Open the Wikipedia iOS app.
2. Navigate to the La Primavera Biosphere Reserve article.
3. Tap Edit for the Geography section.
4. Enter edit mode.
5. Scroll upward within the editor.
6. ✅❓❌⬜ AC2: The editor allows scrolling to the beginning of the section, including the section header.

Test Case 3: Ensure the section header is editable

1. Open the Wikipedia iOS app.
2. Navigate to the La Primavera Biosphere Reserve article.
3. Tap Edit for the Geography section.
4. Scroll to the section header if necessary.
5. Place the cursor within the section header.
6. Enter and remove a temporary edit.
7. ✅❓❌⬜ AC3: The section header can be selected and edited like the rest of the section content.

Test Case 4: Ensure the editor does not clip the top of the content

1. Open the Wikipedia iOS app.
2. Navigate to the La Primavera Biosphere Reserve article.
3. Tap Edit for the Geography section.
4. Enter edit mode.
5. Observe the visible editing area.
6. ✅❓❌⬜ AC4: No portion of the editable content at the top of the section is hidden or clipped.

Test Case 5: Ensure scrolling remains functional throughout the editing session

1. Open the Wikipedia iOS app.
2. Navigate to the La Primavera Biosphere Reserve article.
3. Tap Edit for the Geography section.
4. Scroll down within the editor.
5. Scroll back to the top of the editor.
6. Repeat the scrolling several times.
7. ✅❓❌⬜ AC5: Upward and downward scrolling remain responsive throughout the editing session and always allow access to the full section content.

Test Case 1: Ensure the one-time interstitial appears for an existing user after updating

1. Start with an existing Wikipedia app user who has used the previous Explore feed.
2. Update the Wikipedia app to the version containing the redesigned Home feed.
3. Launch the updated app.
4. Navigate to Home if the app does not open there automatically.
5. Observe the screen.
6. ✅❓❌⬜AC1: The one-time interstitial explaining that the Explore feed has been redesigned and is now called Home is displayed when the existing user first opens Home after updating.

Test Case 2: Ensure the interstitial is only displayed on Home

1. Start with an existing user who has not yet dismissed the new Home feed interstitial.
2. Open the updated Wikipedia app.
3. Navigate to an article instead of Home.
4. Observe the screen.
5. Navigate to Home.
6. Observe the screen.
7. ✅❓❌⬜ AC2: The interstitial is not displayed over an article or other app location and is displayed only on Home.

Test Case 3: Ensure Set it up for me takes the user directly to the Community feed

1. Open the updated Wikipedia app as an existing user.
2. Navigate to Home and display the new interstitial.
3. Select Set it up for me.
4. Observe the resulting Home feed.
5. ✅❓❌⬜AC3: Selecting Set it up for me dismisses the interstitial and opens Home with the Community tab active.

Test Case 4: Ensure Set it up for me populates the For You feed using reading history

1. Use an existing account with reading history that can generate personalized recommendations.
2. Open the updated Wikipedia app.
3. Navigate to Home and display the new interstitial.
4. Select Set it up for me.
5. Verify that the Community tab is active.
6. Select the For You tab.
7. Observe the feed content.
8. ✅❓❌⬜ AC4: The For You feed contains relevant content generated from the user's existing reading history.

Test Case 5: Ensure Set it up myself opens the condensed onboarding flow

1. Open the updated Wikipedia app as an existing user.
2. Navigate to Home and display the new interstitial.
3. Select Set it up myself.
4. Observe the onboarding flow.
5. ✅❓❌⬜ AC5: Selecting Set it up myself opens the condensed onboarding flow containing Interests Selection, Feed Preference, and Feed Loading, without displaying the Welcome or Privacy screens.

Test Case 6: Ensure selected interests are applied after condensed onboarding

1. Select Set it up myself from the Home feed interstitial.
2. Select one or more interests on the Interests Selection screen.
3. Continue to the Feed Preference screen.
4. Select a feed preference.
5. Continue through the Feed Loading screen.
6. Wait for the onboarding flow to finish.
7. Observe the Home feed.
8. ✅❓❌⬜ AC6: The user lands on Home after completing the condensed flow and the selected interests and feed preference are applied to the feed.

Test Case 7: Ensure dismissing the interstitial prevents it from appearing again

1. Open the updated Wikipedia app as an existing user.
2. Navigate to Home and display the new interstitial.
3. Dismiss the interstitial without selecting an onboarding option.
4. Close the app.
5. Reopen the app.
6. Navigate to Home.
7. ✅❓❌⬜ AC7: The interstitial does not appear again after it has been dismissed.

QA Results - TestFlight