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

# Introduction

> One connected workspace for your team’s everyday work.

export const DocImage = ({src, alt, caption, kind = "workspace", thumbnail = false, natural = false}) => {
  const paths = {
    objects: "m12 3 9 4.5v9L12 21l-9-4.5v-9L12 3Z M3 7.5l9 4.5 9-4.5 M12 12v9",
    attributes: "M4 5h16 M4 12h16 M4 19h16 M8 3v4 M16 10v4 M10 17v4",
    records: "M5 3h14v18H5z M8 7h8 M8 11h8 M8 15h5",
    relationships: "M8 8H4v8h4 M16 8h4v8h-4 M8 12h8 M10 10l-2 2 2 2 M14 10l2 2-2 2",
    views: "M3 4h18v16H3z M3 9h18 M9 9v11 M15 9v11",
    importing: "M12 3v12 M8 11l4 4 4-4 M4 16v5h16v-5",
    workspace: "M4 4h16v16H4z M4 9h16 M9 9v11",
    navigation: "m5 5 14 5-6 3-3 6-5-14Z",
    team: "M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2 M16 4a4 4 0 0 1 0 8 M22 21v-2a4 4 0 0 0-3-3.87 M13 7a4 4 0 1 1-8 0 4 4 0 0 1 8 0Z",
    tasks: "M9 6h11 M9 12h11 M9 18h11 M3 6l1 1 2-2 M3 12l1 1 2-2 M3 18l1 1 2-2",
    meetings: "M4 5h16v15H4z M4 10h16 M8 3v4 M16 3v4 M8 14h3 M8 17h6",
    ai: "m12 3 2.5 6.5L21 12l-6.5 2.5L12 21l-2.5-6.5L3 12l6.5-2.5L12 3Z",
    automation: "M9 3h6v6H9z M3 16h6v5H3z M15 16h6v5h-6z M12 9v4 M6 16v-3h12v3"
  };
  return <figure className={["kato-visual", thumbnail ? "kato-visual--thumbnail" : ""].filter(Boolean).join(" ")}>
    {src ? <div className={["kato-visual-frame", natural ? "kato-visual-frame--natural" : ""].filter(Boolean).join(" ")}>
        {thumbnail ? <img src={src} alt={alt || ""} loading="lazy" decoding="async" /> : <a className="kato-visual-fullsize" href={src} target="_blank" rel="noreferrer" aria-label={`Open full-size image: ${alt || caption || "Kato guide"}`}>
            <img src={src} alt={alt || ""} loading="lazy" decoding="async" />
          </a>}
      </div> : <div className="kato-visual-frame kato-placeholder" role={thumbnail ? undefined : "img"} aria-label={thumbnail ? undefined : `Image placeholder: ${alt || caption || "Kato workspace"}`} aria-hidden={thumbnail ? "true" : undefined}>
        <span className="kato-orbit kato-orbit--outer" />
        <span className="kato-orbit kato-orbit--inner" />
        <span className="kato-visual-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"><path d={paths[kind] || paths.workspace} /></svg></span>
        {!thumbnail && <span className="kato-placeholder-label">Image placeholder</span>}
      </div>}
    {caption && !thumbnail && <figcaption>{caption}{src && <span className="kato-visual-hint">Select the image to view it full size.</span>}</figcaption>}
  </figure>;
};

Kato brings your team's tasks, meetings, and business records into a shared
workspace. The useful part is the connection between them: you can understand
who a piece of work is for, why it exists, and what needs to happen next.

This guide follows a website project for **Relio**. The screenshots use example
workspaces and project data; use your own workspace, people, and dates as you follow along.
By the end, you should know where to put your information and how to start a
first workflow without configuring the whole product.

<DocImage natural src="/images/workspace-overview.png" alt="Kato Inbox with a sidebar, email conversation, and linked company record" caption="An example workspace showing client communication beside the record that gives it context." />

## What goes where?

| In Kato       | Use it for                                                  | Relio example                         |
| ------------- | ----------------------------------------------------------- | ------------------------------------- |
| **Workspace** | The shared home for your team's data, members, and settings | Your agency's workspace               |
| **Object**    | A collection of one kind of business information            | Clients or Projects                   |
| **Record**    | One item within an object                                   | Relio or Relio website                |
| **Attribute** | A detail stored on each record                              | Project status or target date         |
| **Task**      | A specific action to finish                                 | Send the revised homepage brief       |
| **Meeting**   | The agenda and context for a conversation                   | Relio kickoff                         |
| **View**      | A way to focus on a set of records                          | Active projects sorted by target date |

