What You'll Learn

Where to find your daily habits on the Home screen
How to complete a yes/no habit
How to log a value for a number-based habit
How the hydration quick-add presets work
How to understand the completion badge and progress indicators

Step-by-Step Guide

Finding Your Habits

Open Gymkee on your phone
Tap the Home tab at the bottom of the screen
Scroll down to the Habits section
You will see all habits that are due today listed as cards

At the top-right of the section, a completion badge shows your progress for the day (e.g., "3/5" means you have completed 3 out of 5 habits due today).

Understanding Habit Cards

Each habit card on the Home screen displays:

Left side: The habit emoji followed by the habit name
Below the name (number-based only): Progress text showing current value / target and unit (e.g., "4 / 8 glasses")
Right side: A colored progress bar showing how close you are to completion
Far right: A flame icon with your current streak count

The progress bar color matches the habit's category (blue for hydration, green for nutrition, red for fitness, etc.).

Completing a Yes/No Habit

Yes/no habits are the simplest kind: either you did it or you didn't.

Tap the habit card to open the Habit Detail screen
At the bottom of the screen, tap the Complete button
You will feel a haptic vibration and see a confetti animation confirming your completion
The progress ring at the top fills to 100%
Your streak badge updates

To undo: After completing, the button changes to Undo. Tap it to reverse the completion. This is useful if you accidentally marked a habit as done.

Completing a Number-Based Habit

Number-based habits require you to enter a number value toward a target.

Tap the habit card to open the Habit Detail screen
At the bottom, tap Enter value
A bottom sheet appears with a number input
Type your value and confirm
If your value reaches or exceeds the target, the habit is marked complete and confetti plays
If your value is below the target, the progress ring and bar update to reflect your partial progress

The detail screen shows your current value against the target (e.g., "4,200 / 10,000 steps") with the remaining amount displayed below the progress bar.

Completing a Hydration Habit

Hydration habits have a special interface designed to make logging water intake fast and fun:

Tap the habit card to open the Habit Detail screen
You will see an animated water circle that fills up as you log intake
Below the circle, three quick-add preset buttons appear:
- Glass (smallest increment, e.g., 1 glass or 0.25L)
- Shaker (medium increment, e.g., 2 glasses or 0.5L)
- Bottle (largest increment, e.g., 3 glasses or 0.75L)
Tap a preset to instantly add that amount. No typing needed!
Each tap adds to your running total with a haptic feedback
You can also tap Enter value to type a custom amount
Once you reach the target, the habit completes with confetti

The water circle features an animated wave effect that fills from bottom to top as you approach your target.

Habits with Auto-Tracking

Some habits track progress automatically using your phone's health data:

Steps and active calories update from Apple Health / Google Fit
Sleep hours update from your health app
Workouts and meals update when you log them in Gymkee

For auto-tracked habits:

Values appear without any action from you
The manual value takes priority if you enter one (manual edits override auto-tracking)
If the auto-tracked value reaches the target, the habit completes automatically

Viewing Progress on the Detail Screen

When you open a habit's detail screen, you see a rich set of information:

Progress ring (top center), a circular indicator showing today's completion percentage. For hydration habits, this is an animated water circle instead.
Streak badge with flame icon(s) and your current streak count, colored by tier.
Contextual motivation message that changes based on your streak status:
- Starting a new streak: encouraging message to begin
- Building momentum (3+ days): encouragement to keep going
- On fire (7+ days): celebration of your consistency
- Approaching your record: challenge to beat your personal best
- Coming back after a break: welcome-back message
Weekly calendar with 7 day circles showing the current week (checkmark = completed, dot = missed, outline = today).
Stats section with three rows:
- Current streak (flame emoji)
- Longest streak (trophy emoji), highlights "NEW" if you are currently at your record
- Weekly completion rate (chart emoji)

Tips

Log habits as you do them rather than waiting until the end of the day. This prevents forgetting and gives you the satisfaction of seeing your progress build throughout the day.
For number-based habits, use the quick-add presets (hydration) or round numbers. You can always adjust later with Enter value.
Tap the weekly calendar on the detail screen to open a full calendar view with monthly, 90-day, 6-month, and yearly breakdowns.
The progress bar on habit cards gives you a quick at-a-glance view without opening the detail screen, useful for checking how close you are to your daily targets.

Common Mistakes

Tapping the habit card expecting one-tap completion. Tapping a habit card opens its detail screen, it does not complete the habit directly. You need to tap the Complete or Enter value button on the detail screen.
Entering the total value instead of the increment for hydration. The preset buttons add to your existing value. If you already logged 3 glasses and tap the "glass" preset, it adds 1 more (total: 4), not resets to 1.
Not checking if an auto-tracked habit already completed. Auto-tracked habits may already be marked complete when you open Gymkee. Check the progress ring before manually entering a value to avoid double-counting.
Expecting completion to carry over past midnight. Each calendar day is independent. If you complete a habit at 11:59 PM, it counts for that day. At midnight, a new day starts with habits reset to incomplete.

Troubleshooting

Problem: I tapped Complete but nothing happened

Why it happens: You may have a slow network connection, or the button may be temporarily disabled while saving.

How to fix it: Wait a moment and try again. Check your internet connection. If the button shows a loading spinner, wait for it to finish.

Problem: My number-based habit shows the wrong value

Why it happens: For auto-tracked habits, the value shown is the higher of the auto-tracked value and your manually entered value. If health data synced a lower number after your manual entry, your manual value persists.

How to fix it: Tap Enter value to override with the correct number. Manual entries always take priority over auto-tracking.

Problem: The confetti played but my streak did not increase

Why it happens: The streak counter updates based on server-side calculations that account for consecutive due days. If yesterday was not a due day for this habit, your streak may not visually change even though you completed today.

How to fix it: This is expected behavior. Your streak is still being tracked correctly. Check the stats section for the accurate current streak number.