Skip to Content

iOS

Release notes for the native iOS SDK. When a release ships with a Flutter plugin, the entry names that version. The changelog overview groups the same releases with Android.

2.5.0

17 November 2026. Ships with Flutter 2.5.0.

  • Adds a workout activity API. Read the user’s plan with plannedWorkouts, their history with completedWorkouts(in:), and counts with numberOfCompletedWorkouts(in:with:). Each has a Combine publisher. See Workout activity.
  • Asks the user to confirm before they leave the Body Scan flow from the Photo Review or Target Body screen.
  • Requires the user to choose a workout duration after they change their workout environment in plan settings.

2.4.0

23 October 2026. Ships with Flutter 2.4.0.

  • Removes color tokens: .brand(.tertiary), .button(.lightYellow), .button(.lightOrchid), .button(.lightBlue), .button(.iconTransparent), and the heading, overlay, and textBody groups. Remove these cases from your colorsTransform. Adds .metrics(.weight) for weight charts. See Theming for the current tokens.
  • Adds weight tracking. Users can log, edit, and delete weight entries, and see trend charts, their goal, and the full history.
  • Adds a weight widget to the Program screen. It shows the latest weight, the change since the previous entry, and a reminder to update it.
  • Syncs weight with Apple Health in both directions. See Apple Health.
  • Registers the APNs device token for the logged-in user and unregisters it on logout(). Add the Push Notifications capability to your app to receive pushes. See Push notifications.
  • Saves the weight from onboarding or from setProfileParams(_:) as a weight entry.
  • Shows a “thinking” state in the AI Coach chat, and a clearer error when a reply fails or takes too long.
  • Redesigns the plan progress page and applies your theme to it.
  • Clarifies the buttons on the Fitness Test and Flexibility Test results screens.
  • Removes an extra navigation step when adapting a custom workout.
  • Saves Portuguese correctly as the profile language, and fixes Italian translations.
  • Builds with Xcode 27.

2.3.0

28 September 2026. Ships with Flutter 2.3.0.

Theme setup changes in this release. Assign the theme with sdk.theme after initialization. See Theming.

  • Assign sdk.theme after initialization. InitializationParameters accepts configuration only. Assign sdk.theme again later to switch themes on the same SDK instance.
  • Build a custom theme from Theme.default or Theme.defaultDark with byApplying. Each token resolves to a value.
  • Color tokens use new names. Brand colors remain .brand(.primary), .brand(.secondary), and .brand(.tertiary), and .brand(.text) is added.
  • Adds showBodyScanWidget on ProgramScreenConfiguration (default true) to show or hide the Body Scan card on the Program screen.
  • Adds setPrimaryLocationID(_:) to save your location id on the logged-in user’s profile.
  • Syncs age group and starting weight with the rest of the profile after onboarding.
  • Includes the user id on analytics events.
  • Updates Program, onboarding, workouts, the assistant, profile, and computer-vision screens for the new design tokens, including dark mode.

2.2.0

8 September 2026. Ships with Flutter 2.2.0.

  • Adds ProgramScreenConfiguration for .program. showCloseButton controls the close button. showAskCoachButton controls the Ask Coach button and defaults to true. Set showCloseButton to false when you embed Program in your own navigation, such as a tab bar.
  • Adds .onboarding, so you can present the onboarding flow on its own.
  • Opens external links in the system browser.
  • Syncs body fat percentage, lean body mass, body mass index, and waist circumference from Apple Health.
  • Adds gym equipment: hack squat, linear hack squat, decline chest press, iso-lateral lat pulldown, high row, iso-lateral vertical row, pullover, and ski erg.
  • Updates Italian copy, and onboarding strings in Arabic, German, Spanish, French, and Brazilian Portuguese.
  • Fixes long titles in selection lists, a missing tooltip background, and an extra navigation step when adapting a workout.

2.1.0

26 August 2026. Ships with Flutter 2.1.0.

  • Adds Italian, including Italian terms and privacy policy links.
  • Adds a target-weight step to onboarding.
  • Fixes workout playback and exercise logging.

2.0.0

19 August 2026. Ships with Flutter 2.0.0.

2.0 starts here. Authorization changes in a breaking way: you identify users with a JWT minted by your backend. Later 2.x releases continue from this line. See Authorization.

  • Adds a locally triggered “Rest’s up!” notification during workouts.
  • Fixes stability around login and logout.
  • Requires profile data before onboarding can finish.
  • Preloads gym workout exercise videos when a workout starts.
  • Fixes workout results and the Fitness Test.

1.9.0

31 July 2026. Ships with Flutter 1.6.0.

  • Updates the chat design and adds chat UI customization.
  • Adds computer-vision entry points on Home.
  • Syncs the last 30 days of health data on the first sync.
  • Fixes incorrect units in computer-vision flows.
  • setProfileParams fails when you call it before the user is logged in.
  • Disables adding another image once a chat message already has four images.
  • Adapts the “Questions for the Coach” background to your theme.

1.8.0

17 July 2026. Ships with Flutter 1.5.0.

  • Redesigns the Flexibility Test.
  • Shows a gender-appropriate illustration in the Fitness Test and the Flexibility Test, based on the user profile.
  • Syncs workouts when the user logs in.
  • Lets you paste an image into chat.
  • Fixes the Flexibility Test, exercise lists, and dark mode.

1.7.0

3 July 2026. Ships with Flutter 1.4.0.

  • Removes the “Give Your Feedback” screen from the Body Scan flow after a scan.
  • Fixes Flexibility Test behavior, profile settings, and plan settings.

1.6.0

5 June 2026. Ships with Flutter 1.2.0.

Flutter 1.3.0 is an Android release. The following release is 1.7.0, which ships with Flutter 1.4.0.

  • Adds Body Scan, the Flexibility Test, and the Fitness Test.
  • Adds a close button on onboarding screens and a Fitness Test result screen.
  • Fixes Body Scan, the Fitness Test, and onboarding.

1.5.0

20 May 2026. Ships with Flutter 1.1.0.

  • Fixes custom workouts.
  • Fixes saved exercise preferences, logout, and Plan Progress.
  • Loads remote resources so the SDK bundle is smaller.
  • Stores SDK preferences in an isolated UserDefaults suite, separate from the host app.
Last updated on