Pakrohk-DotFiles/NvPak

github github
pluginpreconfigured-configuration
stars 104
issues 3
subscribers 4
forks 9
CREATED

UPDATED


APACHEv3 license Maintenance Neovim Minimum Version Maintainer GitHub Issues

What is the purpose of the NvPak project? ✨

Maybe you have tried to configure Neovim multiple times over the past few years. Neovim has undergone many changes, and every time, you had to follow new defaults to reach the minimum configuration and start writing your configuration for Neovim. The goal of the nvpak project is to provide these defaults.

Now you can configure only what you need by forking nvpak without any add-ons. Please note that nvpak is not a Neovim configuration and not in competition with other configurations such as NvChad or LazyVim. If you need a complete Neovim setup without any configuration, then this GitHub repository is not for you.

Why is the name of the project NvPak? 🌟

"nv" stands for Neovim and "Pak" is derived from the Persian word "ٞاڊ" meaning "clean," which represents brightness and simplicity, contrary to complexity and disorder.

Update 2026 (Zen Modernization): The project has been fully modernized for 2026, embracing a deeper "Zen" approach with high-performance tools like blink.cmp and snacks.nvim while adding first-class support for Persian (RTL).

Requirements 📋

To ensure the installation scripts and NvPak work correctly, please have the following:

  • Operating System:
    • Linux (most distributions)
    • macOS
    • Windows 10/11 (with PowerShell 5.1+)
    • Android (via Termux)
  • Core Tools:
    • git
    • curl
    • unzip
    • neovim v0.10.0 or later (for native Treesitter folding and modern plugin compatibility)
  • Shell:
    • bash or dash for Unix-like systems.
    • PowerShell v5.1 or later for Windows.
  • Recommended Tools:
    • ripgrep & fd (for high-speed search)
    • Clipboard tools: xclip/wl-clipboard (Linux), pbcopy (macOS), win32yank (Windows)
  • Nerd Fonts & Persian Support:
    • For the best experience, we recommend Vazirmatn RD Nerd Font or any font that supports both Persian glyphs and Nerd Font icons.

Screenshots 📷

full autocompelet NeoVide

Modern 2026 Stack 🚀

NvPak has been rebuilt with performance and simplicity in mind:

  • blink.cmp: A lightning-fast completion engine.
  • snacks.nvim: A consolidated solution for dashboard, notifications, indentation, and more, replacing multiple heavy plugins.
  • Native Folding: Leverages Neovim 0.10+ native Treesitter folding for a smoother editing experience.
  • Persian RTL: Built-in RTL support. Use <leader>rtl to toggle Right-to-Left mode. Optimized for Konsole/Plasma environments.

Installation 💻

Linux / macOS / Android (Termux)

curl -sS https://raw.githubusercontent.com/Pakrohk-DotFiles/NvPak/main/install.sh | bash

Windows (Native PowerShell)

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Pakrohk-DotFiles/NvPak/main/install.ps1" -OutFile "install.ps1"; .\install.ps1

Usage 🚀

  • Plugin Management: Powered by rocks.nvim.
    • :Rocks sync - Synchronize plugins with rocks.toml.
    • :Rocks install <plugin> - Install a new plugin.
  • Snacks Features:
    • <leader>un - Notification History.
    • <leader>bd - Delete current buffer.
    • <leader>gg - Lazygit.
  • RTL Toggle:
    • <leader>rtl - Toggle Persian/Arabic RTL mode.
  • Smart Update:
    • :NvPakUpdate - Update NvPak with conflict detection and automated plugin sync.

Contributing 🤝

We welcome contributions! Fork the repository, make your changes, and submit a pull request. Please ensure your commit messages are in English and follow the "Pak" philosophy.


Maintainer: Pakrohk