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 withcompletedWorkouts(in:), and counts withnumberOfCompletedWorkouts(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 theheading,overlay, andtextBodygroups. Remove these cases from yourcolorsTransform. 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.themeafter initialization.InitializationParametersacceptsconfigurationonly. Assignsdk.themeagain later to switch themes on the same SDK instance. - Build a custom theme from
Theme.defaultorTheme.defaultDarkwithbyApplying. 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
showBodyScanWidgetonProgramScreenConfiguration(defaulttrue) 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
ProgramScreenConfigurationfor.program.showCloseButtoncontrols the close button.showAskCoachButtoncontrols the Ask Coach button and defaults totrue. SetshowCloseButtontofalsewhen 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.
setProfileParamsfails 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
UserDefaultssuite, separate from the host app.