> ## 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.

# Create, join, and manage your habit packs in Wrk It

> Habit packs are collections of habits you track on a schedule. Learn how to create packs manually or with AI, set frequency options, and manage visibility.

A **habit pack** is a named collection of habits you commit to on a recurring schedule. Every pack you join or create appears on your **My Wrk** dashboard, where you check off each habit as you complete it. Packs can be public — shared with the community so anyone can join — or private, visible only to you. Whether you prefer building from scratch or letting AI do the heavy lifting, Wrk It gives you both options.

## What makes up a habit pack

Each pack has a **name**, a short **description**, a **category**, an **icon**, a list of **habits**, a **frequency**, and a **visibility** setting. You fill in all of these when you create a pack manually, or Wrk It generates sensible defaults when you use the AI flow.

The **habits** inside a pack are the individual actions you check off. A pack needs at least one habit to be created. You can add as many as you like, and each habit gets its own icon so they're easy to tell apart at a glance.

## Two ways to get habit packs

You can get packs in two ways:

* **Join a public pack** from the Explore page — browse curated packs by category and join with one tap.
* **Create your own pack** — build it manually with full control, or describe a goal and let AI generate the habits for you.

## Creating a habit pack

<Tabs>
  <Tab title="Manual">
    Manual creation gives you full control over every field.

    <Steps>
      <Step title="Open the Add New screen">
        Tap the **+** button in the bottom navigation to open **Add New**. Select the **Manual** tab if it is not already active.
      </Step>

      <Step title="Name your pack">
        Enter a **Wrk title** — something short and memorable, like "Morning Mastery" or "Deep Work Blocks". If you make the pack public, the name must be unique across all public packs.
      </Step>

      <Step title="Add a description">
        Write a brief description explaining what the pack is about. This text appears on the pack card and detail page.
      </Step>

      <Step title="Pick an icon and category">
        Choose one of the available icons for your pack. Then select one of the 8 **categories** — Fitness, Mind, Learning, Productivity, Spiritual, Health, Money, or Creativity — to help others discover the pack on the Explore page.
      </Step>

      <Step title="Set visibility">
        Toggle between **Public** and **Private**. Public packs appear in Explore and on your profile. Private packs are only visible to you.
      </Step>

      <Step title="Configure frequency">
        Choose how often the pack is active. See the [Frequency types](#frequency-types) section below for details on each option.
      </Step>

      <Step title="Add your habits">
        Enter each habit name and optionally pick an icon for it. Tap **Add habit** to add more rows. You can remove a habit with the trash icon. At least one habit with a name is required.
      </Step>

      <Step title="Create the pack">
        Tap **Create Wrk**. The pack is saved and immediately added to your active packs on the **My Wrk** dashboard.
      </Step>
    </Steps>
  </Tab>

  <Tab title="AI generation">
    The AI flow lets you describe a goal in plain language and generates a complete pack — title, description, habits, category, and a suggested frequency — in seconds.

    <Steps>
      <Step title="Open the Add New screen">
        Tap the **+** button in the bottom navigation. The **AI Generate** tab opens by default.
      </Step>

      <Step title="Describe your goal">
        Type a goal in the text area, such as "I want to wake up earlier and be more productive in the morning". You can also tap one of the **predefined goal suggestions** to use as a starting point.
      </Step>

      <Step title="Generate the pack">
        Tap **Generate Wrk**. The AI creates a title, description, habit list, category, and a recommended frequency based on your goal.
      </Step>

      <Step title="Review and edit">
        Inspect the generated results. You can edit the title, description, any habit name, or its icon. You can add new habits or remove ones you don't want.
      </Step>

      <Step title="Adjust settings">
        Set the **visibility** (public or private), confirm or change the **category**, and adjust the **frequency** if the AI's suggestion does not fit your schedule.
      </Step>

      <Step title="Create or regenerate">
        Tap **Create Wrk** to save the pack, or tap **Regenerate** to discard the current result and get a new one from the same goal description.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Frequency types

Every pack has a frequency that determines which days the pack is considered active. Wrk It tracks your streak based on whether you met the frequency requirement for the current period.

| Frequency       | How it works                                                                                                                                                                           |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Daily**       | The pack is active every day. Complete all habits each day to maintain your streak.                                                                                                    |
| **Weekly**      | Choose how many times per week (1–7) you need to complete the pack, and which day the week starts on.                                                                                  |
| **Monthly**     | Choose how many times per month (1–28) you need to complete the pack, and which day of the month the period resets.                                                                    |
| **Custom days** | Pick specific weekdays (for example, Mon/Wed/Fri) when the pack is active. The pack is only shown as due on those days. Selecting all 7 days automatically switches the pack to Daily. |

## Managing your packs

### Editing a pack

Open a pack from the **My Wrk** dashboard to reach the **Wrk Details** page. Tap the edit icon to update the pack name, description, icon, or category. You can also add or remove individual habits from this screen.

### Freezing a pack

If you need a break without losing your streak, you can **freeze** a pack. A frozen pack is paused — it no longer shows as due each day, and your streak is preserved until you unfreeze it. Look for the freeze option on the **Wrk Details** page.

### Leaving or removing a pack

To stop tracking a pack, open **Wrk Details** and tap the delete or leave option. For packs you created, deleting removes the pack entirely. For public packs you joined, leaving removes it from your active list but the pack remains available in Explore for others.

<Note>
  Public pack names must be unique across all public packs on the platform. If you choose a name that is already taken, Wrk It shows an error message before you submit. Rename the pack or make it private to proceed.
</Note>
