no-neck-pain.nvim
A Neovim plugin that centers your focused buffer with side padding to reduce neck strain during long coding sessions.
What is no-neck-pain.nvim?
no-neck-pain.nvim is a Neovim plugin that centers the currently focused buffer in the middle of the screen by creating evenly sized empty buffers on each side. It solves the problem of neck strain and poor posture during long coding sessions by keeping the active content at a comfortable viewing position.
Neovim users who spend extended periods coding and want to reduce physical strain through better screen ergonomics, particularly developers who value customizable workflow enhancements.
Developers choose this plugin because it offers a dead-simple yet highly customizable zen mode that integrates seamlessly with existing workflows without being opinionated, unlike other alternatives that may impose rigid assumptions.
Overview
☕ Dead simple yet super extensible zen mode plugin to protect your neck.
Use Cases
Best For
- Reducing neck and eye strain during long coding sessions
- Creating a distraction-free centered editing environment in Neovim
- Customizing side buffers as scratch pads for temporary notes
- Integrating zen mode with existing file tree and dashboard plugins
- Maintaining consistent window layouts across multiple tabs
- Adjusting screen ergonomics without disrupting workflow
Not Ideal For
- Developers using small terminal windows or monitors with limited width, as the plugin requires sufficient space to create side buffers and may not activate below the configured width.
- Users who prefer a minimalist Neovim setup without additional buffers, since the plugin adds side buffers that can be perceived as visual clutter.
- Workflows heavily reliant on complex, multi-window layouts where centering the active buffer disrupts simultaneous file viewing or debugging.
- Projects using unsupported file explorers or dashboards not listed in integrations, requiring manual configuration and potentially limited compatibility.
Pros & Cons
Pros
Works immediately with zero configuration, as highlighted in the README, making it easy for users to start reducing neck strain without setup overhead.
Offers extensive options for width, side buffer behavior, and integrations, allowing users to tailor the experience to their workflow, with detailed configuration documented.
Side buffers can function as persistent notepads with automatic saving, adding practical value beyond mere padding, as shown in the showcase.
Supports theming side buffers to match popular colorschemes like catppuccin and tokyonight, ensuring visual consistency without manual tweaks.
Cons
Major version updates (v1.0.0 and v2.0.0) introduced breaking changes, requiring users to update configurations, as noted in the README's breaking changes section.
While plug and play, the numerous options for buffers, integrations, and callbacks can be overwhelming for users seeking simplicity, leading to potential setup friction.
Latest features require Neovim >= 0.9, with older versions only supported in a frozen branch, potentially excluding users on stable but outdated releases.
Frequently Asked Questions
Related Projects
nvim-autopairsautopairs for neovim written in lua
nvim-treesitter-contextShow code context
zen-mode.nvim🧘 Distraction-free coding for Neovim
nvim-ts-autotagUse treesitter to auto close and auto rename html tag
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.