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

# Navigation

> Open, focus, move, resize, float, and tile windows across workspaces — the everyday Ryoku desktop workflow, from the keyboard.

Hyprland is a tiling compositor. New windows claim their share of the screen
automatically — no dragging, no overlapping stacks to shuffle. You drive the
whole desktop from the keyboard, and `Mod` is `Super` (the Windows or Cmd key).

This page walks the everyday workflow. [Keybindings](/docs/keybindings) is the
exhaustive reference for every shipped bind; come back here for how they fit
together.

## Open a couple of windows

When you log in nothing is open, because a tiling compositor only shows what you
launch. Open one window, then a second, and watch Hyprland split the screen
between them.

<Steps>
  <Step title="Open a terminal">
    `Mod + Return` opens the terminal (`kitty`). It fills the whole work area,
    because it is the only window.
  </Step>

  <Step title="Open the browser beside it">
    `Mod + B` opens the browser (`chromium`). It tiles in next to the terminal,
    each taking half the screen. Every new window slots into the current layout
    the same way.
  </Step>
</Steps>

`Mod + Q` closes the active window. The launcher (`Mod + Space`) opens anything
else — type to filter, `Enter` to launch.

## Focus and move windows

Focus follows **direction**, not a fixed cycle order.

| Press                 | Does                                           |
| --------------------- | ---------------------------------------------- |
| `Mod + Arrow`         | Move focus to the neighbour in that direction. |
| `Mod + Shift + Arrow` | Move the active window in that direction.      |

There is no cycle-through-every-window bind. To jump straight to a specific
window, open the launcher (`Mod + Space`) and type its title or app name — the
launcher lists open windows alongside apps and focuses the one you pick. The
[overview](#the-overview) (`Mod + Tab`) is the visual alternative: click any
window to focus it.

## Resize windows

Two ways, depending on whether you want a quick nudge or a sustained resize.

* **Nudge.** `Mod + Ctrl + Arrow` grows or shrinks the active window a step at a
  time. Hold it to keep resizing.
* **Resize mode.** `Mod + R` enters a resize submap and pops a toast. Now the
  bare **arrows** — or `hjkl` — resize the window; `Esc` (or `Return`, or
  `Mod + R` again) leaves the mode. The submap is exclusive, so plain arrows
  resize instead of moving focus.

## Float and fullscreen

* `Mod + F` toggles fullscreen for the active window.
* `Mod + A` floats the active window at **1000 × 660, centred**. Press it again
  to tile the window back into the layout. Reach for it when you want a
  calculator, a small dialog, or one window lifted out of the tiles.

## Workspaces

Each monitor carries ten workspaces.

| Press               | Does                                               |
| ------------------- | -------------------------------------------------- |
| `Mod + 1 … 0`       | Focus workspace N on the monitor under the cursor. |
| `Mod + Alt + 1 … 0` | Send the active window to workspace N.             |
| `Mod + Scroll`      | Cycle to the previous / next workspace.            |
| `Mod + Tab`         | Open the overview (workspace expo).                |

The number keys are **desktop-relative**. A *desktop* is a block of ten
workspace ids, so on desktop 2, `Mod + 3` focuses workspace 13, never
workspace 3 — each desktop keeps its own 1–10 and windows never jump between
desktops. The workspace is also pulled to whichever monitor the cursor is on,
so the same keys drive every screen instead of always yanking focus to the
laptop panel.

### The overview

`Mod + Tab` opens a full-screen expo: every workspace on the current desktop as
a scaled mini-desktop with live window previews. From here you can:

* Click a workspace to switch to it, or click a window to focus it.
* Drag a window between workspaces, or up onto the top strip to move it to
  another desktop.
* Hover a window for a `✕` to close it.
* Scroll or `Tab` to move the selection, `Enter` to commit, `Esc` to dismiss.

A second level shows your **desktops** — each a block of ten workspaces with its
own 01–10 set, so you can keep separate groups of workspaces for different work.
`Mod + Alt + Tab` steps between desktops (`Tab` again inside the overview cycles
them).

## Scratchpad

The scratchpad is a hidden special workspace for a window you want one keypress
away — a notes terminal, a chat, a music player.

* `Mod + H` toggles the scratchpad in and out of view.
* `Mod + Shift + H` stashes the active window into it (floated at 1280 × 800,
  centred).

Press `Mod + H` again to tuck it back out of sight.

## Mouse

You rarely need the mouse, but it is there when a quick drag is faster:

* `Mod + Left-drag` moves the window under the cursor.
* `Mod + Right-drag` resizes it.

## Multiple monitors

Ryoku is monitor-aware. Because `Mod + 1 … 0` pulls the target workspace to the
monitor your cursor is on, the workspace keys always act on the screen you are
pointing at — you never reach for a different set of binds per display.

`Mod + P` toggles mirror versus extend (`ryoku-monitor toggle`). Set
resolutions, scale, rotation, and layout in
[Settings](/docs/settings) → Displays; see [Hardware](/docs/hardware) for the
details.

## Next

<CardGroup cols={2}>
  <Card title="Keybindings" icon="keyboard" href="/docs/keybindings">
    Every shipped bind in one reference table.
  </Card>

  <Card title="Desktop tour" icon="binoculars" href="/docs/tour">
    The shell surfaces you are navigating between.
  </Card>
</CardGroup>