Home, profile and onboarding

​

Files

​

Endpoint

export interface HomeToday {
  rings: MacroRing[];
  workout: TodaysWorkoutSummary | null;
  lastMessage: CoachMessagePreview | null;
  nextMeal: NextMealReminder | null;
  banner: HomeBanner | null;
  coachWhatsapp: string | null;
  weeklyWorkouts: { completed: number; total: number | null };
  mealsToday: { completed: number; total: number } | null;
  movement: MovementSummary | null;
  filePlan: FilePlanFlags; // { training: boolean; nutrition: boolean }
}

• rings defaults to [].
• workout.subtitle defaults to '' and workout.estimatedMinutes to 0. A file plan sends null for both.
• nextMeal.items defaults to []. target is kept only when present.
• mealsToday stays null only for an explicit null (meals are not tracked for a file nutrition plan). A missing key becomes { completed: 0, total: 0 }.
• weeklyWorkouts.total may be null for a file plan without a weekly target.
• banner goes through normalizeBanner (see below).
• filePlan goes through normalizeFilePlanFlags.

​

useHome

export const homeQueryKey = ['home', 'today'] as const;

​

Picking a skin

export const HOME_THEMES = ['classic', 'glass', 'poster', 'bento'] as const;

​

Shared model

​

Classic

1. HomeHero: greeting, the trainee and coach avatars (tap opens /profile), and a calendar button when enabled.
2. SubscriptionPausedBanner (from the auth feature).
3. NotificationsOffBanner.
4. PendingFormsCard (from the forms feature).
5. HomeBannerCard, when a banner exists.
6. CaloriesPanel, or FilePlanNotice when filePlan.nutrition is true.
7. MovementStack with surface="home", when hasMovementCards(data.movement, 'home') is true.
8. ResumeWorkoutCard when a session is active, otherwise NextWorkoutCard when data.workout exists.
9. A floating WhatsAppFab when coachWhatsapp is set.

​

Bento

​

Glass

​

Poster

​

Next workout card

​

Nutrition panel and next meal card

• Macros. It finds the calories ring and the protein, carbs and fat rings in data.rings, and draws one bar per macro with current / goal. When mealsToday is not null, a ring shows completed/total meals.
• Next meal. Shown when data.nextMeal exists: the meal name, timeLabel, its energy, and its items as a list.

​

Empty next meal

• It returns null when there is no next meal or the meal has items.
• Otherwise it resolves nextMeal.target with resolveMealTarget(target, mbpOn, anchors) and formats it with mealLimitDisplay.

​

Home banner

export interface HomeBanner {
  id: string;
  title: string;
  description: string | null;
  mediaKind: 'image' | 'video' | 'youtube' | 'none' | null;
  mediaUrl: string | null;       // still image used as the backdrop
  mediaVideoUrl: string | null;  // playable url of the banner's own video
  textAlign: 'start' | 'center' | 'end';
  cta: HomeBannerCta | null;
}

export interface HomeBannerCta {
  kind: 'content' | 'whatsapp' | 'link';
  label: string | null;
  contentItemId: string | null;
  url: string | null;
  color: 'brand' | 'white' | 'green' | 'yellow' | 'glass';
  icon: 'none' | 'play' | 'instagram' | 'whatsapp' | 'facebook' | 'cart'
      | 'article' | 'recipe' | 'dumbbell' | 'muscle';
}

​

CTA behaviour

1. kind: 'content' with a contentItemId: push /content/item/:id.
2. kind: 'content' with no item but a mediaVideoUrl: open the banner’s own video in ContentVideoPlayer. An explicitly picked content item always wins over this.
3. kind: 'whatsapp' with a coach phone: open whatsappUrl(coachPhone).
4. kind: 'link' with a url: Linking.openURL(url).

​

Button look

​

Pending forms

​

Notifications-off banner

• With canAskAgain, the button requests permission and then calls registerPushToken().
• Otherwise the button opens the system settings with Linking.openSettings().
• The close button hides it for DISMISS_FOR_MS, 7 days. The dismissal time is stored through pushBannerStorage under the key perform_push_banner_dismissed_at, and a module-scope flag keeps it hidden for the rest of the process.
• Permission is re-read whenever the app becomes active, so returning from settings clears the banner.

​

WhatsApp link

​

Components not currently mounted

​

Profile screen

​

LanguageRow

​

SubscriptionCard

• The plan name row is always present.
• For waiting with a waitingFor value, a row says what starts the subscription: intake_form, first_plan or first_workout.
• Start and end date rows show for every status except waiting, where each shows only if the date exists.
• A days-remaining row shows when daysRemaining is not null.
• When the plan is frozen, appAccessWhileFrozen is true and the status is paused, a note explains the trainee keeps app access.
• When subscription.next exists, a second block shows the next subscription’s start and end dates.

​

Onboarding

if (status === 'unknown') return null;            // splash covers the tree
if (status === 'authed') {
  return <Redirect href={needsStudioChoice ? '/choose-studio' : '/home'} />;
}
if (!hasFinishedOnboarding) return <WelcomeScreen />;
return <Redirect href="/login" />;