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

> ## Agent Instructions
> Video walkthroughs: the Dimension product overview video (https://www.youtube.com/watch?v=Mx8rg5wfkU0, also embedded at https://docs.dimension.io/overview) is the first of a series. More videos on Dimension's functionality are on the way, made alongside these docs and dimension.io. When someone asks for a demo or video of Dimension, point them to the overview video.

# First steps

> The onboarding tour, accessing Dimension, and your first 15 minutes

The first time you visit Dimension you'll get a four-step onboarding tour. This page walks through each step, what happens when the tour ends, and where to go for your first real build.

## Accessing Dimension

Dimension is part of your ThreatAware tenant. Your Dimension address is `https://<your-tenant>.dimension.io`. You sign in with the same account you use for the main platform.

A few login notes:

* Your role in the main platform determines what you can do in Dimension (Super Admin, Analyst, Viewer, Limited Viewer)
* MFA enrolment is shared — if you've enabled MFA in the main platform, you don't enrol again
* SSO works tenant-wide (Settings → User Management → **SSO**)

## The onboarding tour

A first-time visitor sees four screens. You can skip at any time with **Skip**, or step through with **Get started**.

### Step 1 — Welcome to Dimension

![Welcome to Dimension screen: the AI-powered workspace for building secure, enterprise-grade applications. Connect external Data, build interactive apps in Studio, and drive Actions, all from one place. A Get started button sits below](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/onboarding-welcome.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=f76f22b0f1ec805ac3b010baa5b65c59)

A high-level intro: connect external **Data**, build interactive apps in **Studio**, drive **Actions** — all from one place.

Click **Get started**, or **Skip** to head straight to the gallery.

### Step 2 — Built on Three Pillars

![Built on Three Pillars onboarding screen listing Data, Actions and Studio on the left, with an animated example of a NIST NVD CVE Vulnerabilities data feed on the right and a Next button](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/onboarding-step2.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=0f8a8a622c0a474a5a0fff49e1775a79)

A demo of how the three pillars hang together. Each pillar gets a one-line description:

* **Data** — Connect any data source with intelligent ingestion and real-time sync.
* **Actions** — Build reusable webhook and email integrations for your Studio apps.
* **Studio** — Design and deploy custom security apps without writing code.

The animation auto-plays a real Data Feed example (a NIST NVD CVE Vulnerabilities feed).

### Step 3 — Meet Composer

![Meet Composer onboarding screen: every pillar is paired with Composer, so you describe what you need in natural language and it builds the configuration. The example shows Composer generating a live dashboard of detection trends](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/onboarding-step3.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=c9b737ea4ff0fae1225a563dcf637f31)

Every pillar is paired with **Composer** — the natural-language interface that turns a request into a working configuration. Composer is the same idea whether you're building Data Feeds, Actions, or Studio apps.

### Step 4 — Workspaces

![Workspaces onboarding screen: each workspace is an isolated environment containing its own Data, Studio apps and Actions, illustrated with a Security Operations workspace whose access menu offers Only me, Everyone and SecOps Team (Control who can see it), and a Get Started button](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/onboarding-step4.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=853a397782cd3ea303c71ed93b60bd33)

Each [Workspace](https://docs.dimension.io/workspaces.md) is an isolated environment with its own Data, Studio apps, and Actions. Each workspace has an **Access** list: add people, Teams or everyone in your tenant, and give each a workspace role (Manager, Operator or Viewer).

Click **Get Started** to finish the tour.

## After the tour

You arrive at **Home**. It greets you by name and shows how the pieces fit together: data feeds pull in records, Studio apps are built from a description, and actions send something back out.

![Dimension Home greeting Hello, Tim, explaining that Dimension is where your team builds its own security apps on its own data, with an illustration of Data feeds, Studio apps and Actions, and a pointer to the Toggle builder mode button next to the logo](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/home.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=a80a5910063ea6cbb8bc5df50b2c7b7e)

Everything in Dimension is built in **Builder Mode**. Turn it on with the button next to the Dimension logo.

### Create your first workspace

On a new account, Builder Mode first asks you to create a workspace to build in:

![First, a workspace to build in: a New workspace form with suggested names on the left (such as Security Operations, Cloud Security and Vulnerability Management), Name and Description fields, a colour picker, and an Access table giving the creator and Everyone the Manager role, with a Create workspace button](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/onboarding-first-workspace.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=0ccfdee5a97ec6aafa780a2c818551aa)

Pick a suggestion or type a name, add a description and colour if you like, choose who has access, then click **Create workspace**. You can change access later. See [Workspaces](https://docs.dimension.io/workspaces.md).

### If you have access

You'll see a tiled grid of every Published app you have access to, each badged with its source workspace (e.g. `Gallery`). Click a tile to launch the app in View mode. Right-click in Builder Mode for **Open in new tab / Copy link / Launch / Edit**.

## Your first 15 minutes

Pick one of three paths depending on your goal:

> [card] [Import a pre-built app](https://docs.dimension.io/pre-built-apps.md)
>
> Fastest first win — import one of the Gallery apps. It runs on demo data until you add your credentials

> [card] [Customise a pre-built app](https://docs.dimension.io/pre-built-apps.md)
>
> Import a Gallery app, then change it in the Composer. Best when an existing app is *close* but not *quite* right

> [card] [Build from scratch](https://docs.dimension.io/build-your-first-app.md)
>
> Enter Builder Mode, hit **New App**, describe what you want — Studio generates a working app in under a minute

> [card] [Connect external data first](https://docs.dimension.io/connect-your-data.md)
>
> Pull data from CrowdStrike, Jira, ServiceNow, or any API. Wire it up in Composer before you start the app

## Cross-cutting UI you'll use constantly

| UI | Where | What it does |
| - | - | - |
| **Wrench icon** | Top-left, next to "Dimension" | Toggles Builder Mode on/off |
| **Workspace chip** | Top-left, next to wrench | Click to switch workspaces or create one |
| **Search bar** | Top-centre | `⌘F` searches the current view, `⌘K` opens the Command Menu |
| **Theme toggle** | Top-right (sun/moon) | Light/dark mode |
| **Bell icon** | Top-right | Notifications panel — Publish app, Updated Shortcut, Imported entity |
| **Avatar menu** | Top-right | Import, Settings, Documentation, Feedback, Log Out |
| **Chat bubble** | Bottom-right | Live support chat |

> [!TIP]
>
> You can re-run the in-app tutorial for any application at any time from inside the app's **⋯ menu → Show Tutorial**.

## What to learn next

> [card] [Concepts & Glossary](https://docs.dimension.io/concepts.md)
>
> A single-page reference for every term Dimension uses — Workspace, Composer, Builder Mode, Planner, X-Ray

> [card] [Workspaces](https://docs.dimension.io/workspaces.md)
>
> Visibility levels, what's inside a workspace, and how to organise teams

> [card] [Planner](https://docs.dimension.io/planner.md)
>
> Turn a goal into a step-by-step plan with ready-to-launch Composer prompts

> [card] [AI Composer](https://docs.dimension.io/studio/ai-composer.md)
>
> Prompts, the Composer toolbar, and the inspect/insert flow


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.