Repository navigation
Release Checklist
github-actions[bot] edited this page Oct 11, 2026
·
1 revision
Manual pass on a real desktop before tagging. Build the bundle (CARGO_BUILD_JOBS=2 ./scripts/bundle.sh compositor) and run it with ./scripts/run.sh compositor. Tick every box. Note anything odd in the release PR.
- Clean start with an existing profile: the session/workspace restores and only visible tiles load at first. Off-screen tiles load when you pan to them.
- First run with an empty
~/.config/spatial-browser(rename the folder): a single Google tile, no errors in the terminal. -
restarts.loggets no new lines during the whole pass.
- A typed URL opens (
example.com,https://…,localhost:8080). - Search text uses the default engine.
@y,@ddg,@wiki,@bingand@gprefixes work. - Suggestions appear while typing.
↑/↓select,Enteropens the selection or your text,Escclears the selection. - Most visited / Bookmarks tiles and Recent chips open on click and with arrows +
Enter.
- Palette
Ctrl+K: commands, open pages, bookmarks, history. Site info and About open. - Bookmarks
Ctrl+B:- Folder tree filter, Unfiled.
-
rrename/move,Space/aselect, doubleDeldeletes the selection, Move, Rename folder. - Import… from a Chrome profile.
- History
Ctrl+H:- Search covers everything. Show more / scroll loads more.
- Recent ×N, By day, By site.
-
Delremoves. On a ×N row it needs a secondDel. Clear all.
- Downloads
Ctrl+J: live progress, pause/resume/cancel. Opening an executable reveals the folder instead of running it. - Settings
Ctrl+,:- Search finds settings in other tabs. Every toggle sticks after reopening.
- Custom search engine:
javascript:is rejected. - Frame rate applies live.
- Scripts & styles
Ctrl+Shift+U: toggle, Reload, open folders. Aspatial-uistyle applies to built-in pages. - Workspaces
Ctrl+Shift+W: switch, rename, delete.Ctrl+1–9,Ctrl+N. - Help
F1, About (versions, GPU, paint path), Site info (HTTPS and HTTP page, Forget history, bookmark toggle). - Context menu (right-click page / link / image / password field), find bar
Ctrl+F(next/prev, count, Esc). -
?shows the keys overlay on every list page./focuses search,Escclears / closes.
- Create the vault (mismatch / short password errors), lock
Ctrl+Shift+L, unlock (a wrong password shows an error). - Add an entry, import Chrome/Bitwarden CSV, generator + Copy, Never save list.
- HTTPS login form: a fill suggestion appears on focus and fills. A plain-HTTP public site gets no suggestion. A local HTTP (
192.168.x,localhost) site does. - Save prompt after login: Save / Update / Never.
- After 15 min idle the vault locks and the passwords list swaps to the unlock form.
- A web page navigating to
bookmark://,settings://,history://,site://orspatial://does nothing (check the warn lines in the log).
-
window.openfrom a click opens a tile. Popups without a user gesture are blocked (logged). - A download lands in
~/Downloadswith a desktop notification. The file is not executable. - Reader mode
Ctrl+Shift+R, open in system browserCtrl+Shift+O, copy URLCtrl+Shift+C, zoom, back/forward. - Clean URLs strips
utm_*. Ad blocking on a known ad-heavy page, toggling lists in Settings.
Run each and scroll a video page (YouTube) plus a long article:
- Default (Settings → Performance: Integrated + Auto). About shows "GPU shared textures".
-
SPATIAL_BROWSER_OSR=cpu: About shows "CPU copy" and Settings shows "Pinned by". - Settings → GPU: Discrete → the restart banner shows. After restart About shows Discrete + CPU copy (Auto).
-
SPATIAL_BROWSER_GPU=high SPATIAL_BROWSER_OSR=gpu(expect black tiles on hybrid laptops. It must not crash.) - Crash recovery:
kill -9a renderer (ps -ef | grep type=renderer). Only that tile reloads. Kill it 4× and it stops auto-reloading;Ctrl+Rbrings it back. - Kill the GPU process (
type=gpu-process) a few times. The app survives.
-
cargo fmt/clippy/test -j 2green. CI green on master. - Versions bumped,
CHANGELOG.mdsection moved from Unreleased, wiki updated (synced by thewiki-syncworkflow).