User Guides

Download the App
Wellew is available on iOS and Android. Open the App Store or Google Play Store, search for Wellew, and tap install.

Create Your Account
You can set up your account in under 30 seconds using either method:

• Email: Tap Create Account, enter your email, and choose a secure password (at least 8 characters). Verify your account by tapping the confirmation link sent to your inbox.
• Google: Tap Continue with Google and select your preferred account for password-free registration.

Tip: If you already have an account, tap Log In and sign in using your existing credentials.

On your first launch, Wellew guides you through a quick, four-step setup to establish your personal metabolic profile.

1. Physique Data
Enter your weight, height, age, and sex. Wellew supports Metric (kg/cm) and Imperial (lb/ft-in) units—toggle your preference anytime in the top-right corner.

2. Goal Calculator
Select your focus:

• Lose weight: Targets a sustainable calorie deficit.
• Maintain weight: Equates daily target calories directly to your TDEE.
• Gain muscle: Builds a protein-focused calorie surplus.

Choose your pace: Gentle, Moderate (recommended), or Aggressive.

3. Activity Level
Select the tier that matches your routine: Sedentary (minimal exercise), Lightly active (1–3 days/week), Moderately active (3–5 days/week), Very active (6–7 days/week), or Extra active (demanding job & daily training).

4. Macro Split
Pick a preset distribution plan or select Custom to enter your own percentages:

• Balanced: 30% protein, 40% carbs, 30% fat.
• Low Carb / High Protein: 40% protein, 20% carbs, 40% fat.
• High Carb / Moderate Protein: 25% protein, 55% carbs, 20% fat.

Tip: Re-run the goal calculator anytime via Settings → Goals & Targets.

Adjust your goals manually to align with your personal preferences.

Where to Find Targets
Tap the gear icon ⚙️ (top-right of the dashboard) to open Settings, then tap Nutrition Targets to configure:

• Daily Calories: Your baseline energy budget.
• Macros: Modify targets in grams or percentage splits (adjusting one automatically recalculates the other).
• Fiber: Digestive targets (defaults to 25g for women, 38g for men).
• Water: Your hydration targets in liters or ounces.

Tip: Toggle the Daily Schedule option to set different targets for weekdays and weekends—perfect for customizing your training and rest-day routines.

Wellew offers three quick ways to track your food. Choose the one that works best for your meal:

1. Manual Search (Great for home cooking and single ingredients)

1. Tap the + button at the bottom of the screen or an empty meal slot.
2. Tap Manual Entry.
3. Type your food (e.g., "chicken breast") in the search bar.
4. Select the match, adjust the serving size, and tap Add to Log.

2. Barcode Scanning (Great for packaged foods, snacks, and drinks)

1. Tap the + button and select Scan Barcode.
2. Point your camera at the barcode on the package.
3. Verify the details, adjust the serving size, and tap Add to Log.

3. Photo Logging (Great for restaurant meals and plated dishes)

1. Tap the + button and choose Photo Log.
2. Snap a top-down, clear photo of your plate in good lighting.
3. Wellew's AI identifies the foods and estimates portions. Review and tap Confirm & Log.

Manage your logging and date navigation easily with Wellew's layout zones.

Daily Food Log Cards
Food entries are grouped into four collapsible sections: Breakfast, Lunch, Dinner, and Snacks. Tap any card header to expand or collapse it. To add an entry directly to a section, tap the + button on its header card. Swipe left on any logged item to delete it.

Date Navigation
Browse your history using the interactive calendar strip at the top. Swipe left or right to switch days instantly. Today is highlighted with a filled accent circle, and dates with logged meals display a small dot underneath.

Calming Animated Background
Shifting ambient gradients mimic natural light patterns throughout the day. This visual is designed to be battery-efficient; however, you can toggle it off in Settings → Appearance if you prefer a static background.

Video: Navigation & Interface Guide

Tap the Summary tab at the top of the Home screen to view a visual breakdown of your daily macronutrients.

The Progress Rings
Three circular rings track your daily macro targets in real time:

• Protein (Green): Grams consumed toward your daily goal.
• Carbohydrates (Blue): Grams of carbs logged.
• Fat (Amber): Grams of fat logged.
• Calories (Center): A unified summary ring showing total daily energy progress.

Interacting with Rings
Tap any macro ring to expand it into a detailed progress sheet showing exact remaining targets and calorie splits. The rings fill clockwise as you log meals. If you exceed 100% of a target, the ring color shifts slightly to indicate the overflow.

The Streaks panel helps you build consistent habits by tracking consecutive logging days.

