:chocolate_bar: nougat.nvim

Hyperextensible plugin for Neovim's 'statusline', 'tabline' and 'winbar'.

:sparkles: Features

:hammer_and_wrench: Hyperextensible.
:rocket: Fast, Performance focused, Submillisecond evaluation time.
:desktop_computer: Responsive Breakpoints, Smart Truncation.
:art: Color Palette, Automatic and Adaptive.
:package: Modular Design, only use what you need.
:crystal_ball: Dynamic statusline / tabline / winbar.
:page_with_curl: Filetype Specific statusline / winbar.
:nail_care: Fancy Separator.
:computer_mouse: Mouse-Click.
:briefcase: Caching out-of-the-box.
:bar_chart: Built-in Profiler.
:peanuts: Common Items included.

:spider_web: Requirements

Neovim >= 0.7.0

:inbox_tray: Installation

Install with your preferred plugin manager. For example:

With lazy.nvim

{
  "MunifTanjim/nougat.nvim",
},

<details> <summary> <strong>With <a href="https://github.com/wbthomason/packer.nvim"><code>packer.nvim</code></a></strong> </summary>

use({
  "MunifTanjim/nougat.nvim",
})

</details> <details> <summary> <strong>With <a href="https://github.com/junegunn/vim-plug"><code>vim-plug</code></a></strong> </summary>

Plug 'MunifTanjim/nougat.nvim'

</details>

Usage

nougat.nvim is at your disposal to build exactly what you want.

local nougat = require("nougat")

`set_statusline`

Signature: (bar: NougatBar | nougat_bar_selector, opts?: { filetype?: string }) -> nil

bar can be a NougatBar instance:

local stl = Bar("statusline")

nougat.set_statusline(stl)

Or a nougat_bar_selector function (ctx: nougat_core_expression_context) -> NougatBar.

local stl = Bar("statusline")
local stl_inactive = Bar("statusline")

-- use separate statusline focused/unfocused window
nougat.set_statusline(function(ctx)
  return ctx.is_focused and stl or stl_inactive
end)

opts is a table with the shape { filetype?: string }.

If filetype is given, the bar will only be used for that filetype.

local stl_fugitive = Bar("statusline")
local stl_help = Bar("statusline")

-- set filetype specific statusline
for ft, stl_ft in pairs({
  fugitive = stl_fugitive,
  help = stl_help,
}) do
  nougat.set_statusline(stl_ft, { filetype = ft })
end