{"pageProps":{"allDocs":[{"category":"Tabline","items":[{"url":"https://github.com/akinsho/bufferline.nvim","name":"akinsho/bufferline.nvim","description":"A snazzy bufferline for Neovim","created":"Mar 02, 2022 6:25","slug":"akinsho-bufferline-nvim","stars":944,"category":"Tabline"},{"url":"https://github.com/crispgm/nvim-tabline","name":"crispgm/nvim-tabline","description":"nvim port of tabline.vim with Lua","created":"Mar 02, 2022 5:03","slug":"crispgm-nvim-tabline","stars":19,"category":"Tabline"},{"url":"https://github.com/koenverburg/minimal-tabline.nvim","name":"koenverburg/minimal-tabline.nvim","description":"A minimal tabline, that's it","created":"Mar 16, 2022 12:33","slug":"koenverburg-minimal-tabline-nvim","stars":2,"category":"Tabline"},{"url":"https://github.com/nanozuki/tabby.nvim","name":"nanozuki/tabby.nvim","description":"A declarative, highly configurable, and neovim style tabline plugin. Use your nvim tabs as a workspace multiplexer!","created":"Jul 11, 2023 12:21","slug":"nanozuki-tabby-nvim","stars":381,"category":"Tabline"},{"url":"https://github.com/noib3/nvim-cokeline","name":"noib3/nvim-cokeline","description":":nose: A Neovim bufferline for people with addictive personalities","created":"Mar 02, 2022 6:22","slug":"noib3-nvim-cokeline","stars":169,"category":"Tabline"},{"url":"https://github.com/romgrk/barbar.nvim","name":"romgrk/barbar.nvim","description":"The neovim tabline plugin.","created":"Mar 02, 2022 4:01","slug":"romgrk-barbar-nvim","stars":899,"category":"Tabline"}]},{"category":"Status Line","items":[{"url":"https://github.com/alvarosevilla95/luatab.nvim","name":"alvarosevilla95/luatab.nvim","description":"Tabline lua plugin for neovim","created":"Mar 02, 2022 6:14","slug":"alvarosevilla95-luatab-nvim","stars":109,"category":"Status Line"},{"url":"https://github.com/b0o/incline.nvim","name":"b0o/incline.nvim","description":"🎈 Floating statuslines for Neovim","created":"May 09, 2022 6:38","slug":"b0o-incline-nvim","stars":105,"category":"Status Line"},{"url":"https://github.com/datwaft/bubbly.nvim","name":"datwaft/bubbly.nvim","description":"Bubbly statusline for neovim","created":"Mar 02, 2022 6:27","slug":"datwaft-bubbly-nvim","stars":167,"category":"Status Line"},{"url":"https://github.com/feline-nvim/feline.nvim","name":"feline-nvim/feline.nvim","description":"A minimal, stylish and customizable statusline for Neovim written in Lua","created":"Mar 03, 2022 12:10","slug":"feline-nvim-feline-nvim","stars":564,"category":"Status Line"},{"url":"https://github.com/konapun/vacuumline.nvim","name":"konapun/vacuumline.nvim","description":"A prebuilt configuration for galaxyline inspired by airline","created":"Mar 02, 2022 6:16","slug":"konapun-vacuumline-nvim","stars":17,"category":"Status Line"},{"url":"https://github.com/NTBBloodbath/galaxyline.nvim","name":"NTBBloodbath/galaxyline.nvim","description":"neovim statusline plugin written in lua ","created":"Mar 02, 2022 6:29","slug":"ntbbloodbath-galaxyline-nvim","stars":118,"category":"Status Line"},{"url":"https://github.com/nvim-lualine/lualine.nvim","name":"nvim-lualine/lualine.nvim","description":"A blazing fast and easy to configure neovim statusline plugin written in pure lua.","created":"Mar 13, 2022 1:22","slug":"nvim-lualine-lualine-nvim","stars":1434,"category":"Status Line"},{"url":"https://github.com/rebelot/heirline.nvim","name":"rebelot/heirline.nvim","description":"Heirline.nvim is a no-nonsense Neovim Statusline plugin designed around recursive inheritance to be exceptionally fast and versatile.","created":"Mar 13, 2022 8:55","slug":"rebelot-heirline-nvim","stars":208,"category":"Status Line"},{"url":"https://github.com/tamton-aquib/staline.nvim","name":"tamton-aquib/staline.nvim","description":"A modern lightweight statusline and bufferline for neovim in lua. Mainly uses unicode symbols for showing info.","created":"Mar 27, 2022 6:43","slug":"tamton-aquib-staline-nvim","stars":138,"category":"Status Line"},{"url":"https://github.com/windwp/windline.nvim","name":"windwp/windline.nvim","description":"Animation statusline, floating window statusline. Use lua + luv make some wind","created":"Mar 02, 2022 6:20","slug":"windwp-windline-nvim","stars":280,"category":"Status Line"}]},{"category":"Keybinding","items":[{"url":"https://github.com/b0o/mapx.nvim","name":"b0o/mapx.nvim","description":"πŸ—Ί A better way to create key mappings in Neovim.","created":"Mar 13, 2022 4:24","slug":"b0o-mapx-nvim","stars":141,"category":"Keybinding"},{"url":"https://github.com/folke/which-key.nvim","name":"folke/which-key.nvim","description":"πŸ’₯ Create key bindings that stick. WhichKey is a lua plugin for Neovim 0.5 that displays a popup with possible keybindings of the command you started typing.","created":"Mar 14, 2022 1:44","slug":"folke-which-key-nvim","stars":1189,"category":"Keybinding"},{"url":"https://github.com/mrjones2014/legendary.nvim","name":"mrjones2014/legendary.nvim","description":"πŸ—ΊοΈ A legend for your keymaps, commands, and autocmds, with which-key.nvim integration (requires Neovim nightly)","created":"Mar 12, 2022 11:35","slug":"mrjones2014-legendary-nvim","stars":210,"category":"Keybinding"},{"url":"https://github.com/simrat39/rust-tools.nvim","name":"simrat39/rust-tools.nvim","description":"Tools for better development in rust using neovim's builtin lsp","created":"Mar 14, 2022 11:53","slug":"simrat39-rust-tools-nvim","stars":684,"category":"Keybinding"}]},{"category":"LSP","items":[{"url":"https://github.com/b0o/SchemaStore.nvim","name":"b0o/SchemaStore.nvim","description":"πŸ› JSON schemas for Neovim","created":"Mar 13, 2022 4:24","slug":"b0o-schemastore-nvim","stars":159,"category":"LSP"},{"url":"https://github.com/folke/trouble.nvim","name":"folke/trouble.nvim","description":"🚦 A pretty diagnostics, references, telescope results, quickfix and location list to help you solve all the trouble your code is causing.","created":"Mar 12, 2022 3:23","slug":"folke-trouble-nvim","stars":1388,"category":"LSP"},{"url":"https://github.com/jose-elias-alvarez/nvim-lsp-ts-utils","name":"jose-elias-alvarez/nvim-lsp-ts-utils","description":"Utilities to improve the TypeScript development experience for Neovim's built-in LSP client.","created":"Mar 1, 2022 4:07 pm","slug":"jose-elias-alvarez-nvim-lsp-ts-utils","stars":373,"category":"LSP"},{"url":"https://github.com/neovim/nvim-lspconfig","name":"neovim/nvim-lspconfig","description":"Quickstart configurations for the Nvim LSP client","created":"Mar 1, 2022 4:04 pm","slug":"neovim-nvim-lspconfig","stars":3936,"category":"LSP"},{"url":"https://github.com/nvim-lua/lsp_extensions.nvim","name":"nvim-lua/lsp_extensions.nvim","description":"Repo to hold a bunch of info & extension callbacks for built-in LSP. Use at your own risk :wink:","created":"Mar 1, 2022 4:05 pm","slug":"nvim-lua-lsp-extensions-nvim","stars":193,"category":"LSP"},{"url":"https://github.com/nvim-lua/lsp-status.nvim","name":"nvim-lua/lsp-status.nvim","description":"Utility functions for getting diagnostic status and progress messages from LSP servers, for use in the Neovim statusline","created":"Mar 1, 2022 4:05 pm","slug":"nvim-lua-lsp-status-nvim","stars":426,"category":"LSP"},{"url":"https://github.com/ray-x/navigator.lua","name":"ray-x/navigator.lua","description":"Navigate codes like a breeze🎐. Exploring LSP and 🌲Treesitter symbols a piece of 🍰. Take control like a boss 🦍.","created":"Mar 1, 2022 4:07 pm","slug":"ray-x-navigator-lua","stars":572,"category":"LSP"},{"url":"https://github.com/williamboman/nvim-lsp-installer","name":"williamboman/nvim-lsp-installer","description":"Neovim plugin that allows you to seamlessly manage LSP servers with :LspInstall. With full Windows support!","created":"Mar 13, 2022 12:14","slug":"williamboman-nvim-lsp-installer","stars":1157,"category":"LSP"}]},{"category":"Guides","items":[{"url":"https://github.com/bennypowers/nvim-regexplainer","name":"bennypowers/nvim-regexplainer","description":"Describe the regexp under the cursor","created":"Mar 13, 2022 2:21","slug":"bennypowers-nvim-regexplainer","stars":183,"category":"Guides"},{"url":"https://github.com/nvim-lua/kickstart.nvim","name":"nvim-lua/kickstart.nvim","description":"A launch point for your personal nvim configuration","created":"Dec 30, 2022 2:44","slug":"nvim-lua-kickstart-nvim","stars":2356,"category":"Guides"}]},{"category":"Colorschemes","items":[{"url":"https://github.com/catppuccin/nvim","name":"catppuccin/nvim","description":"🍨 Soothing pastel theme for NeoVim","created":"Mar 13, 2022 3:31","slug":"catppuccin-nvim","stars":546,"category":"Colorschemes"},{"url":"https://github.com/dharmx/nvim-colo","name":"dharmx/nvim-colo","description":"Theming utlilities for neovim. This is very experimental at the moment.","created":"Jan 17, 2023 3:29","slug":"dharmx-nvim-colo","stars":26,"category":"Colorschemes"},{"url":"https://github.com/ful1e5/onedark.nvim","name":"ful1e5/onedark.nvim","description":"Atom's iconic One Dark theme for Neovim, written in Lua","created":"Mar 19, 2022 8:56","slug":"ful1e5-onedark-nvim","stars":174,"category":"Colorschemes"},{"url":"https://github.com/HUAHUAI23/nvim-quietlight","name":"HUAHUAI23/nvim-quietlight","description":"A theme for Neovim with support for LSP, Treesitter, and more.","created":"Feb 24, 2023 12:21","slug":"huahuai23-nvim-quietlight","stars":0,"category":"Colorschemes"},{"url":"https://github.com/kvrohit/substrata.nvim","name":"kvrohit/substrata.nvim","description":" A cold, dark color scheme for Neovim","created":"Mar 13, 2022 6:12","slug":"kvrohit-substrata-nvim","stars":56,"category":"Colorschemes"},{"url":"https://github.com/lalitmee/cobalt2.nvim","name":"lalitmee/cobalt2.nvim","description":"cobalt2 theme for neovim in Lua using colorbuddy","created":"Mar 13, 2022 4:00","slug":"lalitmee-cobalt2-nvim","stars":7,"category":"Colorschemes"},{"url":"https://github.com/luisiacc/gruvbox-baby","name":"luisiacc/gruvbox-baby","description":"Gruvbox theme for neovim with full πŸŽ„TreeSitter support. ","created":"Mar 13, 2022 12:14","slug":"luisiacc-gruvbox-baby","stars":42,"category":"Colorschemes"},{"url":"https://github.com/mhartington/oceanic-next","name":"mhartington/oceanic-next","description":"Oceanic Next theme for neovim","created":"Mar 02, 2022 6:31","slug":"mhartington-oceanic-next","stars":986,"category":"Colorschemes"},{"url":"https://github.com/Mofiqul/adwaita.nvim","name":"Mofiqul/adwaita.nvim","description":"Neovim colorscheme using Gnome Adwaita syntax","created":"Apr 15, 2022 3:56","slug":"mofiqul-adwaita-nvim","stars":38,"category":"Colorschemes"},{"url":"https://github.com/Mofiqul/dracula.nvim","name":"Mofiqul/dracula.nvim","description":"Dracula colorscheme for neovim written in Lua","created":"Mar 1, 2022 4:11 pm","slug":"mofiqul-dracula-nvim","stars":123,"category":"Colorschemes"},{"url":"https://github.com/mrjones2014/lighthaus.nvim","name":"mrjones2014/lighthaus.nvim","description":"A Lua implementation of lighthaus-theme/vim-lighthaus","created":"Apr 01, 2022 2:06","slug":"mrjones2014-lighthaus-nvim","stars":40,"category":"Colorschemes"},{"url":"https://github.com/navarasu/onedark.nvim","name":"navarasu/onedark.nvim","description":"One dark and light colorscheme for neovim >= 0.5.0 written in lua based on Atom's One Dark and Light theme. Additionally, it comes with 5 color variant styles","created":"Mar 1, 2022 10:13 pm","slug":"navarasu-onedark-nvim","stars":270,"category":"Colorschemes"},{"url":"https://github.com/NTBBloodbath/doom-one.nvim","name":"NTBBloodbath/doom-one.nvim","description":"doom-emacs' doom-one Lua port for Neovim","created":"Mar 1, 2022 10:16 pm","slug":"ntbbloodbath-doom-one-nvim","stars":74,"category":"Colorschemes"},{"url":"https://github.com/rebelot/kanagawa.nvim","name":"rebelot/kanagawa.nvim","description":"NeoVim dark colorscheme inspired by the colors of the famous painting by Katsushika Hokusai.","created":"Mar 13, 2022 8:56","slug":"rebelot-kanagawa-nvim","stars":738,"category":"Colorschemes"},{"url":"https://github.com/rose-pine/neovim","name":"rose-pine/neovim","description":"Soho vibes for Neovim","created":"Mar 1, 2022 4:11 pm","slug":"rose-pine-neovim","stars":310,"category":"Colorschemes"},{"url":"https://github.com/RRethy/nvim-base16","name":"RRethy/nvim-base16","description":"Neovim plugin for building a sync base16 colorscheme. Includes support for Treesitter and LSP highlight groups.","created":"Dec 30, 2022 2:40","slug":"rrethy-nvim-base16","stars":301,"category":"Colorschemes"},{"url":"https://github.com/sunjon/Shade.nvim","name":"sunjon/Shade.nvim","description":"An Nvim lua plugin that dims your inactive windows","created":"Dec 30, 2022 2:39","slug":"sunjon-shade-nvim","stars":374,"category":"Colorschemes"},{"url":"https://github.com/ThemerCorp/themer.lua","name":"themercorp/themer.lua","description":"A simple, minimal highlighter plugin for neovim","created":"Mar 14, 2022 11:51","slug":"themercorp-themer-lua","stars":130,"category":"Colorschemes"},{"url":"https://github.com/zanglg/nova.nvim","name":"zanglg/nova.nvim","description":"Another color scheme for neovim written in lua, WIP","created":"Oct 17, 2022 2:07","slug":"zanglg-nova-nvim","stars":82,"category":"Colorschemes"}]},{"category":"Comment","items":[{"url":"https://github.com/danymat/neogen","name":"danymat/neogen","description":"A better annotation generator. Supports multiple languages and annotation conventions.","created":"Mar 13, 2022 3:21","slug":"danymat-neogen","stars":373,"category":"Comment"}]},{"category":"Utility","items":[{"url":"https://github.com/echasnovski/mini.nvim","name":"echasnovski/mini.nvim","description":"Neovim plugin with collection of minimal, independent, and fast Lua modules dedicated to improve Neovim (version 0.5 and higher) experience","created":"Mar 27, 2022 6:45","slug":"echasnovski-mini-nvim","stars":405,"category":"Utility"},{"url":"https://github.com/hood/popui.nvim","name":"hood/popui.nvim","description":"NeoVim UI sweetness powered by popfix.","created":"Apr 15, 2022 3:41","slug":"hood-popui-nvim","stars":42,"category":"Utility"},{"url":"https://github.com/meznaric/conmenu","name":"meznaric/conmenu","description":"","created":"Mar 13, 2022 12:52","slug":"meznaric-conmenu","stars":21,"category":"Utility"},{"url":"https://github.com/mrjones2014/dash.nvim","name":"mrjones2014/dash.nvim","description":"πŸƒπŸ’¨ Search Dash.app from your Neovim fuzzy finder. Built with Rust πŸ¦€ and Lua","created":"Apr 01, 2022 2:07","slug":"mrjones2014-dash-nvim","stars":132,"category":"Utility"}]},{"category":"Cursor Line","items":[{"url":"https://github.com/edluffy/specs.nvim","name":"edluffy/specs.nvim","description":"πŸ‘“ A fast and lightweight Neovim lua plugin to keep an eye on where your cursor has jumped.","created":"Apr 15, 2022 3:31","slug":"edluffy-specs-nvim","stars":233,"category":"Cursor Line"},{"url":"https://github.com/mg979/vim-visual-multi","name":"mg979/vim-visual-multi","description":"Multiple cursors plugin for vim/neovim","created":"Apr 15, 2022 3:51","slug":"mg979-vim-visual-multi","stars":2046,"category":"Cursor Line"}]},{"category":"Code Runner","items":[{"url":"https://github.com/FeiyouG/command_center.nvim","name":"FeiyouG/command_center.nvim","description":"Create and manage keybindings and commands in a more organized manner, and search them quickly through Telescope","created":"Apr 15, 2022 3:37","slug":"feiyoug-command-center-nvim","stars":57,"category":"Code Runner"}]},{"category":"Extras","items":[{"url":"https://github.com/folke/zen-mode.nvim","name":"folke/zen-mode.nvim","description":"🧘 Distraction-free coding for Neovim","created":"Mar 1, 2022 1:08 pm","slug":"folke-zen-mode-nvim","stars":377,"category":"Extras"},{"url":"https://github.com/goolord/alpha-nvim","name":"goolord/alpha-nvim","description":"a lua powered greeter like vim-startify / dashboard-nvim","created":"Mar 14, 2022 6:22","slug":"goolord-alpha-nvim","stars":322,"category":"Extras"}]},{"category":"Start Up","items":[{"url":"https://github.com/henriquehbr/nvim-startup.lua","name":"henriquehbr/nvim-startup.lua","description":"Displays neovim startup time","created":"Mar 12, 2022 6:34","slug":"henriquehbr-nvim-startup-lua","stars":45,"category":"Start Up"},{"url":"https://github.com/lewis6991/impatient.nvim","name":"lewis6991/impatient.nvim","description":"Improve startup time for Neovim","created":"Mar 13, 2022 1:07","slug":"lewis6991-impatient-nvim","stars":563,"category":"Start Up"}]},{"category":"Session","items":[{"url":"https://github.com/HUAHUAI23/telescope-session.nvim","name":"HUAHUAI23/telescope-session.nvim","description":"manage your vim session with telescope πŸ”­","created":"Feb 24, 2023 12:20","slug":"huahuai23-telescope-session-nvim","stars":12,"category":"Session"}]},{"category":"Fuzzy Finder","items":[{"url":"https://github.com/ibhagwan/fzf-lua","name":"ibhagwan/fzf-lua","description":"Improved fzf.vim written in lua","created":"Mar 13, 2022 8:09","slug":"ibhagwan-fzf-lua","stars":418,"category":"Fuzzy Finder"},{"url":"https://github.com/nvim-telescope/telescope.nvim","name":"nvim-telescope/telescope.nvim","description":"Find, Filter, Preview, Pick. All lua, all the time.","created":"Mar 1, 2022 4:10 pm","slug":"nvim-telescope-telescope-nvim","stars":5023,"category":"Fuzzy Finder"},{"url":"https://github.com/vijaymarupudi/nvim-fzf","name":"vijaymarupudi/nvim-fzf","description":"A Lua API for using fzf in neovim.","created":"Mar 1, 2022 10:45 pm","slug":"vijaymarupudi-nvim-fzf","stars":223,"category":"Fuzzy Finder"}]},{"category":"Misc","items":[{"url":"https://github.com/iggredible/Learn-Vim","name":"iggredible/Learn-Vim","description":"Learning Vim and Vimscript doesn't have to be hard. This is the guide that you're looking for πŸ“–","created":"Dec 30, 2022 2:36","slug":"iggredible-learn-vim","stars":9061,"category":"Misc"},{"url":"https://github.com/m-demare/attempt.nvim","name":"m-demare/attempt.nvim","description":"Manage temporary buffers","created":"Sep 17, 2022 8:31","slug":"m-demare-attempt-nvim","stars":53,"category":"Misc"},{"url":"https://github.com/SmiteshP/nvim-gps","name":"SmiteshP/nvim-gps","description":"Simple statusline component that shows what scope you are working inside","created":"Mar 13, 2022 3:45","slug":"smiteshp-nvim-gps","stars":348,"category":"Misc"},{"url":"https://github.com/windwp/nvim-autopairs","name":"windwp/nvim-autopairs","description":"autopairs for neovim written by lua","created":"Nov 24, 2022 7:00","slug":"windwp-nvim-autopairs","stars":1479,"category":"Misc"},{"url":"https://github.com/zegervdv/nrpattern.nvim","name":"zegervdv/nrpattern.nvim","description":"Neovim plugin to expand incrementing/decrementing to more formats.","created":"Mar 13, 2022 6:02","slug":"zegervdv-nrpattern-nvim","stars":43,"category":"Misc"}]},{"category":"Note Taking","items":[{"url":"https://github.com/jakewvincent/mkdnflow.nvim","name":"jakewvincent/mkdnflow.nvim","description":"Tools for markdown notebook navigation and management","created":"Mar 12, 2022 11:09","slug":"jakewvincent-mkdnflow-nvim","stars":97,"category":"Note Taking"},{"url":"https://github.com/nvim-neorg/neorg","name":"nvim-neorg/neorg","description":"Modernity meets insane extensibility. The future of organizing your life in Neovim.","created":"Mar 14, 2022 11:52","slug":"nvim-neorg-neorg","stars":2078,"category":"Note Taking"}]},{"category":"Motion","items":[{"url":"https://github.com/jinh0/eyeliner.nvim","name":"jinh0/eyeliner.nvim","description":"πŸ‘€ Move faster with unique f/F indicators.","created":"Mar 23, 2023 4:23","slug":"jinh0-eyeliner-nvim","stars":170,"category":"Motion"}]},{"category":"Terminal Integration","items":[{"url":"https://github.com/jlesquembre/nterm.nvim","name":"jlesquembre/nterm.nvim","description":"neovim plugin to interact with the terminal","created":"Mar 17, 2022 3:51","slug":"jlesquembre-nterm-nvim","stars":35,"category":"Terminal Integration"}]},{"category":"Scrolling","items":[{"url":"https://github.com/karb94/neoscroll.nvim","name":"karb94/neoscroll.nvim","description":"Smooth scrolling neovim plugin written in lua","created":"Dec 30, 2022 2:39","slug":"karb94-neoscroll-nvim","stars":765,"category":"Scrolling"}]},{"category":"Git","items":[{"url":"https://github.com/kdheepak/lazygit.nvim","name":"kdheepak/lazygit.nvim","description":"Plugin for calling lazygit from within neovim.","created":"Apr 15, 2022 3:39","slug":"kdheepak-lazygit-nvim","stars":313,"category":"Git"},{"url":"https://github.com/zegervdv/settle.nvim","name":"zegervdv/settle.nvim","description":"Settle your merge conflicts from Neovim","created":"Aug 04, 2022 6:55","slug":"zegervdv-settle-nvim","stars":0,"category":"Git"}]},{"category":"File Explorer","items":[{"url":"https://github.com/kevinhwang91/rnvimr","name":"kevinhwang91/rnvimr","description":"Make Ranger running in a floating window to communicate with Neovim via RPC","created":"Mar 12, 2022 6:40","slug":"kevinhwang91-rnvimr","stars":451,"category":"File Explorer"},{"url":"https://github.com/kyazdani42/nvim-tree.lua","name":"kyazdani42/nvim-tree.lua","description":"A file explorer tree for neovim written in lua","created":"Mar 13, 2022 1:30","slug":"kyazdani42-nvim-tree-lua","stars":2040,"category":"File Explorer"}]},{"category":"Snippets","items":[{"url":"https://github.com/L3MON4D3/LuaSnip","name":"L3MON4D3/LuaSnip","description":"Snippet Engine for Neovim written in Lua.","created":"Mar 1, 2022 11:03 pm","slug":"l3mon4d3-luasnip","stars":692,"category":"Snippets"}]},{"category":"Browser Integration","items":[{"url":"https://github.com/lalitmee/browse.nvim","name":"lalitmee/browse.nvim","description":"browse for anything using your choice of method","created":"Mar 13, 2022 3:59","slug":"lalitmee-browse-nvim","stars":0,"category":"Browser Integration"}]},{"category":"Indent","items":[{"url":"https://github.com/lukas-reineke/indent-blankline.nvim","name":"lukas-reineke/indent-blankline.nvim","description":"Indent guides for Neovim","created":"Mar 17, 2022 4:03","slug":"lukas-reineke-indent-blankline-nvim","stars":1272,"category":"Indent"}]},{"category":"Formatting","items":[{"url":"https://github.com/lukas-reineke/lsp-format.nvim","name":"lukas-reineke/lsp-format.nvim","description":"A wrapper around Neovims native LSP formatting.","created":"Apr 15, 2022 2:56","slug":"lukas-reineke-lsp-format-nvim","stars":248,"category":"Formatting"}]},{"category":"Syntax","items":[{"url":"https://github.com/m-demare/hlargs.nvim","name":"m-demare/hlargs.nvim/","description":"Highlight arguments' definitions and usages, using Treesitter","created":"Mar 13, 2022 12:37","slug":"m-demare-hlargs-nvim-","stars":30,"category":"Syntax"}]},{"category":"Splits and Window","items":[{"url":"https://github.com/mrjones2014/smart-splits.nvim","name":"mrjones2014/smart-splits.nvim","description":"🧠 Smart, directional Neovim split resizing and navigation. Think about resizing splits in terms of \"move the divider to the left/right/up/down\".","created":"Apr 01, 2022 2:06","slug":"mrjones2014-smart-splits-nvim","stars":83,"category":"Splits and Window"}]},{"category":"Completion","items":[{"url":"https://github.com/noib3/nvim-compleet","name":"noib3/nvim-compleet","description":":zap: An async autocompletion framework for Neovim","created":"Apr 15, 2022 4:11","slug":"noib3-nvim-compleet","stars":413,"category":"Completion"},{"url":"https://github.com/zbirenbaum/copilot-cmp","name":"zbirenbaum/copilot-cmp","description":"Lua plugin to turn github copilot into a cmp source","created":"Apr 15, 2022 3:59","slug":"zbirenbaum-copilot-cmp","stars":69,"category":"Completion"},{"url":"https://github.com/zbirenbaum/copilot.lua","name":"zbirenbaum/copilot.lua","description":"Lua plugin for starting and interacting with github copilot","created":"Apr 15, 2022 3:59","slug":"zbirenbaum-copilot-lua","stars":100,"category":"Completion"}]},{"category":"Package Managers","items":[{"url":"https://github.com/NTBBloodbath/cheovim","name":"NTBBloodbath/cheovim","description":"Neovim configuration switcher written in Lua. Inspired by chemacs.","created":"Mar 1, 2022 4:02 pm","slug":"ntbbloodbath-cheovim","stars":145,"category":"Package Managers"},{"url":"https://github.com/savq/paq-nvim","name":"savq/paq-nvim","description":"🌚 Neovim package manager","created":"Mar 1, 2022 4:02 pm","slug":"savq-paq-nvim","stars":408,"category":"Package Managers"},{"url":"https://github.com/wbthomason/packer.nvim","name":"wbthomason/packer.nvim","description":"A use-package inspired plugin manager for Neovim. Uses native packages, supports Luarocks dependencies, written in Lua, allows for expressive config","created":"Mar 1, 2022 2:52 pm","slug":"wbthomason-packer-nvim","stars":2321,"category":"Package Managers"}]},{"category":"Game","items":[{"url":"https://github.com/ThePrimeagen/vim-be-good","name":"ThePrimeagen/vim-be-good","description":"vim-be-good is a nvim plugin designed to make you better at Vim Movements. ","created":"Mar 13, 2022 1:19","slug":"theprimeagen-vim-be-good","stars":619,"category":"Game"}]}],"pluginData":{"url":"https://github.com/nanozuki/tabby.nvim","name":"nanozuki/tabby.nvim","description":"A declarative, highly configurable, and neovim style tabline plugin. Use your nvim tabs as a workspace multiplexer!","created":"Jul 11, 2023 12:21","slug":"nanozuki-tabby-nvim","stars":381,"content":"\n\n# tabby.nvim\n\nA declarative, highly configurable, and neovim style tabline plugin. Use your\nnvim tabs as a workspace multiplexer!\n\n![](https://raw.githubusercontent.com/wiki/nanozuki/tabby.nvim/assets/banner.png)\n\n\n\n## To v1.x users\n\nTabby thinks it's essential to stay backward compatible! So even if Tabby\nreleases a brand new 2.0, it will not break the 1.0 configuration. If needed,\ncheck out the [Readme V1](./README_v1.md)!\n\nThe reasons for making the 2.0, and the improvements in 2.0, can be found at\n[#82](https://github.com/nanozuki/tabby.nvim/pull/82).\n\n## Concept\n\n**A line for the vim tab page, not for buffers**\n\nA tab page in vim holds one or more windows(not buffers). You can easily switch\nbetween tab pages to have several collections of windows to work on different\nthings.\n\nTabline can help you use multiple tabs. Meanwhile, the bufferline is simply an\narray of opened files. As a result, Bufferline limits the power of vim,\nespecially when editing a large workspace with many opened files.\n\nFor example, you are writing a backend service:\n\n - Tab1: nvim-tree, controller/user.go, entity/user.go\n - Tab2: nvim-tree, pkg/cache.go, redis/client.go\n - Tab3: Terminal\n - Tab4: Neogit.nvim\n\n**Declarative, highly configurable**\n\nTabby provides a declarative way to configure tabline. You can set the tabline\nto whatever neovim natively supports and complete the config with any lua code.\nAt least that's the goal of tabby. And also, the tabby provides some presets to\nquick start or as your example.\n\n## Install\n\nUse your plugin manager to installing 'nanozuki/tabby.com':\n\n* packer.nvim\n\n```lua\n use 'nanozuki/tabby.nvim',\n```\n\n## Setup\n\nAt default, neovim only display tabline when there are at least two tab pages.\nIf you want always display tabline:\n\n```lua\nvim.o.showtabline = 2\n```\n\nAnd you can setup your own tabline like this (check [Customize](#Customize) for\nmore details):\n\n```lua\nlocal theme = {\n fill = 'TabLineFill',\n -- Also you can do this: fill = { fg='#f2e9de', bg='#907aa9', style='italic' }\n head = 'TabLine',\n current_tab = 'TabLineSel',\n tab = 'TabLine',\n win = 'TabLine',\n tail = 'TabLine',\n}\nrequire('tabby.tabline').set(function(line)\n return {\n {\n { ' ξŸ… ', hl = theme.head },\n line.sep('ξ‚Ό', theme.head, theme.fill),\n },\n line.tabs().foreach(function(tab)\n local hl = tab.is_current() and theme.current_tab or theme.tab\n return {\n line.sep('ξ‚Ί', hl, theme.fill),\n tab.is_current() and 'ο†’' or '󰆣',\n tab.number(),\n tab.name(),\n tab.close_btn(''),\n line.sep('ξ‚Ό', hl, theme.fill),\n hl = hl,\n margin = ' ',\n }\n end),\n line.spacer(),\n line.wins_in_tab(line.api.get_current_tab()).foreach(function(win)\n return {\n line.sep('ξ‚Ί', theme.win, theme.fill),\n win.is_current() and 'ο†’' or 'ο„Œ',\n win.buf_name(),\n line.sep('ξ‚Ό', theme.win, theme.fill),\n hl = theme.win,\n margin = ' ',\n }\n end),\n {\n line.sep('ξ‚Ί', theme.tail, theme.fill),\n { ' οƒΆ ', hl = theme.tail },\n },\n hl = theme.fill,\n }\nend)\n```\n\n### Examples and Gallery\n\nThese are some awesome examples shared by tabby.nvim users! Also welcome to\nshare your own!\n\n[Discussions: show and tell](https://github.com/nanozuki/tabby.nvim/discussions/categories/show-and-tell)\n\n### Presets\n\nIf you want to quick start? That's fine, you can [Use Preset Configs](#Use-Presets).\n\n### Key mapping example\n\nTabby uses native nvim tab, so you can directly use nvim tab operation. Maybe\nyou want to map some operation. For example:\n\n```lua\nvim.api.nvim_set_keymap(\"n\", \"ta\", \":$tabnew\", { noremap = true })\nvim.api.nvim_set_keymap(\"n\", \"tc\", \":tabclose\", { noremap = true })\nvim.api.nvim_set_keymap(\"n\", \"to\", \":tabonly\", { noremap = true })\nvim.api.nvim_set_keymap(\"n\", \"tn\", \":tabn\", { noremap = true })\nvim.api.nvim_set_keymap(\"n\", \"tp\", \":tabp\", { noremap = true })\n-- move current tab to previous position\nvim.api.nvim_set_keymap(\"n\", \"tmp\", \":-tabmove\", { noremap = true })\n-- move current tab to next position\nvim.api.nvim_set_keymap(\"n\", \"tmn\", \":+tabmove\", { noremap = true })\n```\n\nAnd in fact, vim has some built-in keymapping, it's better to read `:help tabline`. Here are some useful mappings:\n\n```vimdoc\ngt\t\t\t\t\t*i_CTRL-* *i_*\n\t\tGo to the next tab page. Wraps around from the last to the\n\t\tfirst one.\n{count}gt\tGo to tab page {count}. The first tab page has number one.\ng\t\tGo to previous (last accessed) tab page.\ngT\t\tGo to the previous tab page. Wraps around from the first one\n\t\tto the last one.\n```\n\nThe `{count}` is the number displayed in presets.\n\n## Customize\n\nCustomize tabby with `require('tabby.tabline').set(fn, opt?)`:\n\n```vimdoc\ntabline.set({fn}, {opt?}) *tabby.tabline.set()*\n Set tabline renderer function\n\n Parameters: ~\n {fn} A renderer function, like \"function(line)\"\n - parameter: {line}, |tabby.object.line|, a Line object\n - return: renderer node. |tabby.object.node|\n {opt?} |LineOption|. Option of line rendering\n```\n\nAll you need is to provide a render function, that use the variable `line`\n(ref: [Line](#Line)) to complete tabline node (ref: [Node](#Node)). The `line`\nvariable gathered all features the tabby provided. And you can use `opt` (ref:\n\\[Line Option]\\(#Line Option)) to customize some behaviors.\n\nThe render function will be called every time the nvim redraws tabline. You can\nuse any valid neovim lua code to contracture the Node in this function. For\nexample, if you want display current directory in tabline, you can do like\nthis:\n\n```lua\nrequire('tabby.tabline').set(function(line)\n local cwd = ' ' .. vim.fn.fnamemodify(vim.fn.getcwd(), ':t') .. ' '\n return {\n {\n { cwd, hl = theme.head },\n line.sep('ξ‚Ό', theme.head, theme.line),\n },\n \".....\",\n }\nend, {})\n```\n\n### Line\n\n```vimdoc\nline.tabs().foreach({callback}) *tabby.line.tabs().foreach()*\n Use callback function to renderer every tabs.\n\n Parameters: ~\n {callback} Function, receive a Tab |tabby-tab|, return a\n Node |tabby-node|. Skip render when return is empty string.\n\n Return: ~\n Node |tabby-node|, rendered result of all tabs.\n\nline.wins({filter...}).foreach({callback}) *tabby.line.wins().foreach()*\n Use callback function to renderer every wins.\n\n Parameters: ~\n {filter...} Filter functions. Each function receive a |tabby-win| and\n return a boolean. If filter return false, this window won't\n be displayed in tabline.\n {callback} Function, receive a Win |tabby-win|, return a\n Node |tabby-node|. Skip render when return is empty string.\n\n Return: ~\n Node |tabby-node|, rendered result of all wins.\n\n Example: ~\n - Don't display NvimTree: >\n local funcion no_nvimtree(win)\n return not string.match(win.buf_name(), 'NvimTree')\n end\n ...\n line.wins(no_nvimtree).foreach(function\n ...\n end)\n<\n\n *tabby.line.wins_in_tab().foreach()*\nline.wins_in_tab({tabid}, {filter...}).foreach({callback})\n Use callback function to renderer every wins in specified tab.\n\n Parameters: ~\n {tabid} Number, tab id\n {filter...} Filter functions. Each function receive a |tabby-win| and\n return a boolean. If filter return false, this window won't\n be displayed in tabline.\n {callback} Function, receive a Win |tabby-win|, return a\n Node |tabby-node|. Skip render when return is empty string.\n\n Return: ~\n Node |tabby-node|, rendered result of all wins in specified tab.\n\n Example: ~\n - Don't display NvimTree: See |tabby.line.wins().foreach()|.\n\nline.spacer() *tabby.line.spacer()*\n Separation point between alignment sections. Each section will be separated\n by an equal number of spaces.\n\n Return: ~\n Node |tabby-node|, spacer node.\n\nline.truncate_point() *tabby.line.truncate_point()*\n Separation point between alignment sections. Each section will be separated\n by an equal number of spaces.\n\n Return: ~\n Node |tabby-node|, spacer node.\n\nline.sep({symbol}, {hl}, {back_hl}) *tabby.line.sep()*\n Make a separator, and calculate highlight.\n\n Parameters: ~\n [ ξ‚Ίβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆξ‚Ό ]\n | | |\n symbol hl back_hl\n {symbol} string, separator symbol\n {hl} Highlight |tabby-highlight|, current highlight\n {back_hl} Highlight |tabby-highlight|, highlight in back\n\n Return: ~\n Node |tabby-node|, sep node.\n\nline.api *tabby.line.api*\n Tabby gathered some neovim lua api in this object. Maybe help you to build\n lines. Details: |tabby-api|.\n```\n\n### Line Option\n\n```lua\n{\n tab_name = {\n name_fallback = function(tabid)\n return \"fallback name\"\n end\n },\n buf_name = {\n mode = \"'unique'|'relative'|'tail'|'shorten'\",\n }\n}\n```\n\n#### tab\\_name\n\nUse command `TabRename ` to rename tab. Use `tab.name()` (ref:\n[Tab](#Tab)) to add in your config. If no name provided, `tab.name()` will\ndisplay fallback name. The default fallback name is current window's buffer name.\n\nYou can change the fallback by provide a function in\n`opt.tab_name.name_fallback`.\n\n#### buf\\_name\n\nThere are four mode of buffer name. If current directory is \"\\~/project\" and\nthere are three buffers:\n\n* \"\\~/project/a\\_repo/api/user.py\"\n* \"\\~/project/b\\_repo/api/user.py\"\n* \"\\~/project/b\\_repo/api/admin.py\"\n\nthe result of every mode are:\n\n* unique: \"a\\_repo/api/user.py\", \"b\\_repo/api/user.py\", \"admin.py\"\n* relative: \"a\\_repo/api/user.py\", \"b\\_repo/api/user.py\", \"b\\_repo/api/admin.py\"\n* tail: \"user.py\", \"user.py\", \"admin.py\"\n* shorten: \"r/a/user.py\", \"r/b/user.py\", \"r/b/admin.py\"\n\n### Tab\n\n```vimdoc\ntab.id *tabby.tab.id*\n id of tab, tab handle for nvim api.\n\ntab.current_win() *tabby.ab.current_win()*\n\n Return: ~\n Win |tabby-win|, current window.\n\ntab.wins() *tabby.tab.wins()*\n\n Return: ~\n An Array of Win |tabby-win|, current window.\n\ntab.wins().foreach({callback}) *tabby.tab.wins().foreach()*\n See |tabby.line.wins().foreach()|.\n\ntab.number() *tabby.tab.number()*\n\n Return: ~\n Number, tab's order, start from 1.\n\ntab.is_current() *tabby.tab.is_current()*\n\n Return: ~\n Boolean, if this tab is current tab.\n\ntab.name() *tabby.tabby.tab.name()*\n\n Return: ~\n String, tab name. If name is not set, use option\n \".tab_name.name_fallback()\" in LineOption |tabby-line-option|.\n\ntab.close_btn({symbol}) *tabby.tab.close_btn()*\n Make a close button of this tab.\n\n Parameters: ~\n {symbol} String, a symbol of close button.\n\n Return: ~\n Node |tabby-node|, close button node.\n```\n\n### Win\n\n```vimdoc\nwin.id *tabby.win.id*\n id of window, win handle for nvim api.\n\nwin.tab() *tabby.win.tab()*\n\n Return: ~\n Tab |tabby-tab|, tab of this window.\n\nwin.buf() *tabby.win.buf()*\n\n Return: ~\n Buf |tabby-buf|, buf of the window.\n\nwin.is_current() *tabby.win.is_current()*\n\n Return: ~\n Boolean, if this window is current.\n\nwin.file_icon() *tabby.win.file_icon()*\n Get file icon of filetype. You need to installed plugin\n 'kyazdani42/nvim-web-devicons'.\n\n Return: ~\n Node |tabby-node|, file icon.\n\nwin.buf_name() *tabby.win.name()*\n\n Return: ~\n String, buffer name of this window. You can specify the form by using\n option \".buf_name.mode\" in LineOption |tabby-line-option|.\n```\n\n### Buf\n\nObject for buffer.\n\n```vimdoc\nbuf.id *tabby.buf.id*\n id of buffer, buffer handle for nvim api.\n\n\nbuf.is_changed() *tabby.buf.is_changed()*\n Get if buffer is changed.\n\n Return: ~\n boolean, true if there are unwritten changes, false if not\n for details.\n\n\nbuf.type() *tabby.buf.type()*\n Get buftype option.\n\n Return: ~\n buftype, normal buffer is an empty string. check |buftype| or\n for details.\n```\n\n### Node\n\nNode is the rendered unit for tabby. Node is a recursive structure. It can be:\n\n* A string: \"nvim\"\n* A Number: 12\n* A table containing a Node or an array of Node, with an optional property 'hl'\n to set highlight. Example:\n\n ```lua\n -- node 1\n {\n \"tab1\", 100\n hl = \"TabLineSel\"\n }\n -- node 2\n {\n \"text 1\"\n {\n \"text 2\",\n hl = \"Info\",\n },\n \"text3\",\n hl = \"Fill\",\n }\n ```\n\n### Highlight\n\nThere are two ways to declare a highlight:\n\n* Use the name of neovim highlight group: \"TabLineSel\"\n* Define \"background\", \"foreground\" and \"style\" in lua table:\n `{ fg = \"#000000\", bg = \"#ffffff\" style = \"bold\" } `.\n The \"style\" can be:\n * bold\n * underline\n * underlineline, double underline\n * undercurl, curly underline\n * underdot, dotted underline\n * underdash, dashed underline\n * strikethrough\n * italic\n\n### API\n\n```vimdoc\napi.get_tabs() *tabby.api.get_tabs()*\n Get all tab ids\n\napi.get_tab_wins({tabid}) *tabby.api.get_tab_wins()*\n Get an winid array in specified tabid.\n\napi.get_current_tab() *tabby.api.get_current_tab()*\n Get current tab's id.\n\napi.get_tab_current_win({tabid}) *tabby.api.get_tab_current_win()*\n Get tab's current win's id.\n\napi.get_tab_number({tabid}) *tabby.api.get_tab_number()*\n Get tab's number.\n\napi.get_wins() *tabby.api.get_wins()*\n Get all windows, except floating window.\n\napi.get_win_tab({winid}) *tabby.api.get_win_tab()*\n Get tab id of specified window.\n\napi.is_float_win({winid}) *tabby.api.is_float_win()*\n Return true if this window is floating.\n\napi.is_not_float_win({winid}) *tabby.api.is_not_float_win()*\n Return true if this window is not floating.\n```\n\n## Use Presets\n\nYou can use presets for a quick start. The preset config uses nerdfont,\nand you should use a nerdfont-patched font to display that correctly.\n\nTo use preset, you can use `use_preset({name}, {opt?})`, for example:\n\n```lua\nrequire('tabby.tabline').use_preset('active_wins_at_tail', {\n theme = {\n fill = 'TabLineFill', -- tabline background\n head = 'TabLine', -- head element highlight\n current_tab = 'TabLineSel', -- current tab label highlight\n tab = 'TabLine', -- other tab label highlight\n win = 'TabLine', -- window highlight\n tail = 'TabLine', -- tail element highlight\n },\n nerdfont = true, -- whether use nerdfont\n tab_name = {\n name_fallback = 'function({tabid}), return a string',\n },\n buf_name = {\n mode = \"'unique'|'relative'|'tail'|'shorten'\",\n },\n})\n```\n\nThe `{opt}` is an optional parameter, including all option in\n[Line Option](#Line-Option). And has some extending optins:\n\n* {theme}, the example shows the default value.\n* {nerdfont}, whether use nerdfont, default is true.\n\nThere are five `{name}` of presets:\n\n* active\\_wins\\_at\\_tail\n\n \n\n ![](https://raw.githubusercontent.com/wiki/nanozuki/tabby.nvim/assets/active_wins_at_tail.png)\n\n \n\n Put all windows' labels in active tabpage at end of whold tabline.\n\n* active\\_wins\\_at\\_end\n\n Put all windows' labels in active tabpage after all tags label. In-active\n tabpage's window won't display.\n\n \n\n ![](https://raw.githubusercontent.com/wiki/nanozuki/tabby.nvim/assets/tabby-default-1.png)\n\n \n\n* tab\\_with\\_top\\_win\n\n Each tab lab with a top window label followed. The `top window` is the focus\n window when you enter a tabpage.\n\n \n\n ![](https://raw.githubusercontent.com/wiki/nanozuki/tabby.nvim/assets/tab_with_top_win.png)\n\n \n\n* active\\_tab\\_with\\_wins\n\n Active tabpage's windows' labels is displayed after the active tabpage's label.\n\n \n\n ![](https://raw.githubusercontent.com/wiki/nanozuki/tabby.nvim/assets/active_tab_with_wins.png)\n\n \n\n* tab\\_only\n\n No windows label, only tab. and use focus window to name tab\n\n \n\n ![](https://user-images.githubusercontent.com/4208028/136306954-815d01df-bcf1-4e88-8621-8fb7aca4eac3.png)\n\n \n\n## TODO\n\n* Custom click handler\n* Telescope support\n* Style option for presets\n* Expand tabby to support statusline and winbar\n* Git info and lsp info\n"},"readMe":"

tabby.nvim

\n

A declarative, highly configurable, and neovim style tabline plugin. Use your\nnvim tabs as a workspace multiplexer!

\n

\"\"

\n

To v1.x users

\n

Tabby thinks it's essential to stay backward compatible! So even if Tabby\nreleases a brand new 2.0, it will not break the 1.0 configuration. If needed,\ncheck out the Readme V1!

\n

The reasons for making the 2.0, and the improvements in 2.0, can be found at\n#82.

\n

Concept

\n

A line for the vim tab page, not for buffers

\n

A tab page in vim holds one or more windows(not buffers). You can easily switch\nbetween tab pages to have several collections of windows to work on different\nthings.

\n

Tabline can help you use multiple tabs. Meanwhile, the bufferline is simply an\narray of opened files. As a result, Bufferline limits the power of vim,\nespecially when editing a large workspace with many opened files.

\n

For example, you are writing a backend service:

\n
- Tab1: nvim-tree, controller/user.go, entity/user.go\n- Tab2: nvim-tree, pkg/cache.go, redis/client.go\n- Tab3: Terminal\n- Tab4: Neogit.nvim\n
\n

Declarative, highly configurable

\n

Tabby provides a declarative way to configure tabline. You can set the tabline\nto whatever neovim natively supports and complete the config with any lua code.\nAt least that's the goal of tabby. And also, the tabby provides some presets to\nquick start or as your example.

\n

Install

\n

Use your plugin manager to installing 'nanozuki/tabby.com':

\n
    \n
  • packer.nvim
  • \n
\n
  use 'nanozuki/tabby.nvim',\n
\n

Setup

\n

At default, neovim only display tabline when there are at least two tab pages.\nIf you want always display tabline:

\n
vim.o.showtabline = 2\n
\n

And you can setup your own tabline like this (check Customize for\nmore details):

\n
local theme = {\n  fill = 'TabLineFill',\n  -- Also you can do this: fill = { fg='#f2e9de', bg='#907aa9', style='italic' }\n  head = 'TabLine',\n  current_tab = 'TabLineSel',\n  tab = 'TabLine',\n  win = 'TabLine',\n  tail = 'TabLine',\n}\nrequire('tabby.tabline').set(function(line)\n  return {\n    {\n      { ' ξŸ… ', hl = theme.head },\n      line.sep('ξ‚Ό', theme.head, theme.fill),\n    },\n    line.tabs().foreach(function(tab)\n      local hl = tab.is_current() and theme.current_tab or theme.tab\n      return {\n        line.sep('ξ‚Ί', hl, theme.fill),\n        tab.is_current() and 'ο†’' or '󰆣',\n        tab.number(),\n        tab.name(),\n        tab.close_btn(''),\n        line.sep('ξ‚Ό', hl, theme.fill),\n        hl = hl,\n        margin = ' ',\n      }\n    end),\n    line.spacer(),\n    line.wins_in_tab(line.api.get_current_tab()).foreach(function(win)\n      return {\n        line.sep('ξ‚Ί', theme.win, theme.fill),\n        win.is_current() and 'ο†’' or 'ο„Œ',\n        win.buf_name(),\n        line.sep('ξ‚Ό', theme.win, theme.fill),\n        hl = theme.win,\n        margin = ' ',\n      }\n    end),\n    {\n      line.sep('ξ‚Ί', theme.tail, theme.fill),\n      { ' οƒΆ ', hl = theme.tail },\n    },\n    hl = theme.fill,\n  }\nend)\n
\n

Examples and Gallery

\n

These are some awesome examples shared by tabby.nvim users! Also welcome to\nshare your own!

\n

Discussions: show and tell

\n

Presets

\n

If you want to quick start? That's fine, you can Use Preset Configs.

\n

Key mapping example

\n

Tabby uses native nvim tab, so you can directly use nvim tab operation. Maybe\nyou want to map some operation. For example:

\n
vim.api.nvim_set_keymap(\"n\", \"<leader>ta\", \":$tabnew<CR>\", { noremap = true })\nvim.api.nvim_set_keymap(\"n\", \"<leader>tc\", \":tabclose<CR>\", { noremap = true })\nvim.api.nvim_set_keymap(\"n\", \"<leader>to\", \":tabonly<CR>\", { noremap = true })\nvim.api.nvim_set_keymap(\"n\", \"<leader>tn\", \":tabn<CR>\", { noremap = true })\nvim.api.nvim_set_keymap(\"n\", \"<leader>tp\", \":tabp<CR>\", { noremap = true })\n-- move current tab to previous position\nvim.api.nvim_set_keymap(\"n\", \"<leader>tmp\", \":-tabmove<CR>\", { noremap = true })\n-- move current tab to next position\nvim.api.nvim_set_keymap(\"n\", \"<leader>tmn\", \":+tabmove<CR>\", { noremap = true })\n
\n

And in fact, vim has some built-in keymapping, it's better to read :help tabline. Here are some useful mappings:

\n
gt\t\t\t\t\t*i_CTRL-<PageDown>* *i_<C-PageDown>*\n\t\tGo to the next tab page.  Wraps around from the last to the\n\t\tfirst one.\n{count}gt\tGo to tab page {count}.  The first tab page has number one.\ng<Tab>\t\tGo to previous (last accessed) tab page.\ngT\t\tGo to the previous tab page.  Wraps around from the first one\n\t\tto the last one.\n
\n

The {count} is the number displayed in presets.

\n

Customize

\n

Customize tabby with require('tabby.tabline').set(fn, opt?):

\n
tabline.set({fn}, {opt?})                                  *tabby.tabline.set()*\n    Set tabline renderer function\n\n    Parameters: ~\n        {fn}    A renderer function, like \"function(line)\"\n                - parameter: {line}, |tabby.object.line|, a Line object\n                - return: renderer node. |tabby.object.node|\n        {opt?}  |LineOption|. Option of line rendering\n
\n

All you need is to provide a render function, that use the variable line\n(ref: Line) to complete tabline node (ref: Node). The line\nvariable gathered all features the tabby provided. And you can use opt (ref:\n[Line Option](#Line Option)) to customize some behaviors.

\n

The render function will be called every time the nvim redraws tabline. You can\nuse any valid neovim lua code to contracture the Node in this function. For\nexample, if you want display current directory in tabline, you can do like\nthis:

\n
require('tabby.tabline').set(function(line)\n    local cwd = ' ' .. vim.fn.fnamemodify(vim.fn.getcwd(), ':t') .. ' '\n    return {\n        {\n            { cwd, hl = theme.head },\n            line.sep('ξ‚Ό', theme.head, theme.line),\n        },\n        \".....\",\n    }\nend, {})\n
\n

Line

\n
line.tabs().foreach({callback})                    *tabby.line.tabs().foreach()*\n    Use callback function to renderer every tabs.\n\n    Parameters: ~\n        {callback}  Function, receive a Tab |tabby-tab|, return a\n                    Node |tabby-node|. Skip render when return is empty string.\n\n    Return: ~\n        Node |tabby-node|, rendered result of all tabs.\n\nline.wins({filter...}).foreach({callback})         *tabby.line.wins().foreach()*\n    Use callback function to renderer every wins.\n\n    Parameters: ~\n        {filter...}  Filter functions. Each function receive a |tabby-win| and\n                     return a boolean. If filter return false, this window won't\n                     be displayed in tabline.\n        {callback}   Function, receive a Win |tabby-win|, return a\n                     Node |tabby-node|. Skip render when return is empty string.\n\n    Return: ~\n        Node |tabby-node|, rendered result of all wins.\n\n    Example: ~\n      - Don't display NvimTree: >\n            local funcion no_nvimtree(win)\n              return not string.match(win.buf_name(), 'NvimTree')\n            end\n            ...\n            line.wins(no_nvimtree).foreach(function\n              ...\n            end)\n<\n\n                                            *tabby.line.wins_in_tab().foreach()*\nline.wins_in_tab({tabid}, {filter...}).foreach({callback})\n    Use callback function to renderer every wins in specified tab.\n\n    Parameters: ~\n        {tabid}      Number, tab id\n        {filter...}  Filter functions. Each function receive a |tabby-win| and\n                     return a boolean. If filter return false, this window won't\n                     be displayed in tabline.\n        {callback}   Function, receive a Win |tabby-win|, return a\n                     Node |tabby-node|. Skip render when return is empty string.\n\n    Return: ~\n        Node |tabby-node|, rendered result of all wins in specified tab.\n\n    Example: ~\n        - Don't display NvimTree: See |tabby.line.wins().foreach()|.\n\nline.spacer()                                              *tabby.line.spacer()*\n    Separation point between alignment sections. Each section will be separated\n    by an equal number of spaces.\n\n    Return: ~\n        Node |tabby-node|, spacer node.\n\nline.truncate_point()                              *tabby.line.truncate_point()*\n    Separation point between alignment sections. Each section will be separated\n    by an equal number of spaces.\n\n    Return: ~\n        Node |tabby-node|, spacer node.\n\nline.sep({symbol}, {hl}, {back_hl})            *tabby.line.sep()*\n    Make a separator, and calculate highlight.\n\n    Parameters: ~\n        [  ξ‚Ίβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆξ‚Ό   ]\n           |          |     |\n           symbol     hl    back_hl\n        {symbol}    string, separator symbol\n        {hl}        Highlight |tabby-highlight|, current highlight\n        {back_hl}   Highlight |tabby-highlight|, highlight in back\n\n    Return: ~\n        Node |tabby-node|, sep node.\n\nline.api                                                        *tabby.line.api*\n    Tabby gathered some neovim lua api in this object. Maybe help you to build\n    lines. Details: |tabby-api|.\n
\n

Line Option

\n
{\n    tab_name = {\n        name_fallback = function(tabid)\n            return \"fallback name\"\n        end\n    },\n    buf_name = {\n        mode = \"'unique'|'relative'|'tail'|'shorten'\",\n    }\n}\n
\n

tab_name

\n

Use command TabRename <tabname> to rename tab. Use tab.name() (ref:\nTab) to add in your config. If no name provided, tab.name() will\ndisplay fallback name. The default fallback name is current window's buffer name.

\n

You can change the fallback by provide a function in\nopt.tab_name.name_fallback.

\n

buf_name

\n

There are four mode of buffer name. If current directory is \"~/project\" and\nthere are three buffers:

\n
    \n
  • \"~/project/a_repo/api/user.py\"
  • \n
  • \"~/project/b_repo/api/user.py\"
  • \n
  • \"~/project/b_repo/api/admin.py\"
  • \n
\n

the result of every mode are:

\n
    \n
  • unique: \"a_repo/api/user.py\", \"b_repo/api/user.py\", \"admin.py\"
  • \n
  • relative: \"a_repo/api/user.py\", \"b_repo/api/user.py\", \"b_repo/api/admin.py\"
  • \n
  • tail: \"user.py\", \"user.py\", \"admin.py\"
  • \n
  • shorten: \"r/a/user.py\", \"r/b/user.py\", \"r/b/admin.py\"
  • \n
\n

Tab

\n
tab.id                                                            *tabby.tab.id*\n    id of tab, tab handle for nvim api.\n\ntab.current_win()                                       *tabby.ab.current_win()*\n\n    Return: ~\n        Win |tabby-win|, current window.\n\ntab.wins()                                                    *tabby.tab.wins()*\n\n    Return: ~\n        An Array of Win |tabby-win|, current window.\n\ntab.wins().foreach({callback})                      *tabby.tab.wins().foreach()*\n    See |tabby.line.wins().foreach()|.\n\ntab.number()                                                *tabby.tab.number()*\n\n    Return: ~\n        Number, tab's order, start from 1.\n\ntab.is_current()                                        *tabby.tab.is_current()*\n\n    Return: ~\n        Boolean, if this tab is current tab.\n\ntab.name()                                               *tabby.tabby.tab.name()*\n\n    Return: ~\n        String, tab name. If name is not set, use option\n        \".tab_name.name_fallback()\" in LineOption |tabby-line-option|.\n\ntab.close_btn({symbol})                                  *tabby.tab.close_btn()*\n    Make a close button of this tab.\n\n    Parameters: ~\n        {symbol}  String, a symbol of close button.\n\n    Return: ~\n        Node |tabby-node|, close button node.\n
\n

Win

\n
win.id                                                            *tabby.win.id*\n    id of window, win handle for nvim api.\n\nwin.tab()                                                      *tabby.win.tab()*\n\n    Return: ~\n        Tab |tabby-tab|, tab of this window.\n\nwin.buf()                                                      *tabby.win.buf()*\n\n    Return: ~\n        Buf |tabby-buf|, buf of the window.\n\nwin.is_current()                                        *tabby.win.is_current()*\n\n    Return: ~\n        Boolean, if this window is current.\n\nwin.file_icon()                                          *tabby.win.file_icon()*\n    Get file icon of filetype. You need to installed plugin\n    'kyazdani42/nvim-web-devicons'.\n\n    Return: ~\n        Node |tabby-node|, file icon.\n\nwin.buf_name()                                                *tabby.win.name()*\n\n    Return: ~\n        String, buffer name of this window. You can specify the form by using\n        option \".buf_name.mode\" in LineOption |tabby-line-option|.\n
\n

Buf

\n

Object for buffer.

\n
buf.id                                                            *tabby.buf.id*\n    id of buffer, buffer handle for nvim api.\n\n\nbuf.is_changed()                                        *tabby.buf.is_changed()*\n    Get if buffer is changed.\n\n    Return: ~\n        boolean, true if there are unwritten changes, false if not\n        <https://neovim.io/doc/user/options.html#'buftype'> for details.\n\n\nbuf.type()                                                    *tabby.buf.type()*\n    Get buftype option.\n\n    Return: ~\n        buftype, normal buffer is an empty string. check |buftype| or\n        <https://neovim.io/doc/user/options.html#'buftype'> for details.\n
\n

Node

\n

Node is the rendered unit for tabby. Node is a recursive structure. It can be:

\n
    \n
  • \n

    A string: \"nvim\"

    \n
  • \n
  • \n

    A Number: 12

    \n
  • \n
  • \n

    A table containing a Node or an array of Node, with an optional property 'hl'\nto set highlight. Example:

    \n
    -- node 1\n{\n  \"tab1\", 100\n  hl = \"TabLineSel\"\n}\n-- node 2\n{\n  \"text 1\"\n  {\n      \"text 2\",\n      hl = \"Info\",\n  },\n  \"text3\",\n  hl = \"Fill\",\n}\n
    \n
  • \n
\n

Highlight

\n

There are two ways to declare a highlight:

\n
    \n
  • Use the name of neovim highlight group: \"TabLineSel\"
  • \n
  • Define \"background\", \"foreground\" and \"style\" in lua table:\n{ fg = \"#000000\", bg = \"#ffffff\" style = \"bold\" } .\nThe \"style\" can be:\n
      \n
    • bold
    • \n
    • underline
    • \n
    • underlineline, double underline
    • \n
    • undercurl, curly underline
    • \n
    • underdot, dotted underline
    • \n
    • underdash, dashed underline
    • \n
    • strikethrough
    • \n
    • italic
    • \n
    \n
  • \n
\n

API

\n
api.get_tabs()                                            *tabby.api.get_tabs()*\n    Get all tab ids\n\napi.get_tab_wins({tabid})                             *tabby.api.get_tab_wins()*\n    Get an winid array in specified tabid.\n\napi.get_current_tab()                              *tabby.api.get_current_tab()*\n    Get current tab's id.\n\napi.get_tab_current_win({tabid})               *tabby.api.get_tab_current_win()*\n    Get tab's current win's id.\n\napi.get_tab_number({tabid})                         *tabby.api.get_tab_number()*\n    Get tab's number.\n\napi.get_wins()                                            *tabby.api.get_wins()*\n    Get all windows, except floating window.\n\napi.get_win_tab({winid})                               *tabby.api.get_win_tab()*\n    Get tab id of specified window.\n\napi.is_float_win({winid})                             *tabby.api.is_float_win()*\n    Return true if this window is floating.\n\napi.is_not_float_win({winid})                     *tabby.api.is_not_float_win()*\n    Return true if this window is not floating.\n
\n

Use Presets

\n

You can use presets for a quick start. The preset config uses nerdfont,\nand you should use a nerdfont-patched font to display that correctly.

\n

To use preset, you can use use_preset({name}, {opt?}), for example:

\n
require('tabby.tabline').use_preset('active_wins_at_tail', {\n  theme = {\n    fill = 'TabLineFill', -- tabline background\n    head = 'TabLine', -- head element highlight\n    current_tab = 'TabLineSel', -- current tab label highlight\n    tab = 'TabLine', -- other tab label highlight\n    win = 'TabLine', -- window highlight\n    tail = 'TabLine', -- tail element highlight\n  },\n  nerdfont = true, -- whether use nerdfont\n  tab_name = {\n      name_fallback = 'function({tabid}), return a string',\n  },\n  buf_name = {\n      mode = \"'unique'|'relative'|'tail'|'shorten'\",\n  },\n})\n
\n

The {opt} is an optional parameter, including all option in\nLine Option. And has some extending optins:

\n
    \n
  • {theme}, the example shows the default value.
  • \n
  • {nerdfont}, whether use nerdfont, default is true.
  • \n
\n

There are five {name} of presets:

\n
    \n
  • \n

    active_wins_at_tail

    \n

    \"\"

    \n

    Put all windows' labels in active tabpage at end of whold tabline.

    \n
  • \n
  • \n

    active_wins_at_end

    \n

    Put all windows' labels in active tabpage after all tags label. In-active\ntabpage's window won't display.

    \n

    \"\"

    \n
  • \n
  • \n

    tab_with_top_win

    \n

    Each tab lab with a top window label followed. The top window is the focus\nwindow when you enter a tabpage.

    \n

    \"\"

    \n
  • \n
  • \n

    active_tab_with_wins

    \n

    Active tabpage's windows' labels is displayed after the active tabpage's label.

    \n

    \"\"

    \n
  • \n
  • \n

    tab_only

    \n

    No windows label, only tab. and use focus window to name tab

    \n

    \"\"

    \n
  • \n
\n

TODO

\n
    \n
  • Custom click handler
  • \n
  • Telescope support
  • \n
  • Style option for presets
  • \n
  • Expand tabby to support statusline and winbar
  • \n
  • Git info and lsp info
  • \n
\n"},"__N_SSG":true}