Streak Rules
Logging at least one food item on a calendar day keeps your streak active. Streaks update according to your local timezone, starting fresh at midnight. Missing a full day resets your active streak to zero, but your lifetime record is saved permanently.

Tracking Elements
Check your progress via these key stats:

• Active Streak (🔥): Your current consecutive tracking run.
• Best Streak: Your all-time record.
• Streak Calendar: A rolling 7-day mini-map showing green for logged days and grey for missed ones.

Reaching consistency milestones (such as 7, 14, 30, or 60 days) triggers milestone badges and celebratory support from your AI Coach.

Stay on top of your daily hydration goals with quick-tap water entries.

Logging Hydration
Under the central water droplet icon (💧), the status bar changes color as you log:

• Blue: Under 50% of your target.
• Green: 50% to 99% of your goal.
• Gold: 100% or more (goal met).

Tap the + button on the tracker to log with quick presets (250 mL, 500 mL, 1 L) or tap Custom to enter a specific volume. Change default units between liters and ounces in Settings.

7-Day Hydration History
Below the daily tracker, a vertical 7-day bar chart shows your weekly performance against a horizontal goal line. Bars are color-coded (blue below goal, green at goal). Tap any bar to view logs for that date.

Quickly reorganize your daily food timeline using drag-and-drop actions.

Within a Meal Category
Tap, hold, and drag the six-dot handle (⋮⋮) on the right of any food card to move it up or down in its current category (e.g., Breakfast).

Between Meal Categories
Touch, hold, and slide the six-dot handle (⋮⋮) of any food entry across category borders. The destination header (such as Lunch) highlights when it's ready to accept the item. Release to drop, and the macro subtotals for both categories recalculate instantly.

Category Headers & Undo Toast
You can also drag the category headers themselves to rearrange the order of your daily feed. If you make an accidental move, a temporary Undo toast appears at the bottom of the screen. Tap it within three seconds to revert your last change.

Learn about Wellew's dynamic visual transitions and space-saving layouts.

Collapsing Navigation Bar
To maximize screen space, the calendar navigation block smoothly slides up and fades as you scroll down your daily timeline, leaving a compact date badge in the top bar. Scrolling back up restores the full calendar bar.

Animated Gradient Highlights
Cards and progress meters use subtle animations to indicate logs and shifts in macros. If you prefer a completely static UI, toggle off these transitions under Settings → Appearance → Reduce Animations.

Modify already-logged items with custom serving sizes, dates, and detailed nutrient data.

Slide-In Editing Sheet
Tap any logged item card to open its detailed editing sheet. You can customize:

• Food Parameters: Edit names, select new meal categories, or adjust logged times.
• Serving Adjustments: Fine-tune weight measurements directly via the number pad, slide indicators, or using the plus (+) and minus (-) increment keys.
• Quick Add & Favorites: Tap the heart icon to save the item to your favorites lists.
• Inline Notes: Add personalized comments (e.g., brand names or prep details) to display inline inside your daily log.
• Photo Re-Analysis: For photo entries, tap Reanalyze to have Wellew re-evaluate the original photo with updated AI models.
• Deletion: Tap the trash icon at the bottom of the panel to remove the entry from your daily log.

The Coach has a deep understanding of your habits. Every time you ask a question, the Coach automatically analyzes your recent food logs, water intake, and personal settings to provide an accurate response. It can:

• Identify Trends: Ask questions like "What do my trends look like this week?" to get an instant summary of your average intake and see specific days where you exceeded or stayed within your goals.
• Provide Encouragement: The Coach recognizes consistent habits and offers positive reinforcement to keep you motivated.
• Contextual Awareness: Because the Coach automatically reviews your data, it knows your history without you having to remind it.

You can chat with the Coach just like a real person to get instant guidance:

• Meal Planning: Ask for meal ideas based on your remaining macros for the day.
• Workout Guidance: While the Coach focuses on nutrition, it can offer general exercise suggestions. If you tell it your schedule (for example: "I only go to the gym on Tuesday and Friday"), it can suggest complementary activities like bodyweight routines for your off-days.
• Scope of Knowledge: To keep you on track, the Coach is designed to focus on your health and nutrition. If you ask unrelated questions (such as "What is the 2nd Pokemon?"), the Coach will politely redirect you back to your food and drink intake.

Sometimes typing out a meal is too much work. Use the Plus (+) icon in the chat bar to share visuals with your Coach:

