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

# Using the Take Time App: Your Complete Setup Guide

> Learn how to install Take Time, create activities, build your weekly schedule, complete study blocks, and track your progress over time.

The Take Time app is a Progressive Web App (PWA) that runs in your browser and can be installed on your home screen for quick access. This guide walks you through the complete workflow — from installing the app and creating your first activity to reviewing your progress heatmap.

## Install the app

Take Time works in any modern browser at [https://study-planner-five-sand.vercel.app](https://study-planner-five-sand.vercel.app), and you can install it as a standalone app so it launches without browser chrome. The steps differ slightly by platform.

<Tabs>
  <Tab title="Desktop">
    <Steps>
      <Step title="Visit the app">
        Open your browser and navigate to [https://study-planner-five-sand.vercel.app](https://study-planner-five-sand.vercel.app).
      </Step>

      <Step title="Click the install icon">
        Look for the install icon (a monitor with a download arrow) in the browser address bar on the far right. Click it.
      </Step>

      <Step title="Confirm the installation">
        Click **Install** in the prompt that appears. Take Time opens in its own window and is now pinned to your taskbar or dock.
      </Step>
    </Steps>
  </Tab>

  <Tab title="iOS">
    <Steps>
      <Step title="Open the app in Safari">
        Take Time must be installed from Safari on iOS. Navigate to [https://study-planner-five-sand.vercel.app](https://study-planner-five-sand.vercel.app).
      </Step>

      <Step title="Tap Share">
        Tap the **Share** button (the box with an arrow pointing up) at the bottom of the screen.
      </Step>

      <Step title="Add to Home Screen">
        Scroll down in the share sheet and tap **Add to Home Screen**.
      </Step>

      <Step title="Confirm">
        Edit the display name if you like, then tap **Add**. The Take Time icon now appears on your home screen.
      </Step>
    </Steps>

    <Tip>
      Launch Take Time from your home screen icon — not from Safari — so it runs in fullscreen mode without the browser navigation bar.
    </Tip>
  </Tab>

  <Tab title="Android">
    <Steps>
      <Step title="Open the app in Chrome">
        Navigate to [https://study-planner-five-sand.vercel.app](https://study-planner-five-sand.vercel.app) in Chrome.
      </Step>

      <Step title="Open the browser menu">
        Tap the three-dot menu in the top-right corner.
      </Step>

      <Step title="Install the app">
        Tap **Add to Home Screen** or **Install app**, depending on your Chrome version.
      </Step>

      <Step title="Confirm">
        Tap **Add** or **Install** in the confirmation dialog. Take Time appears on your home screen and app drawer.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Create an account

<Steps>
  <Step title="Open the app and tap Log In">
    Launch Take Time from your browser or home screen icon. The welcome screen shows a **Log In** button.
  </Step>

  <Step title="Sign up for a new account">
    Tap **Sign Up** below the login form. Enter your email address and choose a strong password, then tap **Create Account**.
  </Step>

  <Step title="Verify your email">
    Check your inbox for a verification link and click it. You'll be redirected back to the app automatically.
  </Step>

  <Step title="Access your dashboard">
    Enter your email and password and tap **Access Dashboard**. Take Time syncs your data to the cloud immediately after authentication.
  </Step>
</Steps>

<Info>
  Your study data is tied to your account and syncs across all devices. Log in on any browser to access your full schedule.
</Info>

## Add your first activity

Activities are the foundation of your Take Time schedule. Each activity has a profile type that shapes how you track progress.

<Steps>
  <Step title="Open the Activities tab">
    Tap the **Activities** tab in the bottom navigation bar.
  </Step>

  <Step title="Tap the + button">
    Tap the **+** button in the top-right corner to open the new activity form.
  </Step>

  <Step title="Choose a profile type">
    Select one of three profile types:

    * **Study** — tracks syllabus topics. Best for academic subjects or courses with defined reading lists.
    * **Training** — tracks exercises. Best for workouts, language drills, or skill-based practice.
    * **Routine** — tracks micro-habits. Best for daily rituals like journaling, meditation, or review sessions.
  </Step>

  <Step title="Name and color your activity">
    Enter a name (maximum 40 characters) and pick a color. The color appears on your schedule clock and calendar so you can spot each activity at a glance.
  </Step>

  <Step title="Add weekly time slots">
    Tap **+ Add Time Slot** to define when this activity happens each week. Pick the days of the week and a start and end time. Add as many slots as you need.
  </Step>

  <Step title="Add content">
    Populate the activity with the material you'll track:

    * **Study** → add syllabus topics (e.g., "Chapter 3: Thermodynamics")
    * **Training** → add exercises (e.g., "3×10 pull-ups")
    * **Routine** → add habits (e.g., "5-minute journaling")
  </Step>

  <Step title="Save">
    Tap **Save**. Take Time creates the activity and generates blocks for the current week based on your slots.
  </Step>
</Steps>

<Tip>
  Start with one or two activities and build your schedule gradually. Overloading your first week makes it harder to maintain momentum.
</Tip>

## Build your schedule

<Steps>
  <Step title="Switch to the Schedule tab">
    Tap the **Schedule** tab in the bottom navigation bar.
  </Step>

  <Step title="Read the pizza clock">
    The pizza clock displays today's blocks as colored arcs on a 24-hour dial. Each arc corresponds to one activity's time slot. The color matches the activity color you chose.
  </Step>

  <Step title="Add a one-off block">
    To add an unscheduled block for any activity, tap **+** on the Schedule tab. Choose the activity, date, and time range, then tap **New Block**.
  </Step>
</Steps>

<Info>
  Blocks that come from your slot profiles are generated automatically each day. You only need to manually add blocks for sessions that fall outside your regular schedule.
</Info>

## Complete a block

<Steps>
  <Step title="Tap a block to expand it">
    On the Schedule tab, tap any block on the pizza clock or in the list below it to expand the session card.
  </Step>

  <Step title="Log your progress">
    What you see inside the card depends on the activity type:

    * **Study block** — choose a syllabus topic from the dropdown, then mark it complete.
    * **Training block** — check off each exercise as you finish it.
    * **Routine block** — check off each habit.
  </Step>

  <Step title="Mark the block done">
    Tap the **Done** toggle on the block card to mark the entire session as complete. The block arc on the pizza clock turns solid, and the session counts toward your streak.
  </Step>
</Steps>

<Tip>
  You don't have to complete every item inside a block before marking it done. Mark it done when your time is up — partial progress still counts toward your streak.
</Tip>

## Review your progress

Your progress heatmap gives you a bird's-eye view of consistency over time.

<Steps>
  <Step title="Open the Settings tab">
    Tap the **Settings** tab in the bottom navigation bar.
  </Step>

  <Step title="Find the heatmap">
    Scroll to the **Progress** section. The heatmap shows a grid of days — green cells indicate days with at least one completed block. Darker green means more activity that day.
  </Step>

  <Step title="Check your stats">
    Below the heatmap you'll find:

    * **Streak count** — how many consecutive days you've completed at least one block.
    * **Completion rate** — the percentage of scheduled blocks you've marked done over the past 30 days.
  </Step>
</Steps>

<Info>
  The heatmap resets each calendar year. Your historical data is preserved and available through the API, so you can export it anytime.
</Info>

## Customize settings

Take Time adapts to your preferences and environment.

| Setting                  | Options                              | Effect                                                                               |
| ------------------------ | ------------------------------------ | ------------------------------------------------------------------------------------ |
| **Theme**                | Automatic / Light / Dark             | Controls the app color scheme. Automatic follows your system setting.                |
| **Language**             | English (en-US) / Portuguese (pt-BR) | Changes all UI labels and date formats.                                              |
| **Day start / end**      | Any hour                             | Sets the visible time range on the pizza clock.                                      |
| **Notifications**        | On / Off + minutes                   | Enables push alerts and lets you set advance reminder time.                          |
| **Motivational Marquee** | Custom phrases                       | Adds inspiring phrases to the scrolling banner at the top of the app (one per line). |

<Tip>
  Set your day start to one hour before your first block so the pizza clock gives you a clear view of your upcoming sessions without dead space.
</Tip>

## Notifications

<Steps>
  <Step title="Enable notifications">
    Go to **Settings → Alerts** and toggle **Notifications** on. Your browser will prompt you to allow notifications — click **Allow**.
  </Step>

  <Step title="Set your reminder window">
    Use the **Remind in advance** slider to choose how far ahead you want to be reminded. For example, set 10 minutes to get a heads-up before each block starts.
  </Step>

  <Step title="Receive your reminders">
    Take Time sends a push notification before each upcoming block based on your schedule. Notifications arrive even when the app is running in the background.
  </Step>
</Steps>

<Info>
  Push notifications require the app to be installed on your device or open in a browser tab. They do not fire when using test (sandbox) API keys.
</Info>