Layouts overview
You will learn
- What layouts Shoji includes
- Which layout fits which workflow
- How to extend layouts with modifiers
Shoji includes seven built-in layouts. Each layout arranges windows differently to suit various workflows.
Overview
| Layout | Description | Ratio | NMaster | Resize | State |
|---|---|---|---|---|---|
| Tall | Main left, stack right | ✓ | ✓ | — | — |
| Wide | Main top, stack bottom | ✓ | ✓ | — | — |
| Fullscreen | Windows stacked full size | — | — | — | — |
| BSP | Recursive binary splits | — | — | ✓ | ✓ |
| Column | Equal-width columns | — | — | — | — |
| Floating | No automatic tiling | — | — | — | — |
| Grid | Even grid pattern | — | — | — | — |
Legend:
- Ratio: Supports
main_ratioadjustment - NMaster: Supports
nmasteradjustment - Resize: Per-window resize with layout-specific actions
- State: Maintains state between retiles
Choosing a layout
For focus work with one main window: Tall or Wide layouts emphasize a primary window with supporting windows alongside.
For managing many equal windows: BSP or Grid layouts treat all windows equally without hierarchy.
For distraction-free work: Fullscreen stacks windows so only the focused one is visible.
For manual control: Floating disables automatic tiling entirely.
Custom layouts
Create your own layouts. See Creating custom layouts for details.
Layout modifiers
Modify built-in layouts with decorators. See Layout modifiers for available modifiers.