A project record describes the project. A task describes an action within that
work. Keeping those separate means the project can stay useful after any one
task is complete. [The data guide](/documentation/data/how-data-connects)
explains objects, records, and attributes in more detail.

## Walk through a first piece of work

<Steps>
  <Step title="Choose a workspace">
    Select the workspace name at the top of the sidebar to open the workspace
    menu. The checkmark identifies the selected workspace. If your team already uses Kato,
    join that workspace so you can work with its existing information. If you
    are setting up a new team, [create a workspace](/documentation/create-your-workspace).

    <div className="kato-workspace-step-image">
      <DocImage natural src="/images/introduction/choose-workspace.png" alt="Workspace menu showing Personal, Free team, and Verum, with a checkmark beside Verum" caption="Choose the workspace that contains your project. This menu shows Verum selected; the Relio task examples below use Personal." />
    </div>
  </Step>

  <Step title="Find the relevant record">
    Open the appropriate object under **Objects**. Look for the client or
    project before creating another record. For this example, open **Projects**
    and select **Relio**. Review its attributes on the left and its activity in
    **Overview**. The **Tasks** tab contains the work linked to this project.

    <DocImage natural src="/images/introduction/relio-record.png" alt="Relio project record with attributes on the left and research notes and record activity in Overview on the right" caption="The project record keeps its status, website, linked client, and activity together. Open Tasks to see the related work." />
  </Step>

  <Step title="Create one actionable task">
    Open **Tasks** and create **Send the revised homepage brief**. Choose the
    assignees, a current status, and a due date if there is a real deadline.
    Add the acceptance criteria to the description: what should be sent, to
    whom, and what makes the brief ready. Link the relevant record for context.

    <DocImage natural src="/images/introduction/create-task.png" alt="Create task form for Send the revised homepage brief, with a description, Todo status, High priority, assignee, dates, estimate, and one linked record" caption="Write the outcome in the title, explain what is needed in the description, and check the task properties before selecting Create task." />
  </Step>

  <Step title="Make the task easy to pick up">
    Open it again and check that someone who missed the kickoff could tell
    what to do. A clear title, the related record, and a short description are
    more useful than a task named “Follow up.”

    <DocImage natural src="/images/introduction/saved-task.png" alt="Saved homepage brief task open beside the task board, with task details, its full description, and the linked Relio project" caption="The saved task shows its owner, status, deadline, description, and linked Relio project so a teammate can pick up the work with context." />
  </Step>
</Steps>

**You are ready to continue when:** you can find the task, identify who is
working on it, and open the record that explains the surrounding work.

## Bring meetings into the workflow

For the next client call, put the questions to resolve in the meeting agenda.
After the call, distinguish **decisions** from **actions**. “Use the revised
homepage direction” is a decision. “Send the revised brief” is an action and
belongs in a task.

Connecting a calendar helps bring scheduled events into Kato. It does not
replace the need to review the meeting and give follow-up work a clear owner.
Use [Meetings and follow-ups](/documentation/meetings-and-follow-ups) for a
complete before-and-after example.

## Where Ask Kato and automations help

**Ask Kato** helps you work with available context: ask a focused question,
summarize an item, or draft an update. Start with a named record or task and
check the result against the underlying information.

**Automations** apply a configured workflow when a trigger occurs. They are
useful once you understand the repetitive step you want to handle. Start with
one trigger and one action, then inspect the results before adding more steps.

Neither feature fixes missing project details on its own. Accurate records and
clear tasks give both your teammates and Kato better context to work with.

## Common first-day questions

<AccordionGroup>
  <Accordion title="Do I need to create all my objects and attributes first?">
    No. Start with the objects already available and one real piece of work.
    Add an attribute when you can explain what it stores and who will keep it
    current. Use a view when you just need to see a subset of existing records.
  </Accordion>

  <Accordion title="Why does my workspace look different from the examples?">
    Object names and attributes are configurable. Sidebar preferences, your
    role, enabled apps, and feature availability can also change what appears.
    Follow the purpose of each step and use your workspace's actual labels.
  </Accordion>

  <Accordion title="Should each client have a separate workspace?">
    Use a client record when the same team needs to manage clients together.
    Consider a separate workspace when membership and administration need to
    be separate. A new workspace creates another place to manage, so do not
    create one simply to categorize a client.
  </Accordion>
</AccordionGroup>

## Up next

<CardGroup cols={2}>
  <Card title="Find your way around" icon="compass" href="/documentation/navigating-kato">Learn where work lives and how to find it again.</Card>
  <Card title="Set up your workspace" icon="users" href="/documentation/create-your-workspace">Choose your workspace details and invite your team.</Card>
</CardGroup>
