This configuration is no longer updated. Using this repository for it's Neovim configuration is not recommended.

If you don't care about bs and want straight to the bussiness then click here.

• Introduction
• Prerequisites
• Zsh
  • Plugins
  • Aliases
• Tmux
  • Steps
  • Installation
  • Configuration
  • Commands
  • Keybinding
• Neovim
  • Steps
  • Installation
  • Plugins
  • Keybinding
  • Recommended read
• Gallery
• Troubleshooting

This configuration is aimed at development in Neovim on MacOS. That being said, the purpose of this repository is to help you get started. You are encouraged to change it to your liking, and I designed it with that in mind.

Note: The _ in the file/directory names represents .

• Brew
• iTerm2
• z-shell
• oh My ZSH!
• Powerlevel10k
• NerdFonts
• Colorls

Follow this quick tutorial to get everything you need for the full experience.

Alternatively, go through the plugins one by one and follow their installation guides.

Note1: I strongly recommend that you install everything using Brew as it will make maintaining everything way easier.

Note2: Brew is MacOS specific.

If you followed prerequisites section you should have most of the stuff done already. Now we just take it one step further. For a powerful zsh setup, read this article and then check my .zshrc file.

You can find plugins I use in the .zshrc file in

plugins =( ... )

The aliases.zsh file, located in the .config directory, contains my personal configuration. Plugins add a whole lot more, and I definitely recommend checking each plugin out.

Note: Don't forget to add this into your .zshrc.

source ~/.config/aliases.zsh

Tip: I recommend setting up aliases for quick navigation to your work directory.

1. Install tmux.
2. Clone this repository (if you haven't done so already)

gc https://github.com/Roiqk7/dotfiles

or if you don't use my aliases then by running:

git https://github.com/Roiqk7/dotfiles

3. Rename the _tmux.conf to .tmux.conf and put it in your root directory (~/).
4. Open a terminal and run the code bellow to reload the configuration file.

tmux source ~/.tmux.conf

Follow the tmux installation guide to install it properly.

• If you want your temperature in fahrenheit then in .tmux.conf file change

set -g @dracula-show-fahrenheit

to false.

• To further customize your tmux read the official Dracula theme plugin documentation for more information.

You may also like tmex. You will need to install npm by running bi npm and when that's done run ni tmex. Tmex will let you esily start multi-pane sessions using tmux. I recommend reading the docs for more info.

For these commands to work, you need to have my zsh configuration and have this tmux plugin and my aliases.zsh file setup properly.

<prefix> represents <control>a (must be pressed at the same time).

📂  ~/.config/nvim/
   └────  📂  lua/
   │  └────  📂  editor/
   │  └────  📂  mapping/
   │  └────  📂  plugrc/
   │  │  └────  📂  lsp/
   │  └────  📂  ui/
   │  ├────  📄  plugins.lua
   │  └────  📄  utils.lua
   └────  📄  init.lua

editor contains the neovim editor configuration.

mapping contains all key bindings.

plugrc contains individual plugin setups.

ui contains settings for neovim appearance.

plugins contains Packer with a list of all plugins.

utils.lua contains handy, reusable functions.

1. Run this to install neovim.

bi neovim

or if you don't use my aliases then by running:

brew install neovim

2. Install plugin manager Packer on MacOS or Linux using this:

gc https://github.com/wbthomason/packer.nvim\
 ~/.local/share/nvim/site/pack/packer/start/packer.nvim

3. Clone this repository (if you haven't done so already)

gc https://github.com/Roiqk7/dotfiles

or if you don't use my aliases then by running:

git https://github.com/Roiqk7/dotfiles

4. Go to downloads/_config and then move the nvim to your ~/.config directory.
5. Open your terminal and run:

n

or if you do not use my aliases then do:

nvim

6. Now you will see lot of errors. Simply click though them and then type :PackerSync. This will update your neovim. Then type :q to leave and reopen neovim. May be neccesary to again type :PackerSync and also wait for other plugins to install what they need so do not close neovim right away.

See this for information on how to install and setup nvim for MacOS and other platforms.

Here is a complete list of all plugins. Special thanks to all of the authors and maintainers. The order is the same as in the plugins.lua file.

With over 60 plugins, the average load time is under 9 milliseconds (measured on a MacBook M2).

<leader> represents space key.

Here are some resources you can use to master this configuration. Note that all the plugins mentioned are already installed and configured.

If you get this error message after running

:PackerSync

then go into a terminal and enter this piece of code:

ulimit -n 10240

Note that this is not a permanent solution. It will increase the maximum number of files just for the current session.