https://github.com/nathom/nvim_config
A nice Neovim configuration
https://github.com/nathom/nvim_config
Last synced: over 1 year ago
JSON representation
A nice Neovim configuration
- Host: GitHub
- URL: https://github.com/nathom/nvim_config
- Owner: nathom
- License: mit
- Created: 2022-01-03T04:29:34.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-21T17:12:57.000Z (about 2 years ago)
- Last Synced: 2025-02-28T11:42:39.922Z (over 1 year ago)
- Language: Lua
- Size: 301 KB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nathan's Neovim Config Files
Welcome! This is a repo where I exclusively keep and maintain my neovim
config. There is a lot of code that is specific to my personal computer here,
so this **won't work as a drop-in starter config**.
## Philosophy
I believe that the fundamentals of Vim should be left alone. This means
that most of the "main" keys should be left as they are out of the box.
All custom mappings should be under `` or `[` namespace. See `lua/mappings.lua`.
There are exceptions to this rule. For example `w` and `b` are redefined
with the plugin `wordmotion.vim`. `` in insert mode has also been
remapped to autocomplete if the line is not empty. What these exceptions
have in common is that they *augment* the previous definitions, not replace
them.
The other main emphasis is **speed**. One of the best things about Vim is
being able to quickly start up, quit, and switch files. This *must be preserved*.
In fact, the reason I switched to neovim from Vim was Lua integration,
which allows for plugins that don't significantly bog down the experience.
There are 4 "secrets" to maintaining a snappy Neovim:
1. Profile: Use `tweekmonster/startuptime.vim`
2. Lazy loading: Use the `lazy.nvim` plugin manager. Try to lazy load every
plugin.
3. Compile Lua code: See `lewis6991/impatient.nvim`. This essentially
overrides calls to `require` in Lua code to pre-compile, cache, and
load plugins. To maximize the benefit, keep `init.lua` tiny. Put the
rest into files that are `required` in `init.lua`.
4. Find faster alternatives to existing plugins. For example, prefer the
`gruvbox8` theme over the original `gruvbox`. Also, (plug incoming!)
use `nathom/filetype.nvim`, which speeds up a crusty runtime file
called `filetype.vim`.
After diligently following these steps, you should be able to maintain
a config that *snappy*. The one in this repo starts up in ~8ms despite
having 44 plugins!