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

# Activities: Study, Training, and Routine Subject Profiles

> Activities (called subjects in the API) are named profiles for what you study, train, or practice — each with its own content and weekly schedule.

An activity (referred to as a subject in the API) is a named profile representing something you want to spend time on. Each activity has a type — Study, Training, or Routine — which controls what kind of content it tracks and how blocks appear when you open them.

## Subject Fields

Every activity you create is stored as a subject object with the following fields:

| Field   | Type   | Description                                      |
| ------- | ------ | ------------------------------------------------ |
| `id`    | string | Unique identifier                                |
| `name`  | string | Display name (max 40 characters)                 |
| `type`  | string | Profile type: `study`, `training`, or `inactive` |
| `color` | string | Hex color code used in the schedule and heatmap  |
| `slots` | array  | Weekly time slots assigned to this activity      |

<Note>
  No two activities can share the same name. Take Time enforces this uniqueness constraint at the point of creation and when you rename an existing activity. If you try to save a duplicate name, the app will prompt you to choose a different one.
</Note>

Color is assigned automatically if you do not specify one when creating an activity. You can change it at any time from the activity's profile screen.

## Profile Types

The type you choose when creating an activity determines what content it tracks and how its blocks behave.

| Type     | API value  | Content tracked                          |
| -------- | ---------- | ---------------------------------------- |
| Study    | `study`    | Syllabus topics with estimated durations |
| Training | `training` | Exercise sheet with sets / reps / weight |
| Routine  | `inactive` | Micro-habits checklist                   |

<CardGroup cols={3}>
  <Card title="Study" icon="book-open">
    Build a **syllabus** of topics with estimated durations. When you open a Study block, you pick the topic you are covering from this list. Topics track their own completion state so you can follow your progress through course material.
  </Card>

  <Card title="Training" icon="dumbbell">
    Define an **exercise sheet** with names, sets, reps, and weights. Training blocks display this sheet as a checklist so you can log each exercise as you finish it.
  </Card>

  <Card title="Routine" icon="list-check">
    Create a list of **micro-habits** — short actions you want to perform consistently. Routine blocks surface these as a quick checklist to tick off during the session.
  </Card>
</CardGroup>

## Content by Profile Type

### Study — Syllabus Topics

Each topic in a Study subject's syllabus carries three properties:

| Field      | Type    | Description                         |
| ---------- | ------- | ----------------------------------- |
| `title`    | string  | Name of the topic or chapter        |
| `duration` | number  | Estimated time in minutes           |
| `done`     | boolean | Whether you have covered this topic |

<Tip>
  Keep individual syllabus topics to **50 minutes or less**. Shorter cycles fit neatly into a single block, make it easier to pick up exactly where you left off, and give you more frequent completion moments — which keeps your heatmap active and your streak alive.
</Tip>

### Training — Exercise Sheet

Each entry on a Training subject's exercise sheet includes:

| Field    | Type   | Description                 |
| -------- | ------ | --------------------------- |
| `name`   | string | Exercise name               |
| `sets`   | number | Number of sets              |
| `reps`   | number | Repetitions per set         |
| `weight` | number | Load in your preferred unit |

### Routine — Micro-Habits

Routine subjects hold a simple list of habit strings:

| Field   | Type   | Description                         |
| ------- | ------ | ----------------------------------- |
| `title` | string | Description of the habit to perform |

Add as many micro-habits as your routine requires. Each one appears as its own checkbox inside a Routine block.

## Weekly Slots

Each activity can hold one or more weekly slot definitions. A slot tells Take Time which days of the week and what time range that activity should run.

```json theme={null}
{
  "days": [1, 3, 5],
  "start": "09:00",
  "end": "10:00"
}
```

Days are represented as integers where `0` = Sunday and `6` = Saturday. The example above schedules the activity on Monday, Wednesday, and Friday from 09:00 to 10:00.

Take Time uses these slot profiles to auto-generate blocks each day. You can add multiple slots to the same activity — for instance, a short morning slot and a longer evening slot — as long as they do not conflict with slots belonging to other activities on the same days.

## Priority Circle

The Priority Circle lets you sort your activities into three tiers so you can see at a glance where your time should go.

<Accordion title="Priority zones">
  | Zone    | Label       | Purpose                                         |
  | ------- | ----------- | ----------------------------------------------- |
  | `zone1` | Main Focus  | Activities that are your top priority right now |
  | `zone2` | Important   | Activities that matter but are secondary        |
  | `zone3` | Flexible    | Activities you fit in when you have spare time  |
  | —       | Unallocated | Activities not yet assigned to any zone         |

  Drag any activity card into a zone on the Priority Circle screen. You can reassign activities between zones at any time. Unallocated activities still appear on your schedule normally — the circle is a planning aid, not a gate.
</Accordion>
