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

# Menu Structure

> Complete guide to all menus, options, and navigation paths on your Chastity Lockbox

Your Chastity Lockbox uses a hierarchical menu system for navigation. This guide documents all menus, their options, and how to navigate between them.

## Navigation basics

* **Rotate encoder**: Move between menu options
* **Press Enter**: Select the highlighted option
* **Press Back**: Return to previous menu or screen

<Info>
  The currently selected option is highlighted on screen. Options scroll as you turn the encoder past the visible items.
</Info>

## Main menu

The main menu appears when your device is unlocked and ready for use.

| Option       | Icon    | Description                                           |
| ------------ | ------- | ----------------------------------------------------- |
| Lock         | Clock   | Start a timed lock (you set the duration)             |
| Lock Forever | Padlock | Start an indefinite lock (keyholder controls release) |
| Settings     | Gear    | Access device settings                                |
| Sleep        | Moon    | Enter manual deep sleep mode                          |

### Lock

Opens the timer configuration screen where you can set a duration from 30 seconds to 1000 years. See [Timer Duration Limits](./timer-duration-limits) for details.

### Lock Forever

Displays a confirmation screen before engaging permalock mode. The device locks indefinitely until your keyholder unlocks it or you use emergency unlock. See [Permalock Mode](../device-states/permalock).

### Settings

Opens the settings submenu for device configuration.

### Sleep

Displays a confirmation screen before entering manual deep sleep. In deep sleep, WiFi disconnects and the device uses minimal power.

## Settings menu

Access from Main Menu → Settings.

| Option         | Icon     | Description                             |
| -------------- | -------- | --------------------------------------- |
| Go Back        | Arrow    | Return to main menu                     |
| WiFi Settings  | WiFi     | Configure WiFi network connection       |
| Pairing        | Link     | Pair device with your dashboard account |
| Update Device  | Download | Check for and install firmware updates  |
| Enrol in Alpha | Beaker   | Join the alpha update channel           |
| Restart Device | Refresh  | Restart the device                      |

### WiFi Settings

Opens the WiFi configuration portal. A QR code appears on screen that you can scan with your phone to connect to the device's setup network and enter your WiFi credentials.

### Pairing

Displays your 6-character pairing code and a QR code for quick dashboard pairing. Requires WiFi connection.

<Note>
  If WiFi is not connected when you select Pairing, you'll be prompted to set up WiFi first.
</Note>

### Update Device

Checks for available firmware updates. If an update is found, it downloads and installs automatically. Requires WiFi connection.

### Enrol in Alpha

Joins the alpha update channel to receive early-access firmware before general release. The device restarts after enrolling.

<Warning>
  Alpha firmware is tested but may contain experimental features. You can unenroll by reflashing standard firmware.
</Warning>

### Restart Device

Immediately restarts the device. Lock state is preserved through restarts.

## Lock menu (while locked)

When your device is locked (timed or permanent), press the Enter button to open the lock menu. The available options depend on your session settings configured by your keyholder.

### Full lock menu

When all options are enabled:

| Option           | Icon    | Description                          |
| ---------------- | ------- | ------------------------------------ |
| Go Back          | Arrow   | Return to lock screen                |
| Sleep            | Moon    | Enter manual deep sleep              |
| WiFi Settings    | WiFi    | Configure WiFi (for updates/sync)    |
| Take A Break     | Coffee  | Start a temporary break period       |
| Emergency Unlock | Warning | Immediately unlock (24-hour penalty) |
| Restart Device   | Refresh | Restart while staying locked         |

### Menu variations

Your keyholder can disable certain options through the dashboard. The menu adapts accordingly:

#### If Emergency Unlock is disabled

The Emergency Unlock option is hidden. The only ways to unlock are:

* Wait for timer to expire (timed locks)
* Keyholder unlocks remotely
* Physical backplate emergency unlock

#### If Breaks are not enabled

The Take A Break option is hidden. You cannot take breaks during this lock session.

#### Minimal menu (no break, no emergency unlock)

| Option         | Icon    | Description             |
| -------------- | ------- | ----------------------- |
| Go Back        | Arrow   | Return to lock screen   |
| Sleep          | Moon    | Enter manual deep sleep |
| WiFi Settings  | WiFi    | Configure WiFi          |
| Restart Device | Refresh | Restart device          |

## Confirmation screens

Several actions require confirmation before proceeding:

### Lock Forever confirmation

Displays warning text and a QR code linking to documentation. Options:

* **Lock**: Confirm and engage permalock
* **Back**: Cancel and return to main menu

### Sleep confirmation

Displays information about sleep mode effects. Options:

* **Sleep**: Confirm and enter deep sleep
* **Back**: Cancel and return to menu

### Emergency Unlock confirmation

Displays warning about 24-hour lockout penalty. Options:

* **Unlock**: Confirm emergency unlock
* **Back**: Cancel and return to lock menu

### Take A Break confirmation

Displays information about break timing. Options:

* **Break**: Start the break period
* **Back**: Cancel and return to lock menu

## Error screens

Error screens display with a QR code linking to troubleshooting documentation:

| Error     | Screen title          | Options            |
| --------- | --------------------- | ------------------ |
| E-LOCK-1  | Could Not Lock        | Retry, Calibrate   |
| E-LOCK-2  | Could Not Unlock      | Retry, Calibrate   |
| E-LOCK-3  | No Backplate Detected | Restart, Calibrate |
| E-LOCK-10 | Could Not Connect     | Return to menu     |
| E-LOCK-20 | Emergency Unlocked    | WiFi Setup         |

See [Device Errors](../errors/introduction) for detailed troubleshooting.

## Navigation flow

```
┌─────────────────────────────────────────────────────┐
│                    UNLOCKED                          │
├─────────────────────────────────────────────────────┤
│                    Main Menu                         │
│  ├── Lock ──────────────► Timer Config ──► Locking  │
│  ├── Lock Forever ──────► Confirm ──────► Locking   │
│  ├── Settings                                        │
│  │   ├── Go Back                                    │
│  │   ├── WiFi Settings ──► WiFi Portal              │
│  │   ├── Pairing ────────► Pairing Screen           │
│  │   ├── Update Device ──► Update Screen            │
│  │   ├── Enrol in Alpha ─► Confirm ──► Restart      │
│  │   └── Restart Device ─► Restart                  │
│  └── Sleep ─────────────► Confirm ──► Deep Sleep    │
└─────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────┐
│                     LOCKED                           │
├─────────────────────────────────────────────────────┤
│            Lock Screen (timer display)               │
│  └── Enter Button ──────► Lock Menu                 │
│      ├── Go Back                                    │
│      ├── Sleep ─────────► Confirm ──► Deep Sleep    │
│      ├── WiFi Settings ─► WiFi Portal               │
│      ├── Take A Break* ─► Confirm ──► Break Timer   │
│      ├── Emergency* ────► Confirm ──► Unlock        │
│      └── Restart Device ► Restart                   │
│                                                      │
│  * May be hidden based on session settings          │
└─────────────────────────────────────────────────────┘
```

## Related guides

<CardGroup cols={2}>
  <Card title="Button Controls" icon="hand-pointer" href="./button-controls">
    Detailed button and encoder functions.
  </Card>

  <Card title="Quick Start" icon="rocket" href="../quick-start/introduction">
    Getting started with your Lockbox.
  </Card>

  <Card title="Device States" icon="microchip" href="../device-states/introduction">
    Understanding device operational modes.
  </Card>

  <Card title="Device Errors" icon="triangle-exclamation" href="../errors/introduction">
    Troubleshooting error screens.
  </Card>
</CardGroup>
