Summary: Gymondo-git/pulse-app, the React Native + Expo app for the Gymondo and Buddyfit brands on iOS, Android and TV, built white-label (a brand is a “tenant”). Since 2026-11-10 the intended home of the 7Mind React Native app as a sibling app, apps/sevenmind (react-native-migration-index). Sources: GitHub Gymondo-git/pulse-app on branch develop (README.md, AGENTS.md, package.json, apps/native/package.json, packages/, packages/config/src/tenants/, git history), read 2026-11-06; a local clone with a 7Mind tenant added (spike, not pushed). Not a 7Mind repo: read only, owned by Gymondo.; PR #264 and its apps/sevenmind/README.md (2026-11-12); pulse-app PRs #264, #287, #288 and #289 and their branches as of 2026-11-16 Last updated: 2026-11-16


Purpose

One codebase for the 7NXT fitness apps. Created 2026-07-08, default branch develop, actively developed (commits daily in November 2026; most commits by molocco). It replaces, or will replace, the native Gymondo apps (Gymondo-git/ios-app in Swift, Gymondo-git/android-app in Kotlin); check the rollout state before relying on that. Tenants today: gymondo, buddyfit.

History

  • 2026-07-06: started by Matias Olocco as “7NXT App” (7nxt-app) from an architecture spec in docs/superpowers/specs/. Brands in scope: Gymondo, Buddyfit, “7Mind + future brands: white-label-ready”.
  • 2026-07-08: renamed to PulseApp (commit “chore: rename app from 7NXT to PulseApp”); packages went from @7nxt/* to @pulseapp/*. The commit names one technical reason: the leading digit made Swift escape the module name (_NXT-Swift.h). What “Pulse” stands for is not documented.
  • The original spec planned RevenueCat and SQLite (Drizzle); the code now uses expo-iap and MMKV only.

Stack

  • Expo SDK 57 with a custom dev client (no Expo Go), New Architecture, React 19.2, React Native via react-native-tvos 0.86 (one app for phone, tablet and TV)
  • pnpm workspaces + Turborepo; TypeScript 5.8
  • TanStack Query for server state, XState for journeys, React Navigation 7
  • Unistyles v3 themed from a token pipeline (GDS token repo, Style Dictionary, typed TS)
  • MMKV for all local persistence (no SQLite)
  • expo-iap for StoreKit 2 and Play Billing, no third-party purchase service
  • Firebase (Analytics, Crashlytics, Remote Config), Braze via @braze/expo-plugin, Adjust, Thryve for wearables, PubNub chat, Google Cast and AirPlay
  • Maestro for e2e; Codemagic for release builds (one workflow per tenant x platform x env), EAS profiles for dev clients

Key Files / Entry Points

  • AGENTS.md — the architecture rules (package boundaries, white-label rule, tracking, purchases, offline, navigation, tablets, config). Read it before any change.
  • apps/native/ — the Expo app: screens, navigation, journeys; app.config.ts needs TENANT and APP_ENV
  • apps/tv/ — TV app
  • packages/ — core (domain, deeplink table, logger), api (typed REST client, TanStack hooks, auth session), data (downloads, outboxes, preferences), chat, tracking, observability, purchases, notifications, health, config (tenant x env config, Remote Config registry), i18n (i18next, Lokalise), icons, theme, ui
  • packages/config/src/tenants/<tenant>/{base,local,test,prod}.ts — per-brand static config
  • tooling/ — config generator, ESLint rules that enforce the white-label and icon rules, Maestro flows, regression tests

Deployment

Codemagic builds store releases per tenant, platform and environment (local, test, prod). Secrets come from Codemagic environment groups, mirrored in 1Password.

Dependencies

External services: Gymondo backend APIs (/api/v3/{brand}/...), Firebase, Braze, Adjust, Thryve, PubNub, Lokalise, App Store and Google Play. Internal: Gymondo platform (gymondo-platform), Gymondo SSO (gymondo-sso-auth).

Integration Points

Calls Gymondo APIs directly, not the 7Mind legacy gateway. Receipts are relayed to the Gymondo backend; products come from GET /api/v3/{brand}/products/{apple|google}, the same shape the 7Mind Flutter app uses for sevenmind.

How brand-specific it is

The white-label model covers brands of the same product only. Per tenant there are config files (packages/config/src/tenants/<id>/), a token set, string overrides (a few keys; about 1,700 lines of common strings are shared), assets, Firebase files, and about a dozen explicit tenant branches (logo, background video, loaders, Barmer login for Gymondo, marketing consent for Buddyfit). The product structure is not configurable: MainTabs.tsx hardcodes Home, Fitness, Progress, Challenges, Nutrition, and about 85% of the screen code is fitness-specific. apps/tv (about 1.3k lines) shows the other way to reuse the packages: a separate app with its own screens.

A 7Mind tenant was added locally on 2026-11-06 and ran on the iOS simulator. Things it needed beyond config: skip Thryve linking (private pods behind Nexus credentials), an inert Spotify plugin config (the module’s pod comes from the plugin), no Google web client on 7Mind staging Firebase, empty Adjust event tokens. Login with a 7Mind staging account worked against app.6mind.de (pulse-app’s auth flow with a 7Mind/... user agent), and the purchase endpoints match the Flutter app’s.

7Mind as a sibling app (in progress)

Draft PR #264 “[WIP] Add the 7Mind app as a sibling app” (Ali Kayhan, opened 2026-11-10, stacked on #253, the Expo 58 and Xcode 27.2 upgrade) adds apps/sevenmind. 7Mind-only package code goes into each package’s src/sevenmind, exported as a <package>/sevenmind subpath; tooling/eslint.product-boundaries.js stops apps/native and apps/tv from importing it. pnpm config:generate needs APP=sevenmind for it, Metro runs on 8083. Ground rules for 7Mind work and the reasoning are in rn-migration-goals-and-architecture.

Follow-up drafts stacked on #264 (2026-11-13): #287 (For you destinations: detail screens, Favourites, History, SOS toolkit), #288 (Library tab) and #289 (Prevention tab and module quiz, on #287). #264 itself is out of draft and waiting for approval. Status and percentages: rn-migration-plan.

Conventions

  • White-label rule (lint-enforced): components use theme tokens and i18n keys only. A new brand is config, tokens and native service files, never component changes.
  • Brand is build time, color scheme is runtime.
  • packages/* are presentation-agnostic; screens and navigation live only in apps/*. Import packages only through their index.ts barrel.
  • Track only through tracking.track() with typed events; Braze receives an allowlisted subset under production event names.
  • Config changes in packages/config need a dev server restart, not a native rebuild.

Agent Change Log

2026-11-06 — note created from a read of the repo while assessing the 7Mind React Native migration 2026-11-06 — added history (7NXT App, rename), how brand-specific the app is, and the local 7Mind tenant spike 2026-11-12 — added the 7Mind sibling app in progress (PR #264) 2026-11-16 — added the stacked 7Mind PRs #287, #288, #289