🐱 Meowvim

The purr-fect Neovim configuration for a cozy coding session. May or may not increase your productivity by a feline factor.

Meowvim - Purr-fect Neovim

---

A carefully curated Neovim configuration that delivers a modern and delightful developer experience. Part of the Project Meow, Meowvim includes elegant defaults, essential plugins, and playful polish.

---

🖼️ Screenshots

Dashboard

Editor

---

🌟 Key Features

• 🚀 Zero Configuration – Sensible defaults out of the box
• 🎨 Modern UI – Clean interface powered by Tokyo Night theme
• 🧠 AI Integration – GitHub Copilot support for smart code suggestions
• ⚡ Fast & Lazy – Optimized with Lazy.nvim for performance
• 🔧 Fully Customizable – Easy to extend with your own tweaks
• 🌐 Language Ready – Preconfigured LSPs for major languages
• 📦 25+ Curated Plugins – For everything from Git to testing
• 🧑‍💻 GitHub Copilot Subscription – Optional AI enhancements

---

🚀 Installation

Option 1: Fresh Installation

If you're starting fresh or want to replace your current Neovim config:

# Backup your existing config (if any)
mv ~/.config/nvim ~/.config/nvim.backup

# Clone Meowvim
git clone https://github.com/retran/meowvim.git ~/.config/nvim

# Start Neovim - plugins will install automatically
nvim

Option 2: As Part of Meow System

If you're using meow dotfiles management system:

# Clone the meow system
git clone https://github.com/retran/meow.git ~/.meow

# Initialize and update submodules (meowvim is connected as submodule)
cd ~/.meow
git submodule init
git submodule update

# Follow the meow installation instructions
./install.sh

⚡ Quick Start

After installation, follow these steps to get started:

1. First Launch

nvim

On first launch, Meowvim will:

• Install the Lazy.nvim plugin manager
• Download and install all plugins
• Configure Language Server Protocol (LSP) servers automatically

Optional: Set Up GitHub Copilot

:Copilot auth

---

🛠 Prerequisites

Required

• Neovim ≥ 0.9.0
• Git
• Terminal with true color support

Recommended

• Node.js ≥ 18
• Python ≥ 3.8
• Go ≥ 1.19
• Ripgrep
• fd
• fzf
• JetBrains Mono Nerd Font

---

⚙️ Configuration

Meowvim is highly customizable. Here's how to make it your own:

File Structure

~/.config/nvim/
├── init.lua              # Main configuration entry point
├── lua/
│   ├── config/
│   │   ├── options.lua   # Neovim options
│   │   ├── keymaps.lua   # Key mappings
│   ├── plugins/          # Plugin configurations
│   └── utils/            # Utility functions
└── assets/               # Icons and resources

Customizing Options

Edit lua/config/options.lua to change Neovim settings:

-- Example: Change tab width
vim.opt.tabstop = 4
vim.opt.shiftwidth = 4

-- Example: Enable line wrapping
vim.opt.wrap = true

Adding Plugins

Create a new file in lua/plugins/ directory:

-- lua/plugins/my-plugin.lua
return {
  "author/plugin-name",
  config = function()
    -- Plugin configuration
  end,
}

Customizing Keymaps

Edit lua/config/keymaps.lua to add your own key mappings:

-- Add your custom keymaps
{ "<leader>mp", ":MyPlugin<CR>", desc = "My Plugin" },

Theme Customization

Switch themes by editing lua/plugins/tokyonight.lua:

-- Change variant
vim.cmd.colorscheme("tokyonight-storm")  -- or "tokyonight-day"

🔧 Troubleshooting

Common Issues

Plugin Installation Fails

# Clear plugin cache and reinstall
rm -rf ~/.local/share/nvim/lazy
nvim --headless "+Lazy sync" +qa

LSP Not Working

1. Check if the language server is installed:

   :LspInfo

2. Language servers are managed by the meow. If you installed Meowvim as part of meow, they should be automatically available.

3. For standalone installation, you may need to install servers manually:

   # TypeScript/JavaScript
   npm install -g typescript typescript-language-server
   
   # Python
   pip install python-lsp-server
   
   # Go
   go install golang.org/x/tools/gopls@latest
   
   # Rust
   rustup component add rust-analyzer

Copilot Not Working

1. Authenticate with GitHub:

   :Copilot auth

2. Check status:

   :Copilot status

Performance Issues

1. Check startup time:

   :StartupTime

2. Disable unused plugins in lua/plugins/

Icons Not Displaying

Install JetBrains Mono Nerd Font.

Getting Help

• Use :help for Neovim documentation
• Check :Lazy for plugin management
• Use <Space>? for Which-key help
• Check the issues page

🤝 Contributing

Contributions are welcome to help improve Meowvim! Here's how you can help:

Ways to Contribute

• 🐛 Report bugs
• 💡 Suggest new features
• 📝 Improve documentation
• 🔧 Submit code improvements
• 🎨 Enhance themes and UI

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgments

Meowvim builds on the excellent work of the Neovim community.

Core Dependencies

• Neovim - The extensible text editor
• Lazy.nvim - Modern plugin manager
• Tokyo Night - Beautiful colorscheme

Plugins

• auto-save.nvim - Automatic file saving
• bufferline.nvim - Buffer line with tabs
• cmp-buffer - Buffer completion source
• cmp-nvim-lsp - LSP completion source
• cmp-path - Path completion source
• cmp_luasnip - LuaSnip completion source
• Comment.nvim - Smart commenting
• conform.nvim - Code formatting
• copilot.lua - GitHub Copilot integration
• copilot-cmp - Copilot completion source
• copilot-lualine - Copilot status in lualine
• FixCursorHold.nvim - Fix CursorHold performance
• friendly-snippets - Snippet collection
• gitsigns.nvim - Git integration
• indent-blankline.nvim - Indentation guides
• leap.nvim - Quick navigation
• lspkind.nvim - LSP kind icons
• lualine.nvim - Status line
• LuaSnip - Snippet engine
• mini.icons - Icon provider
• neodev.nvim - Lua development setup
• neotest - Test runner
• neotest-go - Go test adapter
• noice.nvim - Improved UI
• nui.nvim - UI components library
• nvim-autopairs - Auto-pairing
• nvim-cmp - Completion engine
• nvim-dap - Debug adapter protocol
• nvim-dap-ui - Debug UI
• nvim-lint - Linting
• nvim-lspconfig - LSP configuration
• nvim-nio - Async I/O library
• nvim-notify - Notification system
• nvim-treesitter - Syntax highlighting
• nvim-treesitter-context - Context display
• nvim-treesitter-textobjects - Text objects
• nvim-web-devicons - File icons
• plenary.nvim - Lua utilities
• refactoring.nvim - Refactoring tools
• SchemaStore.nvim - JSON schema store
• snacks.nvim - Collection of utilities
• vim-fugitive - Git commands
• vim-repeat - Repeat plugin commands
• vim-startuptime - Startup profiling
• which-key.nvim - Keybinding help

Inspiration

• LazyVim - Modern Neovim configuration
• Spacemacs - Emacs configuration framework

Author

Meowvim is developed by Andrew Vasilyev with help from GitHub Copilot and feline assistants Sonya Blade, Mila, and Marcus Fenix.

---

Happy coding with project meow! 🐱

Made with ❤️ by Andrew Vasilyev and feline assistants

Report Bug · Request Feature · Contribute

ues) ・ [📬 Suggest Feature](https://github.com/retran/meowvim/issues) ・ [📥 Contribute](https://github.com/retran/meowvim/pulls)