crispybaccoon/chaivim

github github
preconfigured-configuration
stars 18
issues 0
subscribers 1
forks 0
CREATED

2023-12-01

UPDATED

6 days ago


chaivim

:tea: easily configurable neovim system with solid defaults and a cozy editor experience.

dash

telescope__config

:sparkles: Features

Lazy plugin management

chaivim uses lazy.nvim to manage plugins.

integrated plugins

  • :telescope: telescope - a highly extendable fuzzy finder.
  • :evergreen_tree: treesitter - treesitter configurations and abstraction layer for neovim.
  • :computer: keymaps - a keymap manager for neovim.
  • :airplane: lualine - a blazing fast and easy to configure neovim statusline plugin.
  • :pencil: cmp - a completion plugin for neovim.
  • :scissors: luasnip with friendly-snippets - a snippet engine for Neovim.
  • :hammer: mini.nvim - the "swiss army knife" among neovim plugins.
  • :vertical_traffic_light: gitsigns - git integration for neovim.

:lock: requirements

  • Neovim >= 0.9.0 (needs to be built with LuaJIT)
  • git >= 2.19.0 (for partial clones support)
  • a Nerd Font (optional)

:package: installation

chaivim can be installed manually or through the installer:

curl -fsSL https://github.com/comfysage/chaivim/raw/mega/utils/installer/install.sh | sh

manual install

-- init.lua
local rootpath = vim.fn.stdpath("data") .. "/core"
local chaipath = rootpath .. "/chai"

if not vim.loop.fs_stat(chaipath) then
  vim.system({
    "git",
    "clone",
    "--filter=blob:none",
    "https://github.com/comfysage/chaivim.git",
    chaipath,
  }):wait()
end

vim.opt.rtp:prepend(chaipath)

:rocket: usage

-- init.lua
require 'core'.setup {
    colorscheme = 'evergarden',
    transparent_background = false,
    modules = {
        core = {
            {
                'options',
                opts = {
                    cursorline = false,
                    tab_width = 2,
                    scrolloff = 5,
                },
            },
            {
                'dash',
                opts = {
                    open_on_startup = true,
                },
            },
        },
        custom = {
            -- your custom modules (in `lua/custom/`)
        },
    }
}

or call require 'core'.setup 'custom' to load a custom configuration from lua/custom/init.lua:

-- init.lua
require 'core'.setup 'custom'

-- lua/custom/init.lua
return {
    colorscheme = 'evergarden',
    modules = {
        core = {
            { 'options' },
            { 'base' },
        },
    }
}

all config fields can be overwritten after setup():

core.config.colorscheme = 'tokyonight'

:gear: config modules

view example configurations for modules here.

:camera: screenshots

nix-config