B Strong App Support

---

Welcome to the B Strong support page. This guide covers setup, core features, detailed Workout and Nutrition workflows, privacy and permissions, troubleshooting, and how to get help. It reflects the current app build and the features shipping in the first release.

Overview

B Strong is a strength training and nutrition companion that helps you:

- Track training volume and progress by muscle group

- Log meals quickly and see remaining macros at a glance

- Calculate targets with a built‑in Macro Calculator and evidence‑based Strategy

- Scan barcodes and nutrition labels to prefill food entries

- Build recipes and compute per‑serving macros (optional tool)

- Optionally integrate with Apple Health (off by default)

Requirements

- iPhone running iOS 17 or later (iOS 18 recommended)

- Optional: Apple Health access (for reading/writing dietary data)

- Camera access for barcode and label scanning

Key Features

Dashboard

- Segmented views for **Workouts** and **Nutrition**

- Time‑series charts for **Total Volume** and **Volume by Muscle Group**

- Calories & Macros card (consumed vs remaining), with “Open Nutrition Today”

- Strategy and Macro Calculator sections for targets and adjustments

Workouts

- Volume analytics showing total volume over time and by muscle group

- Group chips to focus on individual muscle groups or compare top groups

- Custom date ranges (1–6 months, 1 year, All, or Custom)

- Planned support for exercise editing, supersets, notes, rest timers, and plate math

- Equipment and gym preferences to tailor workout suggestions

Nutrition

- Nutrition Today logging with meals split by Breakfast, Lunch, Dinner, and Snacks

- Quick Add, Your Foods library, Recents, built‑in seed foods, and Online search

- Barcode (UPC/EAN) and Label (OCR) scanning to quickly add food entries

- Live macro totals and remaining macros relative to targets

- Energy Balance card showing surplus or deficit versus target intake

- Optional Recipe Builder tool for batch ingredient entry and per‑serving macro calculation

---

Getting Started

1) Open B Strong and explore the Dashboard. Use the segmented control to switch between **Workouts** and **Nutrition**.

2) Set macro targets on the Dashboard’s Macro Calculator (age, weight, activity, goal). Targets update automatically.

3) Tap **Open Nutrition Today** to start logging. Use Quick Add, Quick Search, or Scan to add food.

4) (Optional) Enable **Recipe Builder** in Nutrition Settings → Tools, then open it from the Nutrition Settings page.

---

Workouts (in depth)

B Strong’s workout analytics help you understand your training trends and focus areas.

- Total Volume chart

- See how your total training volume changes over time.

- Choose range presets (1–2 weeks, 1–6 months, 1 year, All) or define a **Custom** range.

- Volume by Muscle Group

- Track progression for major groups (chest, back, lats, shoulders, biceps, triceps, quads, hams, glutes, calves, core).

- Use chips to filter a single group or show the top few groups together.

- Per‑group time‑series helps spot plateaus and over‑/under‑emphasis.

- Custom date ranges

- Use the **Custom Range** picker to select any start/end dates.

- PR banner (when applicable)

- The app can surface a “New PR” banner when a new estimated 1RM is detected for an exercise.

- Planned/available workout tools (screen stubs already in the app)

- **Settings (Workouts)**: rest timer defaults, mesocycle defaults (goal, sets, reps, intensity, tempo), behavior toggles (auto‑start rest, auto‑advance in supersets), and device options (prevent sleep during workout).

- **Edit Workout**: reorder exercises, replace, create/unlink supersets, add from library.

- **Exercises Browser**: switch or remove in‑workout exercises; add from library.

- **Exercise Picker**: quick selection for swapping exercises.

- **Notes**: jot down workout notes.

- **Tempo**: tempo and rest supportive UI.

- **Plate Calculator**: quick math for barbell loading.

- Equipment & gym preferences

- In Settings (Workouts), select equipment you have access to (e.g., dumbbells, barbells, machines).

- These preferences inform future workout suggestions and planning.

Tip: The workout tools listed above exist today as lightweight screens and will continue to evolve. They’re designed to be additive and won’t disrupt your current data.

---

Nutrition (in depth)

- Nutrition Today

- Log meals across Breakfast, Lunch, Dinner, and Snacks.

- Add foods via Quick Add (kcal/P/C/F), Quick Search (Your Foods, Recents, built‑ins, online), or **Scan** (UPC barcode) and **Scan Label** (OCR).

- Live totals and remaining macros relative to your targets.

- Energy Balance card shows surplus/deficit vs target for recent days.

- Quick Search

- Type 3+ characters to see Your Foods, Recents, and built‑in suggestions.

- Online search augments results when needed.

- Confirm unit/amount in the selection sheet; we compute macros for you.

- Scanning

- **Scan UPC**: normalizes UPC‑A/EAN‑13 and looks up product data.

- **Scan Label**: pick a photo of a nutrition label; OCR extracts common fields and serving size.

- Recipe Builder (optional tool)

- Enable in Nutrition Settings → Tools → “Enable Recipe Builder.”

