search

Sewdohe / NeoCode

My lean, minimal, and sensible Neovim config. VS-who now?
166 stars 5 forks source link
ide neovim rust

readme

logo

Neocode

Sane, simple, and effective config dedicated to replicating the out-of-box experience of vscode in Neovim.

There are many, many good Vim configs out there...many in which are better than this one. BUT I feel that the biggest barrier of entry for users switching from more traditional editors is the configuration. Who wants to spend hours and hours working on a config when VS code just fires up and is ready to go? Well...me...but not everyone is like me! This config is made to be a install-and-code config. Just clone the repo, run the installer, and you're ready to code!

The config was made to be a simple as possible. I think any setting you could need to change would be found right where you expect it to be.

show-off NeoCode with it's new Catppuccin look running in Neovide using the multigrid flag for fancy animations

Installer works for:

Community

This project is actually growing! I'm stoked!! Join the Discord

Dependencies:

The new installer script should manage/download all dependencies automatically now. You no longer need to install deps manually.

Instructions

  1. Clone/Download repo to somewhere on your PC. The config will need to remain where it's placed after installation, so place it somewhere you don't mind it living!
  2. enter the directory where you downloaded the repo using your terminal/console and run the python installer file using python installer.py
  3. watch as the installer does everything for you

FAQ

How to add custom configuration

The setup is now capable of using custom code without it getting overridden when syncing newest changes. The user's custom config folder should be located under the lua folder, called user. Inside the user folder there should be an init.lua file, as well as customplugins.lua, keybinds.lua and settings.lua files. The contents of the file should be as follows:

customplugins.lua:

-- put your custom lua plugins in this lua table to be loaded last by packer
return {
  "rebelot/kanagawa.nvim",
  "windwp/windline.nvim"
}

customplugins is just a list of packer repos that you want to be sourced after the plugin defaults.

init.lua

-- use pcalls in this file to require custom config files,
-- that way if anyone syncs the repo and doesn't have that file they won't get errors

local plugin_okay, plugin = pcall(require, "user.<customFileName>")
if not custom_okay then
  return
end

Inside init.lua, you'll call any custom LUA files that you've written. For example, if you wanted a custom theme, just make a copy of visual.lua, place it in user folder, and require it inside of init.lua. At the end of the plugin loading of the main init.lua, it will call all of your custom configs. These files are not tracked by git and therefor will persist even when you grab the newest updates from the github repo!

Commonly Used Keybinds:

leader key refers to the comma ( , ) key on your keyboard!

VS Code Features:

LSP Commands

Most lsp command (command pertaining to the language server) are prefixed with the space key instead of the leader key for memoralibilitys sake

UI Navigation

VS Code Support

This configuration now supports being ran inside VS Code itself via the "Neovim VS Code Plugin".

When using the configuation inside VS Code it just uses keybinds, legendary, and settings.lua. Still makes for a pretty seamless experience when compared with VS Code native features IMO. More VS Code keybinds to come soon!

Due to limitations of running Neovim inside VS Code, we can't have fuzzy finders and whatnot render, so you'll need to use the VS Code counterparts (such a ctrl+p and strl+shift+p)

TODO: