{"id":27211823,"url":"https://github.com/thewizardshell/neovim-setup","last_synced_at":"2025-04-10T01:50:49.711Z","repository":{"id":243557347,"uuid":"812730591","full_name":"thewizardshell/neovim-setup","owner":"thewizardshell","description":"This repository contains my personal configuration files for Neovim Setup . It includes custom settings and plugins to enhance the development experience.","archived":false,"fork":false,"pushed_at":"2025-02-03T16:41:55.000Z","size":111,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T03:34:27.676Z","etag":null,"topics":["lazyvim","lua","neovim","neovim-dotfiles","nvim","nvim-configs","setup-development-environment"],"latest_commit_sha":null,"homepage":"https://dotfyle.com/vicenteroa/neovim-setup","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thewizardshell.png","metadata":{"files":{"readme":"README-EN.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-09T18:05:15.000Z","updated_at":"2025-02-03T16:41:59.000Z","dependencies_parsed_at":"2024-08-05T23:09:40.576Z","dependency_job_id":"69188051-81d9-4ce9-afdd-778d01457d9a","html_url":"https://github.com/thewizardshell/neovim-setup","commit_stats":null,"previous_names":["vicenteroa/neovim-setup","thewizardshell/neovim-setup"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewizardshell%2Fneovim-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewizardshell%2Fneovim-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewizardshell%2Fneovim-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewizardshell%2Fneovim-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thewizardshell","download_url":"https://codeload.github.com/thewizardshell/neovim-setup/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248142854,"owners_count":21054667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["lazyvim","lua","neovim","neovim-dotfiles","nvim","nvim-configs","setup-development-environment"],"created_at":"2025-04-10T01:50:49.069Z","updated_at":"2025-04-10T01:50:49.682Z","avatar_url":"https://github.com/thewizardshell.png","language":"Lua","readme":"![504_1x_shots_so](https://github.com/user-attachments/assets/9b653d55-7855-4700-82b9-e26789cab8d1)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://dotfyle.com/vicenteroa/neovim-setup\"\u003e\n    \u003cimg src=\"https://dotfyle.com/vicenteroa/neovim-setup/badges/plugins?style=flat\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://dotfyle.com/vicenteroa/neovim-setup\"\u003e\n    \u003cimg src=\"https://dotfyle.com/vicenteroa/neovim-setup/badges/plugin-manager?style=flat\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/vicenteroa/Dotfiles\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Dotfiles-Vicente%20Roa-blue?style=flat-square\u0026logo=neovim\u0026logoColor=blue\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Install Instructions\n\n\u003e Install requires Neovim 0.9+. Always review the code before installing a configuration.\n\nClone the repository and install the plugins:\n\n```sh\ngit clone git@github.com:vicenteroa/neovim-setup ~/.config/vicenteroa/neovim-setup\n```\n\nOpen Neovim with this config:\n\n```sh\nNVIM_APPNAME=vicenteroa/neovim-setup/ nvim\n```\n\n## Plugins\n\n### ai\n\n- [CopilotC-Nvim/CopilotChat.nvim](https://dotfyle.com/plugins/CopilotC-Nvim/CopilotChat.nvim)\n- [supermaven-inc/supermaven-nvim](https://dotfyle.com/plugins/supermaven-inc/supermaven-nvim)\n\n### colorscheme\n\n- [olimorris/onedarkpro.nvim](https://dotfyle.com/plugins/olimorris/onedarkpro.nvim)\n- [rose-pine/neovim](https://dotfyle.com/plugins/rose-pine/neovim)\n- [rebelot/kanagawa.nvim](https://dotfyle.com/plugins/rebelot/kanagawa.nvim)\n\n### completion\n\n- [hrsh7th/nvim-cmp](https://dotfyle.com/plugins/hrsh7th/nvim-cmp)\n\n### diagnostics\n\n- [folke/trouble.nvim](https://dotfyle.com/plugins/folke/trouble.nvim)\n\n### editing-support\n\n- [folke/snacks.nvim](https://dotfyle.com/plugins/folke/snacks.nvim)\n\n### file-explorer\n\n- [stevearc/oil.nvim](https://dotfyle.com/plugins/stevearc/oil.nvim)\n\n### fuzzy-finder\n\n- [nvim-telescope/telescope.nvim](https://dotfyle.com/plugins/nvim-telescope/telescope.nvim)\n\n### icon\n\n- [nvim-tree/nvim-web-devicons](https://dotfyle.com/plugins/nvim-tree/nvim-web-devicons)\n\n### keybinding\n\n- [folke/which-key.nvim](https://dotfyle.com/plugins/folke/which-key.nvim)\n\n### lsp\n\n- [neovim/nvim-lspconfig](https://dotfyle.com/plugins/neovim/nvim-lspconfig)\n- [jose-elias-alvarez/typescript.nvim](https://dotfyle.com/plugins/jose-elias-alvarez/typescript.nvim)\n\n### lsp-installer\n\n- [williamboman/mason.nvim](https://dotfyle.com/plugins/williamboman/mason.nvim)\n\n### lua-colorscheme\n\n- [ellisonleao/gruvbox.nvim](https://dotfyle.com/plugins/ellisonleao/gruvbox.nvim)\n\n### markdown-and-latex\n\n- [iamcco/markdown-preview.nvim](https://dotfyle.com/plugins/iamcco/markdown-preview.nvim)\n\n### note-taking\n\n- [epwalsh/obsidian.nvim](https://dotfyle.com/plugins/epwalsh/obsidian.nvim)\n\n### nvim-dev\n\n- [nvim-lua/plenary.nvim](https://dotfyle.com/plugins/nvim-lua/plenary.nvim)\n\n### plugin-manager\n\n- [folke/lazy.nvim](https://dotfyle.com/plugins/folke/lazy.nvim)\n\n### preconfigured\n\n- [LazyVim/LazyVim](https://dotfyle.com/plugins/LazyVim/LazyVim)\n\n### search\n\n- [chrisgrieser/nvim-rip-substitute](https://dotfyle.com/plugins/chrisgrieser/nvim-rip-substitute)\n\n### statusline\n\n- [nvim-lualine/lualine.nvim](https://dotfyle.com/plugins/nvim-lualine/lualine.nvim)\n\n### syntax\n\n- [nvim-treesitter/nvim-treesitter](https://dotfyle.com/plugins/nvim-treesitter/nvim-treesitter)\n\n### test\n\n- [nvim-neotest/neotest](https://dotfyle.com/plugins/nvim-neotest/neotest)\n\n## Language Servers\n\n- eslint\n- html\n- lua_ls\n- tsserver\n\n---\n\n## Required Dependencies\n\nMake sure to install these tools using `sudo apt`, `brew`, or any tool you're using that allows you to install the following:\n\n- **fzf**: `sudo apt install fzf` or `brew install fzf`\n- **fd-find**: `sudo apt install fd-find` or `brew install fd`\n- **ripgrep**: `sudo apt install ripgrep` or `brew install ripgrep`\n- **bat**: `sudo apt install bat` or `brew install bat`\n- **git**: `sudo apt install git` or `brew install git`\n- **gcc**: `sudo apt install gcc` or `brew install gcc`\n- **curl**: `sudo apt install curl` or `brew install curl`\n- **lazygit**: `sudo apt install lazygit` or `brew install lazygit`\n\n## Considerations\n\n\u003e **⚙️ Note:** This setup includes an integration with Obsidian via the `obsidian.lua` file. For it to work properly, you need to install Obsidian on your operating system and change the note path in the plugin to where your Obsidian notes are stored, as it is currently set to the location of my personal notes.\n\n## Installation Steps\n\n### 1. Enable WSL and Set Up Ubuntu\n\n1.1 Open PowerShell as Administrator and run the following command to install WSL:\n\n```powershell\nwsl --install\n```\n\n1.2 Restart your computer if needed.\n\n1.3 Open the Microsoft Store and install the Ubuntu distribution.\n\n1.4 Open Ubuntu from the Start menu to finish setting it up. Follow the instructions to create your WSL username and password.\n\n### 2. Install Neovim on Ubuntu (WSL)\n\n2.1 Once in the Ubuntu terminal, update the packages:\n\n```bash\nsudo apt update \u0026\u0026 sudo apt upgrade\n```\n\n2.2 Install Neovim with the following command:\n\n```bash\nsudo apt install neovim\n```\n\n### 3. Clone the Neovim Configuration\n\n3.1 Clone your Neovim configuration into the configuration directory:\n\n```bash\ngit clone https://github.com/vicenteroa/neovim-setup ~/.config/nvim\n```\n\n3.2 This will copy all the necessary configuration directly into the Neovim directory.\n\n### 4. Install Additional Dependencies (Optional)\n\nYou may need additional dependencies for certain Neovim features, like support for specific languages or plugins.\n\n4.1 For Python support, run:\n\n```bash\nsudo apt install python3-pip\npip3 install pynvim\n```\n\n4.2 For Node.js support (required by some Neovim plugins):\n\n```bash\ncurl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -\nsudo apt install -y nodejs\n```\n\n### 5. Test the Installation\n\n5.1 Open Neovim from a terminal like **WezTerm** or **Alacritty** (installed on Windows, not WSL) for a better experience:\n\n```bash\nnvim\n```\n\n5.2 If you encounter any issues, check the error messages and verify the configuration in the `init.lua` or `lazy.lua` file.\n\n\u003e **⚠️ Important:** This Neovim setup should work on operating systems such as Windows (WSL), macOS, and Linux distributions (e.g., Arch). However, note the following:\n\u003e\n\u003e - **System Dependencies:** Some plugins or configurations may require specific tools that are only available on certain systems. Be sure to adapt the installation commands according to your system's package manager (e.g., `brew` on macOS or `pacman` on Arch).\n\u003e - **Configuration Path:** The configuration must be located in `~/.config/nvim` to be recognized by Neovim on any operating system.\n\n---\n\n### Recommended Wallpaper\n\n🎨 **Customization Tip:** To complement the style of your Neovim setup, you can use the animated wallpaper I have on my desktop via **Wallpaper Engine**. This helps to give your development environment an attractive visual touch.\n\n#### Instructions to Apply the Wallpaper\n\n1. Make sure you have **Wallpaper Engine** installed on your PC (available on Steam).\n2. You can find the wallpaper I use [at this Steam Workshop link](https://steamcommunity.com/sharedfiles/filedetails/?id=3309706653).\n   ![image](https://github.com/user-attachments/assets/83713c7c-c621-4093-82ff-202e58a49c1b)\n\n3. Once in Wallpaper Engine:\n   - Open the link and click \"Subscribe\" to add the wallpaper to your collection.\n   - Open Wallpaper Engine and select the wallpaper from your library to apply it.\n\n\u003e **Note:** This wallpaper is just a recommendation to complement the Neovim setup on WSL and is not a requirement for its functionality.\n\n---\n\n### Terminal Multiplexer: Zellij\n\n\u003e **💡 Productivity Tip:** If you want a more complete experience in your workflow, consider installing the **Zellij** terminal multiplexer. It allows you to work in multiple panes within a single window, which makes it easier to organize tasks simultaneously.\n\n#### Installing Zellij\n\n1. **On Ubuntu (WSL):**\n\n   ```bash\n   sudo apt install zellij\n   ```\n\n2. **On Arch Linux:**\n\n   ```bash\n   sudo pacman -S zellij\n   ```\n\n3. **On macOS (using Homebrew):**\n\n   ```bash\n   brew install zellij\n   ```\n\n#### Suggested Workflow\n\nHere’s the workflow I usually use with Zellij:\n\n- **Left Panel:** Main development window.\n- **Upper Right Panel:** Area for testing.\n- **Lower Right Panel:** Space for taking notes in Obsidian.\n- **Floating Panel:** Space for running in development or production mode.\n\n### Example (with floating panel)\n\n![image](https://github.com/user-attachments/assets/249df7a1-11bf-4b01-aa9f-3fabd087a761)\n\n### Example\n\n![image](https://github.com/user-attachments/assets/c7bdd09c-275f-4b57-92b6-534e742e9420)\n\n\u003e This organization allows me to work in an organized way and have easy access to multiple tools and tasks at the same time.\n\nFor more details on how I configure my tools, you can check out my [Dotfiles here](https://github.com/vicenteroa/Dotfiles).\n\n---\n\nEnjoy your new development environment and the power of Neovim on WSL Ubuntu! 🏯\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthewizardshell%2Fneovim-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthewizardshell%2Fneovim-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthewizardshell%2Fneovim-setup/lists"}