App grid for a phone shell on niri

This commit is contained in:
Henry Hiles 2026-11-16 18:35:24 -05:00
commit 4f70f27a44
Signed by: Henry-Hiles
SSH key fingerprint: SHA256:VKQUdS31Q90KvX7EkKMHMBpUspcmItAh86a+v7PGiIs

19
README.md Normal file
View file

@ -0,0 +1,19 @@
# app-grid
An app grid for a phone shell on [niri](https://github.com/niri-wm/niri), as a GTK4 layer-shell surface.
It's meant to sit in niri's overview backdrop, behind the workspaces, so it shows up as the overview opens:
```kdl
layer-rule {
match namespace="^app-grid$"
place-within-backdrop true
backdrop-input true
}
```
`place-within-backdrop` on the bottom layer and `backdrop-input` aren't in upstream niri yet.
The grid's position assumes `overview { zoom 0.25; workspace-anchor 0.15; }`, see the constants at the top of `grid.js`.
Launching an app opens a splash window with its icon until the app's window opens, using `niri msg event-stream`. Set `NIRI_BIN` if `niri` isn't on `PATH`.