• Take Photo: Snap a picture of your plate or a menu in real time.
• Photo Library: Upload an existing image from your phone.
• AI Insight: The Coach will analyze the photo to identify food items and provide you with the best options for logging them or fitting them into your daily budget.

Getting back to your dashboard is simple, with multiple options to suit your preference:

• The Close Button (Top Right): Tap the X icon in the top right corner to instantly close the Coach and return to the Today dashboard.
• Home Shortcut (Bottom Left): Tap the Coffee icon to jump directly to your Today summary screen.
• Dashboard Shortcut (Bottom Left): Tap the Sparkle icon to go straight to your Nutrition Logging page.

Personalized Recipes is currently under development!

We are building an intelligent recipe engine designed to suggest personalized meals that align with your real-time remaining macros, dietary preferences, and logged food habits. Stay tuned for future updates—we cannot wait to share this with you!

The analytics dashboard outlines your metabolic macronutrient trends. These graphs update dynamically as new items are added to your daily timeline.

Macro Progress Charts
Three stacked, interactively scrollable area charts track daily nutrition:

• Protein Chart (Green): Daily collected protein grams.
• Carbohydrate Chart (Blue): Daily carb mass progress.
• Fat Chart (Amber): Daily fat accumulation metrics.

Each progress chart features a dashed baseline target line pulled directly from your onboarding goals, showing which days hit targets. Hovering or tapping individual points opens a micro-tooltip outlining raw quantities.

How to Access & Preset Ranges
Tap the Analytics tab on the bottom menu bar. By default, the trending blocks represent a rolling 7 Days. You can expand ranges using the dashboard headers to choose between 14 Days, 30 Days, or select custom dates for extended reviews. Gaps caused by missed logging dates are bridged with dashed trend lines to avoid fragmented charts.

Video: Reading Your Macro Trends

Access predictive models that project your future weight metrics and long-term milestones.

Projected Weight Curves
By contrasting daily caloric intake against calculated BMR and active energy coefficients (TDEE), Wellew projects your trajectory curve over a 4, 8, or 12-week future horizon. This displays:

• Baseline Scale: Your initial weight metrics recorded when you first logged in.
• Current Status: Your last-recorded physical weight check.
• Trajectory Path: A LOESS-regression smoothed dashed projection line modeling weight over time.
• Milestone Date Estimation: Calculates the exact day you will reach your weight goal if current energy balances remain consistent.

Extended Analytics & Custom Ranges
Navigate to the Analytics tab to set target weights and see predictions recalculate instantly. Explore comparison charts (e.g., this month vs. last month), macro distribution donuts, and rolling averages (7, 14, or 30-day overlays) to filter out single-day fluctuations.

The Velocity section measures your rate of physical and nutritional change week-over-week, converting raw numbers into a clear momentum score.

Key Velocity Indicators

• Weight Velocity: The positive or negative change in scale metrics per week (e.g., -0.5 kg/week), marked by direction arrows.
• Calorie Velocity: The average daily caloric deficit or surplus over the active timeline.
• Macro Velocity: Percentage changes in macro splits week-over-week. Green arrows indicate progress toward targets, while red arrows indicate moving away.
• Trend Direction Badges: Dynamic markers labeling progress as Accelerating, Steady, or Slowing, calculated using second-derivative trends.

Data Prerequisites
Navigate to the Velocity section under Analytics. Each card features a sparkline reflecting a 4-week history. Note that velocity trends require a minimum of 14 consecutive days of logging; a placeholder will display while initial data is being gathered.

Below the primary trend charts, a specialized metric grid highlights daily habits, eating windows, and metabolic consistency.

1. Energy Rhythm
This card tracks the window between your first and last log of the day. It displays average hours (e.g., "10:15 AM – 7:30 PM, 9h 15m") along with a donut chart showing daytime vs. evening calories. Color codes: green (under 12 hours), amber (12–14 hours), and red (above 14 hours).

2. Water Intake
Tracks your 7-day average water consumption against your daily goal. It features a progress ring (green at ≥90%, amber at 50–89%, red below 50%) and a mini bar chart displaying daily progress relative to your target line.

3. Consistency Map
Shows the percentage of days in your selected range where you logged at least one meal. Uses a block heatmap (green for logged, hollow grey for empty) and shows your best logging streak.

4. Metabolic Rhythm (Caloric Variance)
Calculates the Coefficient of Variation (CV%) in your daily calories. Lower values (≤15%, green) mean steady intake, while higher values (above 25%, red) indicate erratic or "feast-or-famine" eating patterns. Points are mapped on a scatter plot against your daily goal line.

