← Executive Explainer Catalog · The Force for Health® Network

BuddyBoss → Flutter

BuddyBoss just rebuilt its app on Flutter. Here's what it means for us — and the dual-bridge plan we're committing to.

React Native Flutter
New BuddyBoss app framework
Google Fit Health Connect
The real Android health target now
1 app 2 tracks
Dual bridge during transition
Insulated
Our custom code is server-side
Prepared for Dr. Rob Gillio & Coach Lucy CTO / Global Development June 3, 2026
The Bottom Line

BuddyBoss's framework swap (React Native → Flutter) is a mobile-app-shell change, not a platform change. Almost all of our custom code lives server-side in WordPress and is insulated from it. We're committing to a dual bridge: ride the new BuddyBoss 3.0 app now for stability, build a HealthKit + Health Connect bridge for member health data, and begin our own Flutter app for theforce.health as a long-term, owned exit asset — phased, no forced cut-over.

1 · What actually changed

This is part of the "BuddyBoss 3.0" rollout — three releases: the admin redesign (May 2026), the Next-Generation BuddyBoss App (late May), and ReadyLaunch (June). The app itself was rebuilt from React Native onto Flutter.

DimensionOld app (React Native)New app (Flutter)
UI frameworkReact Native (JS bridge to native)Flutter (compiles to native ARM)
Light / Dark modeLimitedFull, synced to device setting
PerformanceGood, but JS-bridge overhead on heavy screensSmoother scroll/animation, faster cold start
Who maintains itBuddyBossBuddyBoss (they carry the OS-update burden)
Custom native pluginsWritten for React NativeMust be re-implemented as Flutter plugins
The dark-mode catch: our brand assets (white logos, coins) assume light or navy backgrounds. When the app flips to dark, white-on-transparent art can disappear or invert. This needs a deliberate visual QA pass before members see it.

2 · What it means for FFH — the good news

We scanned the workspace for our custom BuddyBoss code. The honest finding: the migration touches the mobile shell, and our customization lives a layer below it, in WordPress.

🟢
Our notification bridge is insulated. The scfa-360-tracker-bridge plugin (med reminders + milestone notifications to the BuddyBoss bell and mobile push) works through core BuddyPress notifications. The Flutter app reads those automatically — no rebuild needed for the framework swap.
🟢
Coins & tracker data are server-side. The GamiPress SHARE It Coin integration and the tracker REST API live entirely on our WordPress server. The framework change does not touch them.
🟡
The one thing to verify: any custom native plugin we (or a dev) injected into the React Native app shell would need re-implementing as a Flutter plugin. Our scan found no such code in the workspace — but BuddyBoss support should confirm what, if anything, was customized at the app-shell level.
🟢
Your call on the legacy code holds. The new UX largely overwrites the need for the old customization. We're archiving it for the record, not because we expect to rebuild it.

3 · Apple Health & "Google Fit" — important correction

You asked to move toward Apple Health and Google Fit ASAP. One fact changes the plan: there is no live "Google Fit" to integrate with anymore.

PlatformWhat we integrate with today
iOSApple HealthKit — fully supported in Flutter
AndroidGoogle Health Connect — the replacement for Google Fit, which Google deprecated and removed

Good news: Flutter has mature, well-supported packages (health, flutter_health_fit, heka_health) for pulling steps, heart rate, sleep, and activity from both. This lines up directly with PHIT scoring and Live It tracking. The health bridge is a Flutter plugin we'd build either way — so health integration does not force the own-app decision; it's feasible on both tracks. The open question is whether BuddyBoss exposes those hooks natively, or whether we build the plugin ourselves.

4 · The dual-bridge strategy

Two parallel tracks. Track A keeps members on a stable, vendor-maintained app today. Track B builds the asset we own — the one that matters for monetization and exit.

Track A · Now

Ride BuddyBoss 3.0

The live member app. Stable, vendor-maintained, fast to value.

  • Confirm our bridge survives the upgrade
  • Visual QA for dark mode + brand assets
  • Add the HealthKit / Health Connect bridge
  • BuddyBoss carries OS updates + store builds
Track B · Build

FFH-owned Flutter app

theforce.health's own app — the long-term exit asset we control.

  • Scaffold the Flutter shell + CI build pipeline
  • Own App Store / Play Store presence
  • Native HealthKit / Health Connect from day one
  • Phased — no forced cut-over from BuddyBoss
Why own it: with the monetization/exit lens, the app is an asset on the balance sheet. Renting it from BuddyBoss forever caps that value. The dual bridge lets us de-risk: members never feel the transition, and we build ownership on our own timeline.

5 · Legacy-code archive — status

Per your direction, we're cataloging the pre-Flutter custom code in Airtable so it can be deleted with confidence.

6 · Next steps

This week
Confirm with BuddyBoss support

Three questions: (1) does the Next-Gen app support custom native plugins, and is our customization migrated; (2) does it expose HealthKit / Health Connect hooks natively; (3) resubmission + QA guidance.

This week
Finish the Airtable archive

Re-run the legacy-code archive table and log each component with its rebuild verdict. Then we can clear the old source with confidence.

Next 2 weeks
Dark-mode + bridge QA on the live app

Verify our notification bridge and brand assets render correctly in the new Flutter app, light and dark, before members feel any change.

Next 30 days
Scope the FFH Flutter app

Stand up the Flutter shell, CI build pipeline, and a HealthKit / Health Connect proof-of-concept that writes into PHIT. Decide build-it-internally vs. contract a Flutter dev.

Ongoing
Run the bridge in parallel

BuddyBoss stays the live app until our own app reaches feature + stability parity. No cut-over date is set until parity is proven.

Decision Requested

Two greenlights to move

The strategic direction (dual bridge) and the legacy archive are already approved. To put the next steps in motion, we need: