How to use FitMesh

Go to the Integrations tab in the dashboard (click your avatar → Integrations).

Click Connect next to each app you use.

Strava, Polar, Google Fit and Fitbit use OAuth - you will be redirected to sign in and approve access.

Hevy uses an API key - find it at Profile → Settings → API in the Hevy web app. A Hevy Pro subscription is required to access the API.

You only need to do this once. FitMesh remembers the connection.

Click the ▼ on any connected app to expand a drawer showing exactly what FitMesh has pulled from it - counts of workouts, step days, sleep nights, heart rate samples and weight logs - with quick links to jump to each view.

After connecting an app, hit the Sync button next to it.

For a full history going back months or years, use the Full Historical Sync option at the bottom of the Integrations tab.

Regular syncs happen automatically when you use the app.

You can also trigger a manual sync at any time from the dashboard header.

The Feed is the first thing you see when you open FitMesh.

It shows a combined timeline of everything - workouts, habit completions, nutrition days (with water intake), personal records and weekly summaries.

Workout cards expand to show the full breakdown: duration, exercises, sets, volume, location and any notes you logged.

A daily inspiration quote appears at the top of the most recent day. Enable it and pick a tone (Kick Ass, Zen, Sweary, Stoic, Science Nerd, Comedian, Cheerleader, Pirate Captain, Grandma, Best Friend, Noir Detective, Sports Commentator, Fantasy Sage, and more) from the settings cog on the card. It reads your workouts, habits, nutrition, journal, body weight trend, medications, sleep and any personal records you set that day to write something specific to your day - and if you have a calorie/protein target or goal weight set in Nutrition Settings, it factors in how close you are to hitting them.

If you have Fitbit, Polar, or Google Fit connected, a 👣 daily step count card appears below your workout cards each day, showing your total steps for that day from your device's daily aggregate.

Any day you've logged a Journal entry gets a 📓 card in the Feed showing your mood, energy and stress, any quick tags, and your note - the same wellbeing history shown in the Journal tab, surfaced alongside your workouts and nutrition for that day.

Logging a body weight measurement or a medication dose also gets its own card in the Feed - a ⚖️ card showing the weight (and any note) for a weigh-in, and a 💊 card listing each medication taken that day.

If you have a sleep-tracking device connected (Polar or Fitbit), a 😴 card shows your total sleep duration for the night.

Scroll down and click "Load older activity" to see further back.

Weekly summary cards appear automatically at the end of each complete week.

The Training tab shows a detailed view of your training history with stats.

Use the period selector at the top to switch between This week, Last week, 2 weeks, 4 weeks, Last month, This year and Last year.

The stats bar above the list updates automatically to show totals for the selected period - including workout count, active time, avg daily calories, avg protein, avg mood/energy/stress, and avg daily water intake.

Click any workout card to expand it and see the full details from each source.

Duplicates are removed automatically. If two apps recorded the same session, you only see it once.

Use the + Log training button to add a manual session.

Go to Wellbeing → Habits and click the + button to create a new habit.

Give it a name, choose how often (daily, weekly, specific days, or X times per day), and optionally set an auto-complete trigger.

