Foxnvim
My personal neovim configuration for fox coders with IDE features included for FullStack development in many languages.
Native support for Kitty terminal, arch-linux (omarchy & ryoku)
arch-omarchy-automatic-theme.mp4
This is intended for my own usage, but wanted to share as a public repo in case someone founds this config useful. You can fork-it, clone it, break it, do as you please. Expect to found highly opinionated keybinds, custom plugins and more. For fox coders! 🦊
This is for fullstack coding and AI friendly. From react/typescript/next.js to backends in PHP/Laravel, C# ASP.NET or Golang proyects.
- Project environments with isolated buffers, layouts, LSPs, and terminal pools.
- Nine persistent integrated terminals, task output slots, dev-server control, and launch profiles.
- LSP, formatting, completion, Tree-sitter, DAP, language bundles, and a minimal fresh-install toolchain.
- File and project navigation, Git Center, conflict resolution, secondary Git accounts, and diff tools.
- Command Palette, dashboard, interactive wiki, offline documentation, snippets, templates, and VS Code settings support.
- Persistent breakpoints, workspace sessions, TODO sidebar, Tailwind organization, type injection, image previews, and Omarchy palette sync.
Open the Command Palette with <C-S-p> or :CommandPalette to discover actions. The documentation index links to the full feature guides.
language-bundles-installer.mp4
powershell-friendly.mp4
🦊 Neovim Version: Currently running on NVIM v0.12.4 (requires Neovim >= 0.10).
| Environment | FoxVim support |
|---|---|
| Windows | Native PowerShell or Git Bash setup, Windows paths, and Windows Terminal keybinding setup. |
| WSL | Discovers installed distros; browses \\wsl.localhost / \\wsl$ projects; opens integrated terminals in the matching distro and directory. |
| Ubuntu / Debian Linux | apt setup path, native Linux tooling, and ordinary terminal workflow. |
| Arch Linux | pacman setup path. |
| Arch + Omarchy | Detects Omarchy and can synchronize the active Omarchy color palette with FoxVim using :FoxOmarchySyncToggle. |
| Termux → Ubuntu PRoot | Detects the layered Android environment, applies mobile performance settings, and retains terminal-safe key aliases. Native Termux is supported too. |
| macOS, Fedora, Alpine | brew, dnf, and apk setup paths are included. |
The shell-keybinding setup supports Windows Terminal, Kitty, Foot, WezTerm, Alacritty, Ghostty, and Termux. Inside Neovim, each environment has nine independent terminals; a WSL filesystem path automatically selects a WSL shell. See installation, terminals, and environments.
FoxVim has 71 local plugin specs across lua/plugins/ and 21 external plugins, including lazy.nvim, pinned in lazy-lock.json. Local modules are part of this repository; lazy.nvim installs and manages the external packages on first launch.
| Area | Modules |
|---|---|
| Developer workflow | Bun DAP, DAP Breakpoints, Dev Server, FoxNvim Completion, Launch Completion, Launch Profiles, Tasks, Terminal |
| Editing | Package Info, Auto Pairs, Buffer Cleaner, Caps Lock, Folding, Hover Links, Line Endings, Neo-tree Hidden Files, Neo-tree Mover, Smart Check, Tailwind Organizer |
| Git | Conflict Resolver, Diff Mode, Git Accounts, Git Center, Secondary Git |
| Tools | Command Palette, .NET Creator, Environments, File Explorer, Installer, LSP References, Notes, NuGet Manager, TODO Sidebar, Type Injector, Lua Type Injector, TypeScript Type Injector, Usages Picker, Workspaces, WSL Bridge |
| UI | Colorscheme Preview, Font, Help Modal, Input Modal, Omarchy Theme Sync, Pinned Tabs, Statusline Picker, Theme Picker, Wiki Modal |
| Area | Packages pinned in lazy-lock.json |
|---|---|
| UI and themes | native FOX tabline, statusline and notifications, render-markdown.nvim |
| Navigation and Git | diffview.nvim, gitsigns.nvim, neo-tree.nvim, neogit, nui.nvim, plenary.nvim, snacks.nvim, telescope-file-browser.nvim, telescope.nvim |
| LSP and editing | blink.cmp, conform.nvim, local snippet catalog, mason.nvim, nvim-lspconfig, nvim-treesitter, schemastore.nvim |
| Debugging | baleia.nvim, nvim-dap, nvim-dap-ui, nvim-nio |
| Language and extras | cord.nvim, lazy.nvim |
See PLUGIN-LIST.md for external dependencies and local fox-<name> implementations. For loading modes and dependency relationships, see the detailed inventory.
The start screen. One letter per entry:
| Key | Opens |
|---|---|
f |
File Explorer (Desktop) |
p |
Recent projects |
l |
File Explorer (WSL) — Windows only, shown when WSL is installed |
w |
Wiki / documentation (:NvimWiki) |
e |
Plugins & extensions (:Lazy) |
m |
LSPs & languages (:Mason) |
q |
Quit |
Return to the dashboard from anywhere with <leader>wm; closing the last open buffer also lands here.
After cloning into %LOCALAPPDATA%\nvim (Windows) or ~/.config/nvim (Linux, WSL, Termux, or macOS):
- Windows (PowerShell):
powershell -ExecutionPolicy Bypass -File .\scripts\dependencies\install.ps1 - Linux / WSL / Termux / Git Bash:
./config/scripts/dependencies/install.sh
Everything else — install, keybinds, debugging, launch profiles, custom modules — lives in the wiki:
- Documentation Center Modal: Press
<C-S-d>(or run:FoxWiki/:NvimWiki) from anywhere to open the interactive Wiki Reader. - ➡️ docs/index.md (Full Wiki Index)
- ➡️ docs/how-to-customize-editor.md (Complete How-To & Customization Guide with Examples)
Start here if you are reading the code:
| Page | What it answers |
|---|---|
| 🎓 How-To & Customization Guide | Step-by-step guide for adding plugins, local modules, languages, themes, and terminals |
| 🏛️ Architecture | The layers, what may depend on what, startup order, where new code goes |
| 🧩 Module Architecture | How a file in lua/plugins/fox/ is both a module and a lazy.nvim spec |
| 🔌 Creating Local Plugins | Building custom features in lua/plugins/fox/ using the dual spec-module metatable |
| 🧪 Testing | Running the suite and writing a spec |
nvim -l config/tests/syntax_check.lua # every Lua file still parses
nvim -l config/tests/run.lua # unit specs (fast, no plugins)
nvim --headless -S config/tests/integration/run.lua # with the real editor loadedSupport assets, scripts, tests, and bundled tools live under config/. Plans and notes are in
config/plans_notes_md/; see the directory map for the full layout.
Inside the editor: :FoxTest (optionally :FoxTest git to filter by spec name).
You can run project scripts (test suite, syntax checks, setup dependencies, etc.) using the master Lua CLI:
# Launch interactive CLI menu
nvim --headless -l run_me.lua
# Run options directly via flags
nvim --headless -l run_me.lua -- --syntax
nvim --headless -l run_me.lua -- --tests
nvim --headless -l run_me.lua -- --setup
nvim --headless -l run_me.lua -- --help