5. Macro Shift
Uses stacked bars to show week-over-week changes in macro splits. It highlights shifts in overall diet composition (such as rising protein and falling carbs) with direction indicators and numeric delta badges.

Wellew features two interactive buttons on each metric card to help you turn data insights into sustainable habits.

The FOCUS Action
Tapping the FOCUS button launches a short-term, 1–7 day focus target. The AI analyzes your recent logs and suggests a personalized challenge, such as limiting late-night eating or increasing afternoon hydration. Tapping Start Focus highlights the card with a progress ring, and you will receive a performance comparison at the end of the challenge.

The GOAL Action
Tapping the GOAL button sets a permanent or long-term target. Adjust your goals with sliders, set target completion dates, and track your progress with a circular countdown badge on the metric card.

FOCUS & GOAL Reference Options

Video: Setting Goals & FOCUS Modes

Wellew lets you export your analytics data as a PDF report or a raw CSV file for offline review, data analysis, or sharing with a coach.

Configuring Your Export
Tap the Export icon (📤) in the top-right corner of the Analytics screen to open the options panel. From here, you can customize:

• Date Range: Choose from presets like 7 Days, 30 Days, 90 Days, Custom Range, or All-Time.
• PDF Format (.pdf): Best for printing and sharing. Generates a report with visual charts, summaries, and AI Coach notes.
• CSV Format (.csv): Best for spreadsheets. Generates a raw database file detailing daily calories, macronutrient weights, hydration volumes, and logged weight entries.
• Include Toggles: Choose exactly what to include in your export, such as Macro Charts, Projected Weight, Velocity Metrics, Metric Grid Cards, Daily Tables, or Coach Notes.

Generating the Export
Once configured, tap Generate Export. PDF reports build in-app and can be shared immediately via system tools like AirDrop or email. CSV files download directly to your local device sandbox or Downloads folder.

The Settings screen acts as the central control panel for Wellew, letting you customize your profile, fine-tune nutritional goals, connect external devices, and manage backup data.

Accessing the Hub
Tap your profile avatar or the gear icon in the top navigation bar of any main screen, then choose Settings. The interface presents a clean, scrollable list of 15 configuration sub-pages grouped under four categories:

• Profile: Account handles, emails, verification steps, and your metabolic calculator.
• Nutrition: Calorie goals, water tracking targets, and AI Coach configurations.
• App Parameters: Dynamic notifications, wearable integrations, unit switchers, theme controls, and language settings.
• Data Systems: Cloud synchronization, manual data exports, raw imports, and backup management.

Quick Row Indicators: Many items in the settings list display their current active value directly on the right (such as your current username, calorie target, or theme mode), allowing you to review your configurations at a glance.

Your personal profile page controls the identifiers used for account recovery, dashboard personalization, and community features.

Profile Identifiers

• Display Name & Handle: Tap Name or Username to customize. Your display name appears in coach messages and summary cards, while your handle represents your unique identifier for community features. Handles must be between 2 and 30 characters.
• Primary Contact Fields: Your email acts as your unique account ID, used for password resets and receipt delivery. Your phone number can optionally be linked to enable secure SMS-based sign-ins and reminders.
• Profile Photo: Tap the avatar circle to snap a new photo, select one from your library, or pick from our preset illustrations. This photo appears on your dashboard, sharing cards, and in coach conversations.

Account Verification Security: To keep your account secure, updating your email or phone number triggers a verification process. You must enter a one-time code sent to your new address/number to finalize changes, and your original contact method remains active until this check is completed.

Video: Profile Photo & Account Verification

The Goal Calculator automatically determines your custom nutrition targets, metabolic rates, and weight progress based on your body metrics and daily physical activity.

Inputting Body Metrics
Switch units between Metric (cm, kg) and Imperial (ft/in, lb) using the top toggle. You can customize Sex, Age (10 to 120), Height, and Weight using the on-screen scroll wheels or the keyboard.

Activity Level & Deficit Tuning
Select one of our five activity categories (Sedentary, Lightly Active, Moderately Active, Very Active, Extremely Active) and choose your target outcome (Lose Weight, Maintain, or Gain). You can adjust your caloric deficit or surplus from 10% to 50% using the slider to fine-tune your target pace.

Macro Presets & Outputs
Choose from our pre-defined metabolic splits or create a custom layout:

• Balanced: 40% carbs, 30% protein, 30% fat.
• High Protein: 45% carbs, 30% protein, 25% fat.
• Low Carb: 20% carbs, 40% protein, 40% fat.
• Keto: 5% carbs, 25% protein, 70% fat.

