Skip to content

Highly opinionated yet flexible base configuration for neovim.

License

Notifications You must be signed in to change notification settings

commitsovercoffee/minima-nvim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MinimaNvim

This repo contains my neovim config as a single init.lua file.

Features :

  • file explorer with oil ~ open/edit files and folders.
  • fuzzy finder with telescope ~ search for text, files, diagnostics and a lot more.
  • terminal support with toggleterm ~ open terminal within neovim.
  • session manager with auto-session ~ blink back to what you were working on.
  • statusline with lualine ~ to display relevant info.
  • syntax highlighting with tree-sitter ~ installed automatically for opened file.
  • git support with vim-fugitive and gitsigns ~ run git commands from within neovim, and display git signs.
  • colorscheme with catppuccin ~ to make it beautiful.
  • mason ~ install any lsp, formatter, linter or dap. ( how to setup )
  • lsp with nvim-lspconfig and null-ls
  • auto-completion with nvim-cmp and luasnip

Along with sane defaults and keymappings.

What is it ?

  • MinimaNvim is a minimalist neovim configuration designed to offer a solid foundation for users looking to enhance their neovim experience. Built using Lua, it focuses on providing a highly opinionated yet flexible base configuration.
  • This single file configuration is meticulously documented with clear and concise comments, offering users a comprehensive overview of each block of code. With this approach, understanding the purpose and functionality of different code sections becomes effortless.
  • Easily experiment and evolve the configuration according to your preferences. Whether you are a seasoned neovim user or just getting started, MinimaNvim provides a lightweight and customizable solution to streamline your editing workflow.

What is neovim ? Any why bother configurig it ?

It is an editor just like notepad or gedit. What's special about neovim is that it is a modal text editor that is designed to be fast and efficient. And you can extend its functionality using plugins, and hence it makes up for a great programming editor since you can add the functionalities that "you" want, and ultimately create your PDE ( personalized development environment ).

How to use it ?

  • Install neovim.
  • Backup current nvim and shared folder.
    mv ~/.config/nvim ~/.config/nvim.bak
    mv ~/.local/share/nvim ~/.local/share/nvim.bak
  • Clone this repo
    git clone --depth 1 https://github.com/commitsovercoffee/minima-nvim ~/.config/nvim
  • Open neovim. ( it may show black screen for a second or two )
  • All packages will be automatically installed.

Mason package not working ?

After installing packages using ":mason" you will need to add that package in the config.

  • To setup lsp follow these steps.
  • To setup linter, formatter etc follow these steps.

Status

This project is my daily driver. I contribute to this project if and when I come across something useful or to add bugfixes.

About

Highly opinionated yet flexible base configuration for neovim.

Topics

Resources

License

Stars

Watchers

Forks

Languages