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

# Workspace Layout

> Customizable panels that resize, rearrange, and dock to match your workflow

## Overview

Cleve's workspace is built with [Dockview](https://dockview.dev), a powerful panel management system that lets you create a personalized layout. Resize, rearrange, dock, and undock panels to match your exact workflow.

## Workspace Modes

Cleve offers two workspace modes:

### Full Workspace (Default)

The complete experience with all panels:

* **Writing Editor**: Main content creation area
* **AI Chat**: Context-aware assistant
* **Ideas Panel**: Quick capture sidebar
* **Categories Sidebar**: Hierarchical organization
* **Artifacts Panel**: Generated AI content
* **Search Overlay**: Global content search

### Chat-Only Mode

A minimal view focused only on AI chat:

* Full-screen chat interface
* No writing editor or idea panels
* Perfect for quick AI conversations
* Switch back to full workspace anytime

**Toggle between modes** using the view switcher in the top navigation.

## Panel Management

### Resizing Panels

Drag the **border between panels** to resize:

* Horizontal panels: Drag left/right borders
* Vertical panels: Drag top/bottom borders
* Snap to grid: Hold `Shift` while dragging for precise sizing

### Moving Panels

Drag the **panel header** to move it:

1. Click and hold the panel's title bar
2. Drag to desired location
3. Blue highlighting shows valid drop zones
4. Release to dock in new position

### Docking Positions

Panels can dock:

* **Left**: Categories sidebar, Ideas panel
* **Right**: AI Chat, Artifacts
* **Center**: Writing Editor (primary focus)
* **Bottom**: Search, Timeline (when enabled)
* **Floating**: Undock panels to separate windows

### Floating Panels

Make any panel a separate window:

1. Right-click panel header
2. Select **"Float Panel"**
3. Panel opens in a separate window
4. Re-dock by dragging back to main window

Great for multi-monitor setups!

### Closing Panels

* Click the **× button** on panel header
* Use keyboard shortcuts (see below)
* Re-open panels from the **View menu**

## Keyboard Navigation

### Panel Switching

