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

# Planner Overview

> An introduction to the NavNX planner workspace layout, view modes, keyboard shortcuts, and auto-save.

## Planner Workspace

The planner is the core workspace where you create and refine surgical plans. It provides 2D and 3D visualisation of patient imaging alongside surgical planning tools.

## Layout

The planner workspace is divided into four areas:

| Area                 | Location | Purpose                                                                                                   |
| -------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| **Toolbar**          | Top      | Patient info, DICOM loader, view mode tabs, measurement tools, planning tools                             |
| **Viewport**         | Centre   | The main visualisation area — displays DICOM slices or 3D renderings                                      |
| **Properties Panel** | Right    | Context-sensitive panel showing tunnel parameters, implant details, bone settings, or graft configuration |
| **Status Bar**       | Bottom   | Slice count, view mode, active tool, auto-save indicator                                                  |

## View Modes

Switch between view modes using the tabs in the toolbar or keyboard shortcuts:

| Mode         | Key | Description                                                                    |
| ------------ | --- | ------------------------------------------------------------------------------ |
| **Stack**    | `1` | Single-slice DICOM viewing with scroll-through navigation                      |
| **MPR**      | `2` | Multi-planar reconstruction — axial, sagittal, and coronal views in a 2x2 grid |
| **3D**       | `3` | 3D model view for implants and tunnels                                         |
| **Bone**     | `4` | Volume-rendered bone with threshold, clipping, and opacity controls            |
| **Segments** | `5` | AI-segmented individual anatomical structures (requires CT processing)         |
| **Graft**    | `6` | Graft path visualisation with spline control points                            |

<Tip>
  You can switch view modes at any time without losing your work. Annotations, tunnels, and implant selections persist across all views.
</Tip>

## Keyboard Shortcuts

The planner supports keyboard shortcuts for fast tool and view switching:

### View Modes

| Key | View     |
| --- | -------- |
| `1` | Stack    |
| `2` | MPR      |
| `3` | 3D Model |
| `4` | Bone 3D  |
| `5` | Segments |
| `6` | Graft    |

### Tools

| Key | Tool                |
| --- | ------------------- |
| `V` | Pointer / Select    |
| `L` | Length measurement  |
| `A` | Angle measurement   |
| `W` | Window / Level      |
| `H` | Pan                 |
| `Z` | Zoom                |
| `E` | Eraser              |
| `T` | Tunnel placement    |
| `I` | Implant selection   |
| `G` | Graft configuration |

<Note>
  Keyboard shortcuts are disabled when typing in input fields. Press `?` anywhere in NavNX to see all available shortcuts.
</Note>

## Auto-Save

The planner auto-saves your work as you make changes. The status bar displays the save state:

* **Plan saved** — all changes have been saved
* **Saving...** — a save is in progress
* **Save failed** — an error occurred (check your connection)

<Note>
  Auto-save uploads your plan data to the cloud. If you close the browser and reopen the case, your plan will be exactly as you left it — including DICOM files, which are reloaded from cloud storage.
</Note>

There is no manual save button — saving is handled entirely by the auto-save system with a 2-second debounce.