detached e2cc33e

docs: update README with stacked panes documentation

Add comprehensive documentation for the new Zellij-style stacked panes feature:
- Updated keyboard shortcuts table with 'S' for stack pane and Alt+Up/Down navigation
- Enhanced pane management workflow description with stacking option
- Added stacked panes to features list with title bar behavior details
- Clarified navigation between split panes vs stacked panes
commit
e2cc33e5efc81c253d26005622362929ede0c14a
author
bamen · · 2025-09-25 05:19 UTC
parent
f3aa007
signature
unsigned
1 file · +6 -2
M README.md +6 -2
@@ -59,10 +59,12 @@ Dumber is a minimalist browser and launcher companion focused on speed and simpl
5959 | **←** / **L** (in pane mode) | Split Left | Create new pane to the left |
6060 | **↑** / **U** (in pane mode) | Split Up | Create new pane above |
6161 | **↓** / **D** (in pane mode) | Split Down | Create new pane below |
62+| **S** (in pane mode) | Stack Pane | Create stacked pane (Zellij-style) |
6263 | **X** (in pane mode) | Close Pane | Close current pane |
6364 | **Enter** (in pane mode) | Confirm Action | Confirm pane operation |
6465 | **Escape** (in pane mode) | Exit Pane Mode | Return to normal navigation |
6566 | **Alt+Arrow Keys** | Navigate Panes | Move focus between panes |
67+| **Alt+Up/Down** | Navigate Stack | Navigate between stacked panes |
6668
6769 ### Mouse Controls
6870 | Action | Result | Notes |
@@ -159,16 +161,18 @@ Dumber features a Zellij-inspired pane management system that allows you to spli
159161
160162 ### How it Works
161163 1. **Enter Pane Mode**: Press `Ctrl+P` to enter pane mode (modal interface with timeout)
162-2. **Split Panes**: Use arrow keys or letter shortcuts to split:
164+2. **Split or Stack Panes**: Use arrow keys or letter shortcuts:
163165 - `→` or `R` - Split right
164166 - `←` or `L` - Split left
165167 - `↑` or `U` - Split up
166168 - `↓` or `D` - Split down
167-3. **Navigate**: Use `Alt+Arrow Keys` to move focus between panes
169+ - `S` - Stack panes (Zellij-style, shows title bars for collapsed panes)
170+3. **Navigate**: Use `Alt+Arrow Keys` to move focus between split panes, or `Alt+Up/Down` to navigate within stacked panes
168171 4. **Close**: Press `X` in pane mode to close the current pane
169172
170173 ### Features
171174 - **Binary tree layout**: Panes are organized in a binary tree structure for optimal space usage
175+- **Stacked panes**: Zellij-style stacking with collapsed title bars showing "Page Title - domain" for inactive panes
172176 - **Focus management**: Visual borders, hover-to-focus, and enhanced focus throttling (100ms) for intuitive navigation
173177 - **Independent sessions**: Each pane maintains its own browsing session, history, and zoom level
174178 - **Advanced popup handling**: Intelligent popup vs tab detection, OAuth auto-close, and popup deduplication with SHA256 fingerprinting
@@ -59,10 +59,12 @@ Dumber is a minimalist browser and launcher companion focused on speed and simpl
59 | **←** / **L** (in pane mode) | Split Left | Create new pane to the left |59 | **←** / **L** (in pane mode) | Split Left | Create new pane to the left |
60 | **↑** / **U** (in pane mode) | Split Up | Create new pane above |60 | **↑** / **U** (in pane mode) | Split Up | Create new pane above |
61 | **↓** / **D** (in pane mode) | Split Down | Create new pane below |61 | **↓** / **D** (in pane mode) | Split Down | Create new pane below |
62+| **S** (in pane mode) | Stack Pane | Create stacked pane (Zellij-style) |
62 | **X** (in pane mode) | Close Pane | Close current pane |63 | **X** (in pane mode) | Close Pane | Close current pane |
63 | **Enter** (in pane mode) | Confirm Action | Confirm pane operation |64 | **Enter** (in pane mode) | Confirm Action | Confirm pane operation |
64 | **Escape** (in pane mode) | Exit Pane Mode | Return to normal navigation |65 | **Escape** (in pane mode) | Exit Pane Mode | Return to normal navigation |
65 | **Alt+Arrow Keys** | Navigate Panes | Move focus between panes |66 | **Alt+Arrow Keys** | Navigate Panes | Move focus between panes |
67+| **Alt+Up/Down** | Navigate Stack | Navigate between stacked panes |
66 68
67 ### Mouse Controls69 ### Mouse Controls
68 | Action | Result | Notes |70 | Action | Result | Notes |
@@ -159,16 +161,18 @@ Dumber features a Zellij-inspired pane management system that allows you to spli
159 161
160 ### How it Works162 ### How it Works
161 1. **Enter Pane Mode**: Press `Ctrl+P` to enter pane mode (modal interface with timeout)163 1. **Enter Pane Mode**: Press `Ctrl+P` to enter pane mode (modal interface with timeout)
162-2. **Split Panes**: Use arrow keys or letter shortcuts to split:164+2. **Split or Stack Panes**: Use arrow keys or letter shortcuts:
163 - `→` or `R` - Split right165 - `→` or `R` - Split right
164 - `←` or `L` - Split left166 - `←` or `L` - Split left
165 - `↑` or `U` - Split up167 - `↑` or `U` - Split up
166 - `↓` or `D` - Split down168 - `↓` or `D` - Split down
167-3. **Navigate**: Use `Alt+Arrow Keys` to move focus between panes169+ - `S` - Stack panes (Zellij-style, shows title bars for collapsed panes)
170+3. **Navigate**: Use `Alt+Arrow Keys` to move focus between split panes, or `Alt+Up/Down` to navigate within stacked panes
168 4. **Close**: Press `X` in pane mode to close the current pane171 4. **Close**: Press `X` in pane mode to close the current pane
169 172
170 ### Features173 ### Features
171 - **Binary tree layout**: Panes are organized in a binary tree structure for optimal space usage174 - **Binary tree layout**: Panes are organized in a binary tree structure for optimal space usage
175+- **Stacked panes**: Zellij-style stacking with collapsed title bars showing "Page Title - domain" for inactive panes
172 - **Focus management**: Visual borders, hover-to-focus, and enhanced focus throttling (100ms) for intuitive navigation176 - **Focus management**: Visual borders, hover-to-focus, and enhanced focus throttling (100ms) for intuitive navigation
173 - **Independent sessions**: Each pane maintains its own browsing session, history, and zoom level177 - **Independent sessions**: Each pane maintains its own browsing session, history, and zoom level
174 - **Advanced popup handling**: Intelligent popup vs tab detection, OAuth auto-close, and popup deduplication with SHA256 fingerprinting178 - **Advanced popup handling**: Intelligent popup vs tab detection, OAuth auto-close, and popup deduplication with SHA256 fingerprinting

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 8

Tags 42

↑↓ moveenter openesc close