# Undra Home

Undra Home is the launcher you see when no workspace is open. It is not a workspace itself. It has no notes, no kernel, and no AI chat. It is where you pick which folder to work in, glance across everything you have registered, and manage app-level settings.

:::note Not the same as Overview
Inside a workspace, the route `/overview` is labeled **Overview**: a per-workspace dashboard (`.undra/overview.udash`) that greets you and surfaces due tasks, recent items, and quick actions. Undra Home is the cross-workspace launcher above that. This page is about the launcher.
:::

## What you see

- **Left sidebar**: your registered workspaces (reorder, favorite, reveal in Explorer, export, remove). **+ New Workspace** and **Link existing folder** sit at the bottom of the list.
- **Center**: an overview across workspaces: cards with item counts, recent activity, plan due dates, quick actions to create or open a workspace, and an activity feed.
- **Settings**: app preferences and AI provider setup, reachable without opening a workspace.
- **No chat**: open a workspace first to talk to Mira or use agents. Home is a launcher, not a work surface.

## Register and open workspaces

Each workspace is an ordinary folder on disk. From Home you can:

- **Create a new workspace**: Undra makes a folder under your default parent location (configurable in app settings).
- **Link an existing folder**: point Undra at a folder you already have. Nothing is copied; Undra adds its `.undra/` metadata inside.
- **Open** any registered workspace, the window reloads into the full workspace shell.
- **Remove** a workspace from the list, this only drops the registry entry; your files on disk are untouched.

## Boot behavior

By default, Undra opens your **last workspace** on launch if that folder still exists. You can change this in app settings to **always start at Home** instead.

## Switch back to Home

From inside a workspace, click the **Undra logo** (primary) or use the sidebar menu (secondary) to return to Home. Undra flushes pending work, disposes the workspace kernel, and reloads into launcher mode.

Switching between two open workspaces uses the same flush barrier. Going from Home into a workspace skips that barrier for a faster open.

## Cross-workspace digest

Home aggregates lightweight stats from every registered workspace: item counts, recent edits, and overdue and upcoming plan tasks. This is a scan cache in app data, rebuilt from your real workspace folders, not a separate database of your content.

## Export and import

From a workspace's context menu on Home (or from inside a workspace), you can **export** a `.undra` workspace package (a zip with a manifest and your workspace files). Double-clicking a `.undra` file on Windows queues an import; you pick a destination and confirm before anything is written. Home's center area also has an **Import workspace** quick-action next to **New workspace** and **Link existing folder**: it opens a native file picker but leads into that same confirm-first preview dialog, not a separate flow.

External portals can be included or listed separately at export time. See [Folder Portals](/docs/workspace/folder-portals/) for how portals relate to workspace folders.

## Where to go next

- **[Overview](/docs/getting-started/overview/)**: the mental model once you are inside a workspace.
- **[Dashboards](/docs/workspace/dashboards/)**: the in-workspace Overview board and custom dashboards.
- **[Local-First Trust](/docs/workspace/local-first-trust/)**: why every workspace is just a folder you own.