The calculator displays your computed results at the bottom of the page, including your BMI, BMR, TDEE, target water volumes, and weight projections for 4, 8, and 12 weeks. You can override these recommendations at any time by entering custom targets in your settings, which will be marked with a "Custom" badge.

Wellew lets you customize your nutrition goals beyond calories and core macros, offering fine-grained control over 31 distinct micronutrients.

Macronutrient Calibration (5)
Review and adjust your daily targets for Calories, Protein, Fat, Carbohydrates, and Fiber. Setting manual values here overrides your calculated baseline and applies a Custom badge to your dashboard indicators.

Micronutrient Customization (31)
Expand the micronutrient section to view RDA-based daily targets for 31 essential nutrients. You can customize targets for:

• Vitamins (13): Vitamin A, B1 (Thiamine), B2 (Riboflavin), B3 (Niacin), B5 (Pantothenic Acid), B6, B7 (Biotin), B9 (Folate), B12, C, D, E, and K.
• Minerals (13): Calcium, Chromium, Copper, Iodine, Iron, Magnesium, Manganese, Molybdenum, Phosphorus, Potassium, Selenium, Sodium, and Zinc.
• Others (5): Cholesterol, Omega-3, Omega-6, Saturated Fat, and Trans Fat.

Target Visibilities: Only nutrients with active, non-zero targets will appear in your daily logs and analytics tables. Setting a nutrient's target to zero hides it to keep your dashboard clean. Tap Reset to Defaults at the bottom of the page to restore your initial onboarding values.

Video: Customizing Vitamins & Minerals

Customize which alerts Wellew sends to your device and set precise schedules for meal and hydration reminders.

Notification Category Controls
You can toggle individual notification types on or off to suit your preferences:

• Meal Reminders: Set custom reminders to log your Breakfast, Lunch, Dinner, or Snacks.
• Water Reminders: Set interval-based reminders to log your water intake throughout the day.
• Streak Milestones: Receive celebratory notifications when you reach logging streaks (7, 14, or 30 days).
• Weekly Summary: Receive a summary of your weekly nutritional progress every Sunday evening.
• Coach Messages: Receive push notifications when your AI Coach replies to your messages.
• Goal Progress: Receive progress alerts when your daily intake reaches 75%, 90%, or 100% of your targets.

Scheduling Alerts & Sounds
Tap any notification type to customize its schedule. For water reminders, you can define your active hours (such as 8:00 AM to 10:00 PM) and set repeat intervals for every 15, 30, or 60 minutes. You can also customize notification chimes and toggle app icon badges at the bottom of the screen.

Video: Setting Log Reminders

Connect Wellew with third-party platforms and wearable devices to automatically import weight metrics, workouts, and food databases.

Health Platform Connections
Link with Apple Health (iOS) or Google Health Connect (Android) to share data across apps. Wellew can read active energy, resting energy, water intake, and body weight, and write food logs and water data back to your primary health platform. You can toggle read/write permissions for each metric individually.

Wearables & Smart Scales
Connect external hardware under the Wearables menu:

• Smart Scales (Withings): Automatically import new body weight measurements into your Wellew logs after weighing in.
• Wearables (Fitbit / Garmin): Import active calorie burn metrics to dynamically adjust your daily energy expenditure.

Food Database Integrations: Link your account with MyFitnessPal or Cronometer under Database Sync to import custom recipes and ingredients directly into your personal food library.

The Data Management screen lets you back up your history, restore files, and manage your data's lifecycle.

Export & Share
Export your data as a backup or to share with a coach. Tap Export Data to generate a .csv or .json archive of your food logs, water logs, weight measurements, and meal plans. You can select date ranges (All-Time, 30 Days, 90 Days, or Custom) and share the file directly via AirDrop, email, or save it to your device's Files folder. Tap Share Summary Card to save a styled image of your daily stats to share on social media.

Device & Cloud Synchronization
Wellew automatically syncs your data to the cloud when you are signed in, keeping your history updated across multiple devices. The sync panel displays the status and the last active timestamp. You can tap Force Sync Now to sync pending changes immediately if you are working offline.

Importing Backups
Tap Import Data to restore a previously saved JSON or CSV archive. The Import Wizard allows you to choose which types of data to restore (such as food logs, custom recipes, or weight measurements) and displays a preview before running. Duplicate entries are automatically detected and skipped to keep your history clean.

Caution: Importing data will overwrite existing records that share the same timestamp. We recommend exporting a fresh backup of your current history before running a large import.