oh-my-nvim

A theme-driven, out-of-the-box modern configuration of neovim 💎

We developed a theme called HardHacker, which we thought was pretty and eye friendly, but we found that many neovim plugins have their own color scheme, so we made a neovim integration environment that matches the hardhacker theme.

📦 Features

• Session load and switch
• File explorer
• File find and search
• Float terminal
• LSP
• Pretty code highlighting, Colors highlighting
• Auto completion
• Languages
• Git integration
• Git diff view
• Pretty Tab line, Status line
• Markdown Preview via your browser
• Starting screen
• Quick resize the window
• Customization of frequently used shortcuts
• ...

🎆 Preview

📸 Load and switch project

The preview shows opening a project and then switching to another project. Here the project is loaded and switched via nvim's session. Thus, a project is a session.

When nvim is started in a directory, it is created as a session based on that directory, so we can always start nvim in the root directory of a project.

We can use the F6 shortcut (by default) to select and switch a project(session).

📌 Requirements

• Neovim 0.8+
• Not required, but recommended
  • nerd font
    • Victor Mono Nerd Font
    • JetBrainsMono Nerd Font
    • ...
  • ripgrep
  • fd

🚧 Install

MacOS/Linux

0️⃣ Backup your current nvim

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

1️⃣ Clone oh-my-nvim repo

git clone https://github.com/hardhackerlabs/oh-my-nvim.git ~/.config/nvim

2️⃣ Start nvim in your terminal, then automatically install and setup all plugins

3️⃣ Restart nvim and enjoy it 🍻

🧱 Languages

Install LSP Server

Use command :LspInstall to download and install a server, e.g. :LspInstall rust_analyzer.

Install TreeSitter Parser

Use command :TSInstall to download and install a parser, e.g. :TSInstall rust.

🏠 Custom

Configuration structure

~/.config/nvim/ 
├── init.lua
├── lazy-lock.json
└── lua
    ├── basic.lua
    ├── custom.lua
    ├── custom_keys.lua
    ├── custom_opts.lua
    ├── plugins
    │   ├── my_plugins.lua
    │   └── ...
    └── settings.lua

• ~/.config/nvim/lua/plugins/my_plugins.lua

  This file does not exist by default, you can create this file and configure the plugins you want.

• ~/.config/nvim/lua/custom.lua

  This file does not exist by default, you can create this file, then place some custom configuration logic, the custom.lua module will be loaded last.

Shortcut Keys ⌨️

👉 View the default shortcut settings

You can edit the default settings of the shortcut keys in this configuration file (~/.config/nvim/lua/custom_keys.lua).

Add the plugins you want

If you want to add your own plugins, you can create a my_plugins.lua file in the directory ~/.config/nvim/lua/plugins. Setup the plugins in this file.

The plugin configuration in the my_plugins.lua file refers to the following template (lazy.nvim syntax):

return {
    -- Your Plugin1
    {
        'hardhacker/plugin1',
        config = function() ... end
    },

    -- Your Plugin2
    {'hardhacker/plugin2'},
}

🧩 Plugins

• lazy.nvim (Plugin manager)
• hardhacker-theme
• nvim-notify
• nvim-web-devicons
• dashboard-nvim
• toggleterm.nvim
• gitsigns.nvim
• diffview.nvim
• lualine.nvim
• nvim-lspconfig
• nvim-cmp
• cmp-nvim-lsp
• cmp-buffer
• cmp-path
• cmp-cmdline
• lspkind.nvim
• nvim-treesitter
• bufferline.nvim
• telescope.nvim
• neo-tree.lua
• markdown-preview.nvim
• nvim-colorizer.lua
• smart-splits.nvim
• bufdelete
• aerial
• neovim-session-manager
• null-ls

💖 Recommendations for Neovim GUI

• Neovide (Developed by rust)