Auto-complete means FitMesh will tick the habit off for you when it detects you have done it. For example, a "Gym session" habit can auto-complete whenever a strength workout syncs. Available auto-complete triggers include workout types (strength, running, cycling, etc.), Sleep (ticks when sleep data meets your hour target), Drink Water (ticks when you hit your daily water target), and Daily Steps (ticks when your synced step count meets the target set in the habit's Target Value field - defaults to 10,000 steps if not set).

Each habit supports three compliance tiers: a floor (non-negotiable minimum), a target (the actual goal), and a stretch goal. The weekly view shows which tier you hit each week. Floor, target and stretch values must be zero or higher and cannot exceed 100,000 (covering step-count targets up to 100k). Times-per-day/week habits are capped at 100 completions. If the habit is linked to sleep, the sleep target must be between 0 and 24 hours.

Habits that require multiple completions per day - like "drink water 8× daily" - track a count rather than a simple yes/no. Set your daily target and log each completion separately.

Each habit shows a rolling compliance percentage alongside the streak - useful for seeing consistency over time, not just whether you're on a current run. Click the "7d"/"30d" label to switch the badge between a 7-day and 30-day rolling window.

Hover over a habit and use the ▲/▼ arrows to reorder your habit list - handy for putting your most important habits at the top.

Going away for travel or illness? Open the pencil icon and expand "pause for travel / illness" to set a from/until date range - or use the 7 days / 14 days shortcuts. Paused days don't count against your streak or compliance percentage, so you won't lose progress while you're out.

To edit an existing habit - including frequency, trigger, or targets - click the pencil icon. Edits are validated the same way as creation: name cannot be empty or exceed 200 characters, numeric targets must be valid numbers within the allowed range, frequency must be one of the accepted options, and the sleep target (if set) cannot exceed 24 hours. The edit sheet also shows a 12-week history heatmap, so you can see at a glance which days you hit the habit, missed it, or it wasn't scheduled - plus a "Best day" line once there's enough history, showing which day of the week you're most likely to complete it, and a "Toughest day" line showing which day you're most likely to miss it.

Tick habits off manually for anything FitMesh cannot detect automatically.

Click your avatar → Records to see your personal bests.

A "This Month's Records" strip highlights any PR set in the current calendar month, followed by four "All-Time Top 5" leaderboards - ranked by estimated 1RM, session volume (most weight moved in one session), max reps in a single set, and best set (highest single-set volume) - the full searchable, sortable list of every exercise sits below under "All Records".

Strength records show your estimated 1RM, max reps, best set volume and highest session volume per exercise.

Cardio records show your longest distance, best pace and longest duration for running, cycling, walking and swimming. A "This Month's Cardio" strip highlights any cardio best set in the current calendar month, followed by "All-Time Top 5 - Longest Distance", "All-Time Top 5 - Fastest Pace" and "All-Time Top 5 - Longest Duration" leaderboards across all cardio sports, matching the strength records layout above it.

After your first sync, hit Calculate Records to process your full history.

Records update automatically when new workouts sync.

If the same exercise appears under slightly different names (e.g. "Leg Press" and "Leg Press Machine"), a 🔀 button appears on the card. Click it to merge the duplicates into one entry, keeping the best record value.

Expand any exercise card to see a progression chart of your estimated 1RM over your last 20 sessions for that exercise, alongside its volume milestones.

If it has been 60 or more days since your last PR on an exercise, a "days since last PR - needs a push" badge appears on that card so stalled lifts do not get lost among the ones you are progressing on.

Go to the Nutrition tab to log your meals. Use the ‹ › arrows to move between days - the day shown is the day you are logging for.

Click + Add Food Entry and pick a tab: 🔍 Search (Open Food Facts database - millions of products, no account needed), 📷 Photo (AI identifies your plate), ✏️ Describe (plain English), 📥 Import PDF (MyFitnessPal export), or ⭐ Favourites (starred foods and saved meals). On today, choose which day(s) to log or plan for. On a past day, it always logs directly onto that day - there is no future-planning picker, since a past day cannot be planned ahead of time.

Add foods to Breakfast, Lunch, Dinner or Snacks.

Set your daily calorie and macro targets in Nutrition Settings. Calories, protein, carbs and fat can each be toggled on or off with a target - fibre is available as a fifth optional macro, picked up automatically from barcode scans and Open Food Facts search. Targets must be non-negative numbers and cannot exceed 100,000 - if a value is out of range, a plain-English error names the specific field (e.g. "Calorie target must be a non-negative number"). The Log tab's Nutrition trends chart shows your calorie/protein/carb/fat history over 7, 30 or 90 days - once a calorie target is set, it also shows a 🔥 streak badge for consecutive days within ±15% of your goal, plus a personal-best badge for your longest run in the selected range.

Click any logged meal card to open it. Click ✏️ on an individual item to edit it - change the name, quantity or any macro. Changing the quantity automatically rescales protein, carbs, fat and calories using the original per-gram ratio. The same validation applies as when logging: quantity must be greater than 0 and no more than 10,000g, macros cannot be negative or exceed their per-item limits (calories ≤ 9,999 kcal, protein/carbs/fat ≤ 999g), and names cannot exceed 500 characters.

Copy a meal or an entire day of food to a different date using the copy buttons on each meal. When today's log is empty, a "📋 Copy yesterday's meals" button appears - tap it to instantly copy everything from yesterday into today. Below that, "📅 Copy meals from another day…" opens a date picker so you can copy a full day's meals from any past date (e.g. copying last week's meal plan) into today. In the Planner tab, the "⧉ Copy day" button copies both planned meals and any food already logged on that day - so nothing is left behind. Click "🛒 Shopping list for this week" at the top of the Planner tab to get a single consolidated list of everything you've planned that week, with recipe ingredients scaled to the servings you've planned and quantities for the same food combined across meals - copy it to your clipboard with one tap.

Track your water intake with the water ring - click + to add a glass (250ml). Water intake is logged in millilitres: the value must be a number between 0 and 10,000 ml. Log dates cannot be earlier than 1970 or more than 1 day in the future. Water also has its own tab in the Log tab's Nutrition trends chart, with the same 🔥 streak and personal-best badges as calories - here a day counts if you hit your daily water target, with no upper band.

To scan a barcode, click 🔍 Search then 📷 Barcode. Point your camera at the product barcode and it looks it up automatically.

To import a full diary from another app, click 📥 Import diary PDF and upload a MyFitnessPal (or similar) PDF export. FitMesh reads every entry and shows a preview. Choose which days to import before confirming. Uses 1 AI credit per import (free: 2/day, PRO: 10/day).

To log by description, click ✏️ Describe and type what you ate in plain English. AI breaks it into items with estimated macros. Tick what to keep and log in one click. Remaining AI parses for the day are shown next to the button (free: 10/day, PRO: 50/day).

To log by photo, click 📷 Photo and take or upload a photo of your meal. AI identifies every item on the plate and estimates portions and macros. Tick what to keep and log in one click. Visual estimates can vary - use Describe for more precise logging when accuracy matters. Uses 1 AI credit per photo (free: 3/day, PRO: 15/day).

Quantity must be greater than 0 and no more than 10,000g. Negative values, zero, non-numeric text, and quantities above 10,000g are rejected with a clear error message. Food item names are required and cannot be empty or exceed 500 characters. Log dates cannot be earlier than 1970 or more than 1 day in the future.

Every food you log via AI (Describe, Photo, or PDF import) is automatically saved to your personal library with the correct macros per 100g. There is nothing to do - it happens in the background.

Go to Library → Foods to see everything, organised into ★ Favourites, Recent, and All. Click any food to quick-log it to a meal without retyping anything.

Click the ★ star on any logged food row (inside a meal edit sheet) to save it as a favourite. Starred foods appear at the top of the Favourites tab whenever you add food.

Inside a meal edit sheet, click "★ Save as meal" to save the entire meal as a named bundle in one click. Saved meal names cannot exceed 200 characters, and each item quantity must be greater than 0 and no more than 10,000g. Great for meals you eat often - like your usual breakfast.

When adding food, open the ⭐ Favourites tab to see your starred individual foods, saved meals, and saved recipes. Starred foods show the default serving - click to adjust quantity, then log in one click. Saved meals log all items at once - hover a saved meal to reveal a ✎ edit button (adjust quantities or remove items) and a ✕ delete button, and double-click its name to rename it. Saved recipes log at their per-serving macros - adjust the servings stepper to log more than one.

Go to Library → Recipes to build custom recipes. Click + Create recipe, give it a name (up to 200 characters), set the number of servings (must be 1 or more), then either list ingredients in the text box and click ✏️ Parse ingredients (AI extracts macros from your list), or describe a dish name (e.g. "chicken stir fry") and click ✨ Generate recipe - AI creates the full ingredient list, macros, and cooking method for you. Adjust quantities per ingredient - macros rescale automatically. Check the per-serving totals, then save. Generate uses 1 AI credit per recipe (free: 3/day, PRO: 20/day).

Saved recipes appear in Library → Recipes and can be logged to any meal from there. Click ✎ on any recipe to edit its name, servings, or ingredients - the same builder used to create it, pre-filled with the current values.

The Wellbeing menu (in the top nav) contains: Daily steps, Sleep, Recovery, Body measurements, Habits, Journal and Medications.

Body measurements: log weight, height, body fat %, lean mass, waist, chest and more. FitMesh tracks trends over time and shows a weight chart, plus an up/down arrow on each snapshot card showing how much it has changed since your previous entry. Set a goal weight in Nutrition Settings and the weight trend chart shows a dashed target line plus how much you have left to lose or gain. Once you have logged a lean mass value, a separate Lean Mass snapshot card shows the same up/down trend. Once you have logged waist, chest or hip measurements, a separate Girth snapshot card shows the same up/down trend for those, and once you have logged bicep, thigh or calf measurements, a Limbs snapshot card does the same (left/right sides are averaged when both are logged). Log from the + button on the Body measurements screen. All measurement fields must be numbers - text values (e.g. "eighty kg") are rejected with a clear error. Valid ranges: weight 20–400 kg, height 50–250 cm, body fat 2–70%, lean mass 10–300 kg, girth measurements 10–250 cm. Clothing sizes (top/bottom) cannot exceed 50 characters and notes cannot exceed 500 characters. Dates cannot be earlier than 1970 or more than 1 day in the future. To correct a typo on a saved entry, tap the pencil icon - individual fields can be updated without deleting and re-logging the measurement.

If you have a Polar device connected, the Recovery tab shows your HRV, nightly recharge score and sleep data automatically after each night.

The Sleep tab shows sleep duration and quality data synced from connected devices (Polar, Fitbit).

Steps are synced from Google Fit, Fitbit or Polar and shown as a daily bar chart. A step habit (e.g. "10,000 steps") can auto-complete when your daily target is hit.

The macro calculator in Nutrition Settings pre-fills your latest weight and height from Body measurements automatically.

Journal: log daily mood (required, rated 1–5), energy and stress (optional, each rated 1–5), add quick tags (Sick, Tired, Stressed, Rest day, Travel, Period, Injury, Low energy), and write a free-text note up to 500 characters. Each entry is for a specific date - you can backfill past days. Click the pencil icon on any history entry to edit it, or the bin icon to delete it. Dates cannot be earlier than 1970 or more than 1 day in the future. Up to 10 tags per entry; each tag cannot exceed 50 characters. The month calendar at the top of the journal shows mood-coloured days - green for good, red for low. Click any day to filter the list to that date and pre-fill the log form. A small dot on a day means that entry has notes. Below the calendar, a search bar lets you filter entries by typing keywords - it matches against notes text and tags, so searching "Tired" shows all entries tagged Tired or mentioning it in notes. Below the calendar, a month summary shows your average energy, mood and stress for the visible month, journaling consistency (percentage of days logged), and your most-used tags - plus, once there's enough entries in the month, how your mood compares on days with your top tag versus days without it. A 🔥 streak badge appears next to the 7-day average once you have logged two or more consecutive days, plus a "PB:N" personal-best badge once your longest-ever run beats your current streak. Journal entries are read by Daily Inspiration - if you logged that you were sick or tired, the AI will acknowledge it in the recap rather than ignoring it. When you have a journal entry for today, a mood emoji and energy score also appear in the "Today so far" section of the inspiration card.

Medications: log any medication - from everyday pain relief (Paracetamol, Ibuprofen) and vitamins (Vitamin D, Magnesium) to prescription drugs and GLP-1 injections (Ozempic, Wegovy, Mounjaro). Record name, dosage with unit (mg / ml / mcg / g / IU / tablets / capsules / drops / units), and date taken. Choose the type: Regular (an ongoing medication you take routinely, such as blood pressure pills or vitamins) or One-off (taken as needed, such as Paracetamol for a headache). Your history is split into Regular and One-off sections so you can see at a glance which are routine and which were situational. Rate appetite effect from 1 (no change) to 5 (barely hungry) - once you have logged appetite on two or more doses, an appetite trend chart appears above your history showing the last 14 logged doses. Tag side effects from the quick-select list (Nausea, Headache, Fatigue, Drowsiness, Rash, and more). Add free-text notes up to 500 characters. If you have logged a medication before, it appears as a quick-tap chip at the top of the form so you can log a repeat dose in one tap - name, dosage and type are pre-filled automatically. Medication name is required; dosage, appetite and side effects are optional. Each Regular medication shows a 7-day and 30-day adherence badge (e.g. "Vitamin D: 6/7 days · 84% (30d)") above your history, so you can see at a glance how consistently you're taking it - the badge also shows "🔥 taken today" or "⚠️ Nd since last dose" once you've missed a day or more, so a gap is visible without doing the maths yourself. If any side effects were logged in the last 7 days (from any medication), a "This week" summary appears above your history showing each one and how many times it was reported. Regular medications also get a 🔔 bell next to their quick-log chip - tap it to set a daily reminder time, and FitMesh will send a browser notification if that dose has not been logged yet by then.

Click the Reports link in the top right of the dashboard header.

Your weekly report covers workouts, active days, calorie burn, habit completions and nutrition.

Use the date picker to select any period. Free plan users can report on the last 30 days. PRO users can go back up to 12 months.

Export to CSV, Excel (.xlsx) or save as PDF using the buttons in the toolbar. CSV export covers workouts, habits, nutrition, journal, body measurements, and personal records separately. The Excel export bundles a full workbook - summary, workouts, habits, personal records and nutrition on separate sheets - in one file.

Reports are great for sharing with a personal trainer as a check-in summary.

FitMesh is free to use. The free plan gives you the last 30 days of data across every tab: Feed, Workouts, Habits, Nutrition and Reports.

All your data is always stored in full. The 30-day limit is just what is shown - nothing is ever deleted.

On the free plan, longer period presets in Workouts (2 weeks, 4 weeks, Last month etc.) are shown as locked. Habits month view is also locked.

Upgrade to PRO to unlock up to 12 months of history, the full period selector, monthly habit view, and longer-range reports and exports.

PRO also unlocks higher daily limits on all AI-powered features - see the AI features section below for the full breakdown.

If you have a promo code, you can enter it during onboarding (the "Have a promo code?" link on the first screen) or later from Account settings. Promo codes unlock PRO for the duration specified by the code.

If you are upgraded to PRO, your full history becomes visible immediately - no need to re-sync anything.

FitMesh uses AI (Claude by Anthropic) for several features. Each is capped per user per day to prevent abuse - not to frustrate real users.

Describe food (✏️ Describe tab): type a meal in plain English and AI parses it into individual items with estimated macros. Free: 10/day. PRO: 50/day.

Photo food logging (📷 Photo tab): take or upload a photo of your meal and AI identifies every item on the plate with estimated portions and macros. Free: 3/day. PRO: 15/day.

Import diary PDF (📥 Import diary PDF): upload a PDF export from MyFitnessPal or a similar app. AI reads every entry and previews it for import. Free: 2/day. PRO: 10/day.

Workout scan (📸 photo of notebook): photograph a handwritten workout log and AI extracts all exercises, sets, reps and weights. Free: 3/day. PRO: 15/day.

Recipe generator (✨ Generate recipe): describe a dish and AI creates the full recipe with ingredients, macros and cooking method. Free: 3/day. PRO: 20/day.

Daily Inspiration: a personalised AI recap in your chosen tone. It reads your workouts, habits, nutrition, journal (mood, energy, stress, tags and notes), body weight trend, body fat % and waist trend, and any personal records set that day - so if you logged that you were injured or tired, or just hit a new 1RM, the AI knows and responds accordingly. If you have set a calorie/protein target or goal weight in Nutrition Settings, it also weighs in on how close you are to hitting them. Workouts synced via Strava are excluded from AI context (Strava API terms prohibit AI use of their data). 2 refreshes in the morning, 3 in the afternoon/evening - resets at noon and midnight UTC. Cached so refreshing the page does not use a credit. A 🕐 icon on the card opens your last 14 days of past messages, so a recap you liked is not lost the next day.

All limits reset at midnight UTC. The remaining count is shown next to the relevant button so you always know where you stand.

Go to the Training tab and click the + Log training button.

Choose the activity type, fill in the date, duration and any other details.

For strength sessions, add exercises and sets with weight and reps.

You can also take a photo of a workout notebook or gym whiteboard and FitMesh will read it for you. Uses 1 AI credit per scan (free: 3/day, PRO: 15/day).

For cardio activities, enter the distance so FitMesh can calculate your pace and update your records.

Rehab is split into two types: Rehab Appointment logs a treatment session (physio, chiro, massage) with pre- and post-session pain levels and notes but no exercise sets. Rehab Training logs a structured rehab exercise session with the same block/set editor used for strength sessions, plus pain levels.

Once you have two or more rehab sessions logged with pain levels, a pain trend chart appears at the top of the Training tab showing pre- and post-session pain over the selected period.

If a field shows a red error after saving, check that duration, calories, and heart rate are entered as numbers - text values are rejected. Duration must be between 0 and 1,440 minutes (24 hours), heart rate cannot exceed 250 bpm, reps per set cannot exceed 9,999, and weight per set cannot exceed 2,000 kg. Distance must be between 0 and 1,000,000 metres, and step counts must be between 0 and 100,000. Workout titles cannot exceed 500 characters, exercise names cannot be empty or exceed 200 characters, notes cannot exceed 1,000 characters, and location labels cannot exceed 200 characters. Editing a saved workout enforces the same rules as creating one, with the same plain-English error messages - including the ability to correct distance and step count after the fact.

Workouts imported from Strava, Hevy, Polar, and other sources also have an ✏️ Edit button. You can rename the workout, change the activity type, correct the date, add a location, or attach notes. Exercise sets are read-only for synced workouts - edit those in the source app and re-sync. Only manually logged workouts have a Delete option.

If a manually logged workout looks like it overlaps in time, duration, and activity type with a session already recorded - whether that's synced from another app or another manual entry you logged earlier - FitMesh shows a warning before saving so you do not log the same session twice. You can confirm "Save anyway" if it really is a separate session.

Open Account (click your avatar in the top right) to access Appearance settings.

Under Colour scheme, switch between Dark and Light mode.

Under Accent colour, choose from six highlight colours - Red (default), Violet, Blue, Teal, Amber, or Pink. The colour applies instantly across every button, ring, badge and progress bar in the app and is saved to your device.

Under Text size, pick from Small, Medium, Large or XL to scale the UI to your screen and eyesight.

Notifications from bug fixes and feature updates appear in the 🔔 bell in the header. Click the bell to see them - they are marked as read automatically. Click ✕ on any notification to dismiss it, or use Clear all to remove the whole list at once.