- Add ingredients by typing, searching, or scanning.

- The app computes totals and **per‑serving** macros as you edit servings.

- Tap **Add to Today…** to log N servings to a chosen meal (a toast confirms the add).

- Reorder ingredients (Edit) and delete via swipe.

---

Settings

- Dashboard Settings hub

- Open the gear icon on the Dashboard.

- **Workouts**: opens your workout settings (rest timers, mesocycle defaults, behavior, equipment).

- **Nutrition**: opens Nutrition Settings (display preferences, rounding, logging behavior, Health, reminders, tools like Recipe Builder).

- Workouts Settings (examples)

- Default rest timer (with “beep last 3 seconds” option)

- Mesocycle defaults: goal, sets per exercise, rep range, intensity, RPE, tempo

- Behavior: auto‑start rest after log, auto‑advance in supersets

- Device: prevent sleep during workout

- Equipment: select what your gym has (free weights, cables, machines, accessories)

- Nutrition Settings (examples)

- Display: show macros as %, kilojoules, emphasize remaining, compact cards, high‑contrast bars

- Rounding: rounding mode and gram rounding increment (display‑only)

- Logging: warn on duplicates, confirm large adds (threshold), prefer last serving size

- Behavior: prevent sleep in Nutrition, refresh on appear, show “Open Today” button

- Health: write to Health (OFF by default), read from Health if local empty

- Reminders: enable reminders; edit reminder times (CSV)

- Tools: toggle Recipe Builder and open it

All Nutrition settings use `nutrition.*` keys and won’t affect workout settings.

---

Health & Privacy

- Health integration is **OFF** by default.

- If enabled, the app can write day totals once (guarded to avoid duplication) and optionally read totals when local logs are empty.

- Camera access is used for barcode and label scanning; label OCR runs on‑device.

- Your Foods, Recents, and Today’s log are stored locally. Shortcuts/App Intents use an App Group container for safe communication.

- We do not sell your data and do not track you for advertising.

---

Permissions

- Camera: required for barcode and label scanning

- Photos (optional): needed only when you choose a photo for label OCR

- Health (optional): read/write dietary energy/macros if you opt in

If permissions are denied, related features are hidden or gracefully disabled.

---

Troubleshooting

- Barcode not found

- Try scanning again; we normalize UPC/EAN formats.

- Some products may not be in the database yet. Use Quick Search or manual entry.

- Scanner won’t open

- Check Camera permission in iOS Settings > B Strong > Camera.

- No data after enabling Health

- Confirm Health permissions in iOS Settings > Privacy & Security > Health > B Strong.

- “Write to Health” should be ON to save; “Read” needs share permissions.

- Workout charts look empty

- Ensure you have logged sets; volume analytics populate as you train.

- Adjust the date range or choose **All** to see your full history.

- Totals look off (Nutrition)

- Ensure unit/amount are correct when adding items.

- For recipes, verify grams and per‑100g vs per‑serving inputs.

- App Intents not working

- Open the app once to initialize shared data.

- Check that App Group entitlements are active on your installed build (dev/test builds only).

---

FAQ

- Can I log net carbs?

- Yes. There’s a preference to display/use net carbs in selection flows.

- Can I export my data?

- Not in the first release. We plan to offer exports (CSV/JSON) in a future update.

- Does the app track me?

- No. We don’t use third‑party tracking or ads.

- Will recipes or workouts sync across devices?

- Not yet. Future versions may add iCloud sync for recipes and logs.

- Does the app work offline?

- Yes, but online product lookups require a connection.

---

Accessibility

- High‑contrast macro bars (toggle in Nutrition Settings)

- Large touch targets and readable type

- VoiceOver‑friendly labels across key flows

- Ongoing accessibility improvements planned

---

Known Limitations (Initial Release)

- Some barcode items may be missing or incomplete (coverage is expanding).

- Label OCR works best with clear, high‑resolution photos in good lighting.

- Widgets and watch app are planned for a later release.

- Recipe saving/persistence is not yet implemented; adding to Today works today.

---

Contact Support

If you need help, have feedback, or want to report a bug, please reach out.

- Email: tim@timmarcusfitness.com

- Include (if possible):

- App Version and IOS version

- Device model

- Steps to reproduce the issue

- Screenshots or screen recordings (optional)

- Whether Health/Camera permissions are enabled

We typically respond within 1–2 business days.

---

Version & Changelog

- Version: 1.0 (Initial App Store release)

- Highlights:

- Dashboard with Workouts/Nutrition

- Workout analytics: Total Volume, Volume by Muscle Group, range presets, custom ranges, group chips

- Macro Calculator and Strategy

- Nutrition Today with Quick Add, Quick Search, Barcode & Label scanning

- Recipe Builder (optional) with per‑serving macros and Add to Today

- Dashboard Settings hub with separate Workouts and Nutrition areas

- Health integration (optional, off by default)

- App Intents for Add Food and Query Remaining (optional)

For future updates and release notes, check the App Store page or your website.