| Action               | Shortcut       |
| -------------------- | -------------- |
| Focus Writing Editor | `Cmd/Ctrl + 1` |
| Focus AI Chat        | `Cmd/Ctrl + 2` |
| Focus Ideas Panel    | `Cmd/Ctrl + 3` |
| Focus Search         | `Cmd/Ctrl + /` |
| Toggle Categories    | `Cmd/Ctrl + B` |
| Toggle Zen Mode      | `Cmd/Ctrl + \` |

### Panel Actions

| Action              | Shortcut               |
| ------------------- | ---------------------- |
| Close current panel | `Cmd/Ctrl + W`         |
| Maximize panel      | `Cmd/Ctrl + M`         |
| Reset layout        | `Cmd/Ctrl + Shift + R` |

## Saved Layouts

Your workspace layout is automatically saved.

### Automatic Persistence

* **Layout configuration** saves to browser localStorage
* **Panel sizes and positions** are restored on reload
* **Visible/hidden panels** are remembered
* **Floating window positions** persist (per monitor)

### Manual Layout Management

**Save a layout preset:**

1. Arrange panels as desired
2. Click **View** → **Save Layout**
3. Name your layout (e.g., "Writing Focus", "Research Mode")
4. Layout is saved for quick switching

**Load a saved layout:**

1. Click **View** → **Load Layout**
2. Select from your saved layouts
3. Workspace instantly reconfigures

### Reset to Default

Messed up your layout?

```
View → Reset Layout
```

This restores the factory default panel configuration.

## Zen Mode

Distraction-free fullscreen writing.

### Entering Zen Mode

```
Cmd/Ctrl + \
```

**What happens:**

* All panels hide (sidebar, chat, ideas)
* Writing editor fills the screen
* Minimal UI (only editor controls remain)
* Optional writing timer overlay

### Zen Mode Settings

Configure zen mode behavior:

* **Show timer**: Display focused writing time
* **Dim background**: Reduce visual noise
* **Hide toolbar**: Maximum minimalism
* **Auto-save reminder**: Subtle save status indicator

### Exiting Zen Mode

```
Escape or Cmd/Ctrl + \
```

All panels return to their previous positions.

## Workspace Presets

Cleve includes built-in workspace presets for common workflows:

### Writing Focus

```
┌─────────────────────────────┐
│      Categories Sidebar     │
├─────────────────────────────┤
│                             │
│      Writing Editor         │
│        (maximized)          │
│                             │
└─────────────────────────────┘
```

**Use for**: Distraction-free long-form writing

### Brainstorming Mode

```
┌──────┬──────────────┬────────┐
│ Cat. │    Ideas     │   AI   │
│egory │    Panel     │  Chat  │
├──────┼──────────────┼────────┤
│      │   Writing    │        │
│      │   Editor     │        │
└──────┴──────────────┴────────┘
```

**Use for**: Capturing ideas and expanding with AI

### Research Mode

```
┌──────┬──────────────────────┐
│ Cat. │    Writing Editor    │
├──────┼──────────────────────┤
│Ideas │     AI Chat          │
│Panel │   (reference mode)   │
└──────┴──────────────────────┘
```

**Use for**: Researching and synthesizing information

### Full Productivity

```
┌──────┬──────────────┬────────┐
│ Cat. │   Writing    │   AI   │
│egory │   Editor     │  Chat  │
├──────┼──────────────┼────────┤
│Ideas │  Artifacts   │ Search │
└──────┴──────────────┴────────┘
```

**Use for**: Maximum productivity with all tools visible

## Responsive Design

Workspace adapts to your screen size.

### Desktop (1280px+)

* Full multi-panel layout
* Side-by-side panels
* Optimal for large monitors

### Tablet (768px - 1279px)

* Collapsible sidebar
* Stacked panels
* Tabs for panel switching

### Mobile (\< 768px)

* Single panel view
* Bottom navigation
* Swipe between panels

**Mobile-specific features:**

* **Swipe gestures**: Navigate between panels
* **Hamburger menu**: Access all panels
* **Fullscreen mode**: Maximize current panel

## Performance Optimization

### Large Workspaces

If you have many open panels:

* **Lazy loading**: Inactive panels don't render until focused
* **Virtual scrolling**: Long lists render only visible items
* **Memory management**: Panels unload after 5 minutes of inactivity

### Panel Limits

For optimal performance:

* **Max floating panels**: 4
* **Max docked panels**: 8 visible simultaneously
* **Max panel history**: 20 states (for undo/redo)

## Customization Options

### Themes

Workspace supports light and dark themes:

```
Settings → Appearance → Theme
```

* **Light Mode**: Clean, minimal, high contrast
* **Dark Mode**: Easy on the eyes, modern
* **Auto**: Follows system preference

### Panel Transparency

Adjust panel background opacity:

```
Settings → Workspace → Panel Transparency
```

Range: 0% (fully transparent) to 100% (solid)

### Compact Mode

Reduce padding and spacing for more content:

```
Settings → Workspace → Compact Mode
```

Increases information density at the expense of whitespace.

## Collaboration in Workspace

When collaborating, see teammate presence:

* **User avatars** in panel headers show who's viewing
* **Live cursors** in writing editor
* **Activity indicators** on panels with recent changes

See [Collaboration](/features/collaboration) for details.

## Troubleshooting

### Panels Not Resizing

**Solutions:**

* Reload the page
* Reset layout to default
* Clear browser cache
* Check browser console for errors

### Layout Not Saving

**Solutions:**

* Ensure localStorage is enabled
* Check browser privacy settings
* Not in incognito/private mode
* Manually save layout as preset

### Floating Panels Not Appearing

**Solutions:**

* Check if window is off-screen (drag from edge)
* Pop-up blocker may be preventing new windows
* Try docking panel first, then floating
* Reset layout to recover lost windows

### Performance Issues with Many Panels

**Solutions:**

* Close unused panels
* Enable compact mode
* Reduce panel transparency
* Upgrade browser or hardware

## Related Documentation

<CardGroup cols={2}>
  <Card title="Writing System" icon="pen" href="/features/writing">
    Learn about the writing editor panel.
  </Card>

  <Card title="AI Chat" icon="comments" href="/features/ai-chat">
    Understand the AI chat panel features.
  </Card>

  <Card title="Keyboard Shortcuts" icon="keyboard" href="/reference/keyboard-shortcuts">
    Master workspace navigation with shortcuts.
  </Card>

  <Card title="Zen Mode" icon="expand" href="/features/writing#zen-mode">
    Deep dive into distraction-free writing.
  </Card>
</CardGroup>
