Everything you need to know to get set up and get the most out of it.
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.
You do not need to connect everything. Even one integration is enough to get started.
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.
Your first sync may take a minute or two if you have a lot of history.
The Feed is the first thing you see when you open FitMesh.
It shows a combined timeline of everything — workouts, habit completions, nutrition days, personal records and weekly summaries.
Workout cards expand to show the full breakdown: duration, exercises, sets and volume.
A daily inspiration quote appears at the top of the most recent day. Enable it and pick a tone (Kick Ass, Zen, Sweary, and more) from the settings cog on the card.
Scroll down and click "Load older activity" to see further back.
Weekly summary cards appear automatically at the end of each complete week.
The Feed pulls from all your connected apps and manual logs so you get one picture of everything. Daily Inspiration is AI-generated and counts toward your daily AI usage (2 per day on the free plan, 5 on PRO).
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.
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.
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.
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 7-day and 30-day compliance percentage alongside the streak — useful for seeing consistency over time, not just whether you're on a current run.
To edit an existing habit — including frequency, trigger, or targets — click the pencil icon.
Tick habits off manually for anything FitMesh cannot detect automatically.
Set habits up before you sync for the first time and FitMesh can back-fill completions from your history.
Click your avatar → Records to see your personal bests.
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.
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.
For cardio records to include pace and distance, make sure your workouts include distance data. Manual runs need a distance entered to get pace and distance records.
Go to the Nutrition tab to log your meals.
Click + Quick Log 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).
Add foods to Breakfast, Lunch, Dinner or Snacks.
Set your daily calorie and macro targets in Nutrition Settings.
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.
Copy a meal or an entire day of food to a different date using the copy buttons on each meal.
Track your water intake with the water ring — click + to add a glass (250ml).
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 a number. Negative values and non-numeric text are rejected with a clear error message.
The calorie ring turns red if you go over your daily target. AI features reset at midnight UTC each day.
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. Great for meals you eat often — like your usual breakfast.
When adding food, open the ⭐ Favourites tab to see both your starred individual foods and your saved meals. Starred foods show the default serving — click to adjust quantity, then log in one click. Saved meals log all items at once.
Go to Library → Recipes to build custom recipes. Click + Create recipe, give it a name, set the number of servings, then describe the dish in the text box. AI parses it into a full ingredient list with macros. Adjust quantities per ingredient — macros rescale automatically. Check the per-serving totals, then save.
Saved recipes appear in Library → Recipes and can be logged to any meal from there.
Starring a food only requires that it was logged via AI at least once (so it exists in your library). Foods logged from the Open Food Facts search database can also be starred from the library.
The Wellbeing menu (in the top nav) contains: Daily steps, Sleep, Recovery, Body measurements and Habits.
Body measurements: log weight, height, body fat %, waist, chest and more. FitMesh tracks trends over time and shows a weight chart. Log from the + button on the Body measurements screen.
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.
Recovery data requires a compatible device (Polar or Fitbit). Sleep and HRV sync automatically after each night — no manual logging needed.
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 or save as PDF using the buttons in the toolbar.
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 are upgraded to PRO, your full history becomes visible immediately — no need to re-sync anything.
Your data is yours. Downgrading from PRO to free never deletes anything — it just limits what is visible until you upgrade again.
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.
Daily Inspiration: a personalised AI recap of yesterday's workouts, habits and nutrition in your chosen tone. Free: 2/day. PRO: 5/day. Cached so refreshing the page does not use a credit.
All limits reset at midnight UTC. The remaining count is shown next to the relevant button so you always know where you stand.
Limits are per user per calendar day (UTC). A blocked request returns a clear message telling you when the limit resets.
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.
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.
AI scan credits reset at midnight UTC each day.