Giter Club home page Giter Club logo

efficienvim's Introduction

Efficienvim - A Highly Efficient & Multifaceted Neovim Starter Configuration entirely in lua with Lazy.nvim

Efficienvim Dashboard

Note: This is only a starter configuration to get started with Neovim with Efficiency & Enjoyment. After installation, you should remove the .git folder so that you can add your own repo later and fully customise(ricing) your Neovim on your own liking & preferences.

๐Ÿ‘€ Requirements

  • Make sure you know some basic vim commands.
  • Nerd Fonts
  • Neovim 0.9+ (Not including nightly)
  • A clipboard tool is necessary for the integration with the system clipboard (see :help clipboard-tool for supported solutions)
    • xclip is recommended for WSL users.
  • Terminal with true color support (for the default theme, otherwise it is dependent on the theme you are using)
  • Optional Requirements:
    • ripgrep - live grep telescope search (<leader>ps)
    • lazygit - lazygit ui toggle inside NeoVim (:LazyGit)

Note

  • The leader key is set as <space> key in the keymaps.lua file which loads and should always load after all the plugins are loaded. So make sure when customising the configuration further, you don't set any keybinding involving the <leader> key in lazy.lua(which loads all the plugins).
  • Efficienvim has two versions.
    • The main branch is the default one that's the ordinary(user-friendlier) version. It uses Neotree plugin as its file-explorer(which is auto-opened at the left-side of the Neovim window at startup) instead of the Netrw file-exlorer that comes with Neovim. It doesn't have any dashboard.
    • The enhanced branch is the more advanced (with more plugins as enhanced features) version. It uses Oil.nvim plugin as its file-explorer(you will be able to edit the file system like a regular buffer). It has a beautiful dashboard which opens at startup.

๐Ÿ› ๏ธ Installation

Efficienvim is supported better on MacOS, Linux & WSL. If you use Windows then installing in WSL is Recommended.

Linux/Mac OS/WSL (Unix)

Make a backup of your current nvim and shared folder

mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak

Clone the repository

Complete Installation(Both branches, both versions)
git clone https://github.com/Debajyati/Efficienvim ~/.config/nvim
nvim
Seperate Installation(Installing a specific version/branch)
git clone -b main --single-branch https://github.com/Debajyati/Efficienvim ~/.config/nvim # Installing the only the ordinary version (branchname - 'main')
nvim

Or,

git clone -b enhanced --single-branch https://github.com/Debajyati/Efficienvim ~/.config/nvim # Installing the only the enhanced version (branchname - 'enhanced')
nvim

Windows (Powershell Core or Windows Powershell only. Don't use Command prompt.)

Make a backup of your current nvim and nvim-data folder

Rename-Item -Path $env:LOCALAPPDATA\nvim -NewName $env:LOCALAPPDATA\nvim.bak
Rename-Item -Path $env:LOCALAPPDATA\nvim-data -NewName $env:LOCALAPPDATA\nvim-data.bak

Clone the repository

Complete Installation(Both branches, both versions)
git clone https://github.com/Debajyati/Efficienvim $env:LOCALAPPDATA\nvim
nvim
Seperate Installation(Installing a specific version/branch)
git clone -b main --single-branch https://github.com/Debajyati/Efficienvim $env:LOCALAPPDATA\nvim # Installing the only the ordinary version (branchname - 'main')
nvim

Or,

git clone -b enhanced --single-branch https://github.com/Debajyati/Efficienvim $env:LOCALAPPDATA\nvim # Installing the only the enhanced version (branchname - 'enhanced')
nvim

Tip

Always run :checkhealth after any configuration changes to diagnose any problem with the configuration (if any) so that necessary steps can be taken.

๐Ÿ‘จ๐Ÿฝโ€๐Ÿ’ป Initial Setup

Install Preferred LSP

Enter :LspInstall or :MasonInstall followed by the name of the server you want to install
Example: :LspInstall clangd or :MasonInstall clangd for C/C++

Install Treesitter(language parser in simple words, which enables better syntax highlighting)

Enter :TSInstall followed by the name of the language you want to install
Example: :TSInstall c for c language

Debugger Support

Efficienvim won't come with DAP(Debug Adapter Protocol). If you want debugging support you would need to install nvim-dap & nvim-dap-ui first with lazy.nvim(the plugin manager Efficienvim uses) or any other plugin that gives debugger support in Neovim.

How to Manage Installed plugins?

  • :Lazy - opens the Lazy.nvim ui(A graphical status window)

  • :Lazy check - checks for plugin updates

  • :Lazy update - applies any pending plugin updates

  • :Lazy clean - removes any disabled or unused plugins

  • :Lazy sync - updates and clean plugins

Run :h Lazy for more info.

How to Manage Installed LSPs

  • :Mason - opens a graphical status window

  • :MasonUpdate - updates all managed registries

  • :MasonInstall <package> ... - installs/re-installs the provided packages

  • :MasonUninstall <package> ... - uninstalls the provided packages

  • :MasonUninstallAll - uninstalls all packages

  • :MasonLog - opens the mason.nvim log file in a new tab window

Run :h Mason for more info.

Tree Structure of the Configuration Files

  .
  โ”œโ”€โ”€ init.lua
  โ”œโ”€โ”€ lazy-lock.json
  โ””โ”€โ”€ lua
      โ””โ”€โ”€ config  
          โ”œโ”€โ”€ autocmds.lua        
          โ”œโ”€โ”€ keymaps.lua        
          โ”œโ”€โ”€ lazy.lua        
          โ”œโ”€โ”€ lspsettings.lua
          โ”œโ”€โ”€ noicesettings.lua
          โ””โ”€โ”€ options.lua

Credits โœจ

Kudos to the entire neovim community out there, all the plugin authors & the following repositories that made me know, how to develop this starter configuration.

efficienvim's People

Contributors

debajyati avatar

Stargazers

 avatar  avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.