Skip to content

Zen Extra

ui.zen enables Snacks zen mode for distraction-free editing. It adds one discoverable keymap and otherwise leaves your normal windows alone.

Enable it

-- ~/.config/blak/lua/blak/user.lua
return {
extras = {
enabled = {
"ui.zen",
},
},
}

Or enable it from Neovim:

:BlakExtras enable ui.zen

What it adds

SurfaceContribution
Snackszen.enabled = true
Keymap<leader>uz toggles zen mode

The keymap appears in :BlakKeys.

Configure zen mode

Snacks zen options go under snacks.zen:

return {
extras = {
enabled = { "ui.zen" },
},
snacks = {
zen = {
toggles = {
dim = true,
git_signs = false,
diagnostics = false,
inlay_hints = false,
},
center = true,
show = {
statusline = false,
tabline = false,
},
win = {
width = 100,
},
},
},
}

To keep statusline context visible while focused:

return {
extras = {
enabled = { "ui.zen", "ui.lualine" },
},
snacks = {
zen = {
show = {
statusline = true,
},
},
},
}

Use it

<leader>uz

Or call Snacks directly:

:lua require("snacks").zen()

Disable it by removing "ui.zen" from extras.enabled or running :BlakExtras disable ui.zen.