Editor options

Blak applies a small set of editor options at startup. They live in lua/blak/core/options.lua and run before plugins load.

Anything here can be overridden in your user.lua (via the editor.* table) or by reassigning vim.opt.* after Blak’s setup.

What gets set

Visual

Option	Value	Why
`termguicolors`	`true`	True-color rendering for the colorscheme + splash.
`number`	`true`	Line numbers.
`relativenumber`	from `editor.relative_number` (default `true`)	Relative line numbers; toggle with the config.
`cursorline`	`true`	Highlight the current line.
`signcolumn`	`"yes"`	Always show signcolumn so it doesn’t shift.
`pumheight`	`12`	Cap completion popup height.
`wrap`	`false`	Hard newlines only.
`linebreak`	`true`	When wrap is on (you turned it on), break on word boundaries.
`breakindent`	`true`	Wrapped lines keep their indent.

Splits

Option	Value	Why
`splitbelow`	`true`	New horizontal splits go below.
`splitright`	`true`	New vertical splits go right.

Search

Option	Value	Why
`ignorecase`	`true`	Case-insensitive search…
`smartcase`	`true`	…unless the query has uppercase.
`inccommand`	`"split"`	`:s` previews matches live in a split.
`grepprg`	`rg --vimgrep --smart-case --hidden`	`:grep` uses ripgrep.

Persistence

Option	Value	Why
`undofile`	`true`	Persist undo across sessions.
`confirm`	from `editor.confirm` (default `true`)	Prompt before commands abandon unsaved changes.
`updatetime`	`250`	Faster CursorHold / swap writes — drives gitsigns blame, etc.
`timeoutlen`	`400`	Tighter mapping timeout for which-key.

Movement

Option	Value	Why
`scrolloff`	from `editor.scrolloff` (default `8`)	Keep context above/below cursor.
`sidescrolloff`	from `editor.sidescrolloff` (default `8`)	Same horizontally.
`smoothscroll`	`true` (if available)	Smooth scroll on Neovim 0.10+.
`jumpoptions`	`"view"` (if available)	Jumps remember view position.

Indent

Option	Value	Why
`tabstop`	from `editor.tabstop` (default `2`)	Spaces a tab character displays as.
`shiftwidth`	from `editor.shiftwidth` (default `2`)	Spaces for `<<` / `>>`.
`expandtab`	from `editor.expandtab` (default `true`)	Use spaces, not tabs.
`autoindent`	`true`	Carry the current line’s indent when opening a new line.
`smartindent`	`true`	Add simple syntax-aware indent after opening braces when no language indent is active.

Completion

Option	Value	Why
`completeopt`	`"menu,menuone,noselect"`	Show menu always, don’t auto-select.

Clipboard

Option	Value	Why
`clipboard`	`"unnamedplus"` if `editor.clipboard` (default true)	Yank and paste use the system clipboard.

Overriding

In user.lua:

return {
  editor = {
    tabstop = 4,
    shiftwidth = 4,
    relative_number = false,
    confirm = false,
    clipboard = false,
    scrolloff = 4,
  },
}

Or set vim.opt.* directly after Blak loads:

vim.api.nvim_create_autocmd("User", {
  pattern = "BlakReady",
  callback = function()
    vim.opt.cursorline = false
    vim.opt.signcolumn = "number"
  end,
})

See User events.