VimR is a Neovim GUI for macOS written in Swift that brings convenient graphical features to the Neovim editing experience on Apple's platform.
VimR solves the problem of using Neovim without sacrificing macOS-native GUI conveniences. It embeds Neovim as the core editing engine while layering on features like markdown preview, HTML preview with scroll position retention, fuzzy file finding similar to Xcode's Open Quickly, trackpad support for pinching and two-finger scrolling, a file browser, and flexible workspace management. The application is built with a Redux architecture and uses a modular design that separates concerns into reusable Swift packages.
Developers should choose VimR if they want a native macOS Neovim client that goes beyond a terminal wrapper. It suits projects where you want Vim keybindings and Neovim's extensibility combined with GUI niceties like preview panes and visual file navigation. The tool is particularly useful for those already invested in Neovim configuration who prefer a native macOS application over cross-platform alternatives. The project explicitly acknowledges other Neovim GUIs exist for macOS and positions itself as an exploration of Neovim integration and Redux architecture patterns rather than claiming superiority.
The project maintains a modular architecture with independently usable Swift packages including NvimView for embedding Neovim in Cocoa applications, NvimApi for synchronous and asynchronous Neovim communication, and components for tabs, workspace management, and gitignore-style pattern matching. Pre-built universal binaries are provided for macOS 13.0 and later, and the build process is straightforward through Xcode with optional flags for skipping notarization and plugin validation. A community chat room is available for discussion, and the project accepts financial support through GitHub Sponsors.
