> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wrkit.osamapm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up your Wrk It profile and choose your first habits

> Complete Wrk It's three-step onboarding to set a display name, pick an avatar, and join your first habit packs before reaching your dashboard.

After you log in for the first time, Wrk It walks you through a three-step onboarding flow before you reach the main dashboard. The steps take about two minutes and give you a display name that appears on leaderboards, an avatar that represents you across the app, and at least one habit pack to start tracking. You can change all of these later from your Profile page.

<Steps>
  <Step title="Choose a display name">
    The first screen asks you to pick a **Display Name** — this is how you'll appear on global and per-pack leaderboards, so choose something you're happy being recognized by.

    Type your name into the field (up to 20 characters). A character counter below the field shows how much space you have left. Display names must be unique; if the name you want is already taken, you'll see an error and can try a different one.

    <Note>
      Display names cannot contain an `@` symbol. Wrk It checks availability in real time when you tap **Continue**, so there's no separate availability search step.
    </Note>

    Click **Continue** to save your display name and move to the next step.
  </Step>

  <Step title="Pick an avatar">
    The avatar screen shows a grid of 12 built-in avatars to choose from. Tap any avatar to select it — a highlight appears around the one you've picked.

    If you'd prefer to use your own photo, click **Upload your own photo (max 2MB)**. Select an image file from your device (any image format is accepted). The file must be 2 MB or smaller. A progress bar tracks the upload and the button label updates to **Uploaded photo selected** once the photo is ready.

    <Tip>
      You can switch between a built-in avatar and an uploaded photo at any time on this screen before continuing. Selecting a built-in avatar after uploading a photo will use the built-in one, and vice versa.
    </Tip>

    Click **Continue** to save your avatar and move to the pack selection step.
  </Step>

  <Step title="Join your first habit packs">
    The pack selection screen shows all public habit packs organized into two sections: **Trending Wrk Habits** (the 10 most popular packs) and **Community Wrk Habits** (all others). You must select at least one pack to continue.

    **Browse and filter packs**

    Use the search bar at the top to find packs by name or description. Filter by category using the chips below the search bar. The available categories are:

    | Category     | Color  |
    | ------------ | ------ |
    | Fitness      | Rose   |
    | Mind         | Violet |
    | Learning     | Blue   |
    | Productivity | Amber  |
    | Spiritual    | Purple |
    | Health       | Cyan   |
    | Money        | Teal   |
    | Creativity   | Pink   |

    **Preview a pack**

    Tap any pack card to expand it and see the list of habits it contains (up to 6 are shown, with a count of any additional habits). Each habit in the list is shown with its name and icon so you know exactly what you're committing to.

    **Select a pack**

    Inside the expanded card, click **Join Wrk Pack** to add it to your selection. The button changes to **Remove** and a **Selected** badge appears on the card header. You can select as many packs as you like. To deselect a pack, click **Remove**.

    **Finish onboarding**

    The sticky bar at the bottom of the screen shows how many packs you've joined and a button labelled **Start your Wrk Habits (N joined)**. Once you've selected at least one pack, click that button to save your choices.

    <Note>
      If you'd rather create a completely custom habit pack instead of joining an existing one, click **Create New Wrk Habits** in the sticky bar. This takes you to the habit creation screen.
    </Note>

    After saving, a confirmation screen celebrates your start with the message "Wrk it till you make it." Click **Enter the Arena** to load your **My Wrk** dashboard.
  </Step>
</Steps>

## What happens after onboarding

Once onboarding completes, you land on the **My Wrk** dashboard. Your selected packs are listed there, and each habit inside them is ready to be checked off for today. Your streak starts the moment you complete your first habit.

## Changing your profile later

You don't have to get everything perfect during onboarding. You can update your display name, swap your avatar, and add or remove habit packs at any time from the **Profile** page.