Skip to content

๐Ÿซ Hyperextensible Statusline / Tabline / Winbar for Neovim ๐Ÿš€

License

Notifications You must be signed in to change notification settings

MunifTanjim/nougat.nvim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

GitHub Workflow Status: CI Coverage License

๐Ÿซ nougat.nvim

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

โœจ Features

  • ๐Ÿ› ๏ธ Hyperextensible.
  • ๐Ÿš€ Fast, Performance focused, Submillisecond evaluation time.
  • ๐Ÿ–ฅ๏ธ Responsive Breakpoints, Smart Truncation.
  • ๐ŸŽจ Color Palette, Automatic and Adaptive.
  • ๐Ÿ“ฆ Modular Design, only use what you need.
  • ๐Ÿ”ฎ Dynamic statusline / tabline / winbar.
  • ๐Ÿ“ƒ Filetype Specific statusline / winbar.
  • ๐Ÿ’… Fancy Separator.
  • ๐Ÿ–ฑ๏ธ Mouse-Click.
  • ๐Ÿ’ผ Caching out-of-the-box.
  • ๐Ÿ“Š Built-in Profiler.
  • ๐Ÿฅœ Common Items included.

๐Ÿ•ธ๏ธ Requirements

  • Neovim >= 0.7.0

๐Ÿ“ฅ Installation

Install with your preferred plugin manager. For example:

With lazy.nvim

{
  "MunifTanjim/nougat.nvim",
},
With packer.nvim
use({
  "MunifTanjim/nougat.nvim",
})
With vim-plug
Plug 'MunifTanjim/nougat.nvim'

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

refresh_statusline

Signature: (force_all? boolean) -> nil

set_tabline

Signature: (bar: NougatBar | nougat_bar_selector) -> nil

bar can be a NougatBar instance or a nougat_bar_selector function.

refresh_tabline

Signature: () -> nil

set_winbar

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

bar can be a NougatBar instance or a nougat_bar_selector function.

opts is a table with one of the shapes { filetype: string } / { global?: boolean } / { winid: integer }.

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

If global is true, the bar will be used for global 'winbar', otherwise the local 'winbar' is set whenever a new window is created.

If winid is present, the bar will be used for only that specific window.

refresh_winbar

Signature: (force_all?: boolean) -> nil

Examples

A handful of examples are available to get you started.

Bubbly

Source: bubbly.lua

Bubbly Statusline

Pointy

Source: pointy.lua

Pointy Statusline

Slanty

Source: slanty.lua

Slanty Statusline


๐ŸŽจ Color Palette

Check Detailed Documentation for nougat.color

โš™๏ธ NougatBar

The sweet NougatBar represents the statusline / tabline / winbar.

Check Detailed Documentation for nougat.bar

โš™๏ธ NougatItem

Each NougatBar is made of a bunch of NougatItem.

Check Detailed Documentation for nougat.item

โš™๏ธ Separator

Separator that goes between two NougatItems.

Check Detailed Documentation for nougat.separator

โš™๏ธ Cache

Check Detailed Documentation for nougat.cache

โš™๏ธ Store

Check Detailed Documentation for nougat.store

๐Ÿฅœ Nuts

Commonly used NougatItems for your NougatBar are available inside nougat.nut.* module.

๐Ÿ“Š Profiler

The built-in profiler can be used with the :Nougat profile command.


๐Ÿ““ Links

๐Ÿ“œ License

Licensed under the MIT License. Check the LICENSE file for details.