Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.movetogetherfitness.com/llms.txt

Use this file to discover all available pages before exploring further.

The first time you open MoveTogether, you’ll go through a guided setup. Eight screens, most of them take less than 30 seconds each. If you ever quit partway through, the app picks up exactly where you left off the next time you launch.

​
1. Profile setup (identity)

Pick a first name, last name, and username. Optionally add a profile photo.
  • Your display name is what friends see on leaderboards and in the activity feed.
  • Your username is how friends search for you. It can include letters, numbers, and underscores. It auto-lowercases as you type.
  • We check username availability live while you type — a green checkmark means it’s yours.
  • The profile photo is optional. You can add or change it later in your Profile settings.
You can’t continue until first + last name and a valid username are filled in.

​
2. Pick your provider (tracker)

Choose where your activity data comes from. Eight providers are supported:
  • Apple Health (Apple Watch, iPhone)
  • Fitbit
  • Garmin
  • WHOOP
  • Strava
  • Polar
  • Oura
  • Suunto (coming soon)
Pick the one that matches the tracker you wear most.

​
3. Connect your tracker

Whichever provider you picked, you’ll be prompted to authorize MoveTogether to read your activity.
  • Apple Health opens the system permission sheet. Approve Steps, Active Energy, Exercise Minutes, and Workouts.
  • Everything else opens a sign-in page for that provider. Sign in, approve the permissions, and you’re sent back to MoveTogether.
If you cancel the connection, you stay on this screen so you can retry without losing earlier progress.

​
4. Time to move

Pick what to do first. Two options:
  • Create your first competition — opens the competition setup flow (the next screen).
  • Join with invite code — opens a sheet to enter a 6-character competition code from a friend.
Either works. You can also skip and explore the app first.

​
5. Competition setup (optional)

Only shows if you picked “Create your first competition.” Pick:
  • A name for your competition (up to 40 characters)
  • A scoring method: Ring Close Count, Percentage of Goals, Raw Numbers, or Step Count
You can’t continue until both are set.

​
6. Setting up your competition

A short loading screen while we create the competition on the server. You’ll see:
  • A spinner with “Setting up [name]…”
  • On success: confetti animation + “Let’s go” button
  • On failure: a retry button (don’t worry — this is rare)
If your free plan already has the maximum number of active competitions, this step still completes — you just won’t see a new competition added.

​
7. Turn on notifications

Before iOS shows you the system permission sheet, we explain what you’ll get:
  • Competitions — start/end/results, position changes
  • Friends and messages — friend activity and DMs
  • Streaks and coaching — milestone alerts and Coach Mo nudges
  • Rewards and events — new seasonal events and rewards
Tap continue and iOS shows the standard permission sheet. You can always change which categories you receive later in Settings → Notifications.

​
8. You’re in

You land in the main app at the Home tab. Your first competition (if you made one) shows up there, your tracker is connected, and Coach Mo is ready when you tap the Coach pill.

​
What if I skipped something?

  • Profile photo — add later in Profile → Edit Profile.
  • Tracker — add later in Settings → Data Sources.
  • Competition — create one from the Compete tab anytime.
  • Notifications — change permissions in iPhone Settings → MoveTogether → Notifications or MoveTogether → Settings → Notifications.
The app works fine even if you skip everything optional. The only required pieces are a name, a username, and a connected tracker.