tiny-nvim

KO | EN

gitlite — search

#javascript #react #ai #typescript #golang #machine-learning #deep-learning #docker #macos #nodejs #windows #cli #vue #pytorch

(★ 52)

Slim Neovim config for 0.11+ with minimal plugins.

tiny-nvim Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Welcome to My Tiny Neovim 👋

[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](https://raw.githubusercontent.com/jellydn/tiny-nvim/main/)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/jellydn/tiny-nvim/main/)
[![Twitter: jellydn](https://img.shields.io/twitter/follow/jellydn.svg?style=social)](https://twitter.com/jellydn)
<a href="https://dotfyle.com/jellydn/tiny-nvim"><img src="https://dotfyle.com/jellydn/tiny-nvim/badges/plugins?style=flat" /></a>
<a href="https://dotfyle.com/jellydn/tiny-nvim"><img src="https://dotfyle.com/jellydn/tiny-nvim/badges/leaderkey?style=flat" /></a>
<a href="https://dotfyle.com/jellydn/tiny-nvim"><img src="https://dotfyle.com/jellydn/tiny-nvim/badges/plugin-manager?style=flat" /></a>

> Slim Neovim config for **0.13+** with minimal plugins.

[![Slim Neovim config for 0.13](https://i.gyazo.com/6e351d72c2f119f70dbc55d61e9452fd.png)](https://gyazo.com/6e351d72c2f119f70dbc55d61e9452fd)

## Requirements

- **Neovim 0.13+** (runtime target; built-in LSP configs use the 0.11+ `lsp/` format)
- External tools from [`./scripts/install-tools.sh`](./scripts/install-tools.sh) (includes `tree-sitter` CLI for parser compile)
- `~/.local/bin` on `PATH` is prepended at startup so tools from `uv` / mise (e.g. `ty`, `ruff`) resolve correctly

## Motivation

This configuration is a migration from [my-nvim-ide](https://github.com/jellydn/my-nvim-ide) with two main goals:

1. **Leverage Neovim Built-in Features (0.11 API, 0.13 runtime)**:
   - Remove dependency on [`lspconfig`](https://github.com/neovim/nvim-lspconfig/pull/3659) by utilizing Neovim's built-in LSP support
   - No need for the `mason.nvim` plugin; instead, use a shell [script](./scripts/install-tools.sh) to install necessary tools
   - Experience faster startup times and reduced complexity
   - Target Neovim **0.13+** behavior (e.g. disable built-in `nvim.dir` so oil / VS Code explorer own `-`)

2. **Optimize Plugin Selection**:
   - Trim down the plugin list to only essential ones
   - Use `blink.cmp` for completion instead of built-in completion for better UX
   - Maintain a minimal yet powerful development environment

3. **Adopt mini.nvim as Core UI Framework**:
   - Migrate from snacks.nvim to mini.nvim for better integration
   - Use consistent plugin ecosystem from the same author
   - Reduce dependencies while maintaining feature parity

The result is a faster, more maintainable configuration that still provides all the necessary features for modern development.

[![IT Man - My Tiny Nvim (2025 version) for Neovim 0.11+](https://i.ytimg.com/vi/-N9QTQzEt0w/hqdefault.jpg)](https://www.youtube.com/watch?v=-N9QTQzEt0w)

### 🏠 [Homepage](itman.fyi)

## Quick Start

### One-liner Installation (Recommended)

```bash
# Install with default app name (tiny-nvim)
curl -s https://raw.githubusercontent.com/jellydn/tiny-nvim/main/install.sh | bash

# Or install with custom app name
curl -s https://raw.githubusercontent.com/jellydn/tiny-nvim/main/install.sh | bash -s -- --appname my_nvim
```

This will:

1. Backup your existing Neovim configuration (if any)
2. Clone the repository
3. Install all required tools
4. Install all plugins in headless mode
5. Set up your complete Neovim environment

After installation, you can start Neovim with:

```bash
# If using default app name
NVIM_APPNAME=tiny-nvim nvim

# If using custom app name
NVIM_APPNAME=my_nvim nvim
```

### Cleanup

To completely remove this configuration, run:

```bash
# Replace APPNAME with your chosen name (tiny-nvim or custom name)
rm -rf ~/.config/APPNAME
rm -rf ~/.local/share/APPNAME
rm -rf ~/.cache/APPNAME
rm -rf ~/.local/state/APPNAME
```

### Manual Installation

If you prefer to install manually:

1. Clone this repository:

```bash
git clone https://github.com/jellydn/tiny-nvim.git ~/.config/tiny-nvim
```

2. Run the installation script to set up all required tools:

```bash
cd ~/.config/tiny-nvim
./scripts/install-tools.sh
```

3. Launch Neovim with this configuration:

```bash
NVIM_APPNAME=tiny-nvim nvim
```

## Health Checks & Debugging

After installation, run the following commands to ensure everything is set up correctly:

1. Check overall Neovim health:

```vim
:checkhealth
```

2. Verify LSP configuration:

```vim
:check vim.lsp
```

3. For formatting issues, check conform.nvim status:

```vim
:ConformInfo
```

For more detailed debugging information, refer to [conform.nvim debugging guide](https://github.com/stevearc/conform.nvim/blob/master/doc/debugging.md#tools).

## Filetype Mappings

This config includes custom filetype mappings to help LSPs attach cleanly and avoid `:checkhealth` warnings
for uncommon extensions and templates. The mappings live in `lua/config/autocmds.lua`.

## Features

<details>
<summary>Click to expand features</summary>

### Migration from snacks.nvim to mini.nvim

This configuration has migrated from `snacks.nvim` to `mini.nvim` as its core UI framework.

**Why mini.nvim?**

- Consistent ecosystem from a single author
- Better integration between plugins
- Reduced dependencies while maintaining feature parity
- Optimized for Neovim 0.13+

| Feature      | Previously (snacks) | Now (mini.nvim + extras) |
| ------------ | ------------------- | ------------------------ |
| Fuzzy Picker | Snacks.picker       | fff.nvim (primary) + mini.pick |
| Dashboard    | Snacks.dashboard    | mini.starter             |
| File Explorer| Snacks.explorer     | oil.nvim                 |
| Git Diff     | Snacks.git          | mini.diff                |
| Icons        | nvim-web-devicons   | mini.icons               |

> **Note**: `snacks.nvim` is still available as an optional extra plugin if you prefer it.

---

### mini.nvim Ecosystem

This configuration leverages the mini.nvim plugin suite as its core UI framework:

- **mini.pick**: Fuzzy finder for files, buffers, git, and more
- **mini.starter**: Beautiful start screen dashboard
- **mini.diff**: Git diff integration with hunk navigation
- **mini.statusline**: Lightweight, informative statusline
- **mini.tabline**: Smart buffer/tabline with buffer management
- **mini.icons**: Comprehensive icon support
- **fff.nvim**: Fast fuzzy file picker with frecency scoring and live grep
- **mini.ai**: Enhanced text objects for code
- **mini.pairs**: Automatic bracket and quote pairing
- **mini.bufremove**: Cleaner buffer deletion
- **mini.extra**: Additional pickers and utilities

---

### Core Development

- **LSP & Completion**
  - Built-in LSP support (Neovim 0.11+ `lsp/` format; runtime **0.13+**)
  - Defaults: TypeScript/`vtsls`, Python/`ty`+`ruff`, JS lint via nearest biome → oxlint → eslint
  - [blink.cmp](https://github.com/saghen/blink.cmp) (v1.\*): Enhanced completion menu
  - [conform.nvim](https://github.com/stevearc/conform.nvim): Code formatting
  - [nvim-lint](https://github.com/mfussenegger/nvim-lint): Linting support

- **AI & Code Assistance**
  - **Enabled by default:** [sidekick.nvim](https://github.com/folke/sidekick.nvim) for AI CLI tools + Copilot NES
  - **Extra plugins:** [blink-copilot](https://github.com/fang2hou/blink-copilot), [copilot.vim](https://github.com/github/copilot.vim), [claudecode.nvim](https://github.com/coder/claudecode.nvim)

**Usage Tips:**
  - **Sidekick** (`<leader>a*`): AI CLI integration with Claude, Gemini, Copilot CLI and more. Includes Next Edit Suggestions (NES) for multi-line refactorings
  - **Claude Code** (`<C-,>`): Quick access to Claude in a floating window (when enabled)
  - Both can be used simultaneously without conflicts - different keybindings and use cases

**Alternative:** [CopilotChat.nvim](https://github.com/CopilotC-Nvim/CopilotChat.nvim) is available as an extra plugin if you prefer the traditional chat interface

- **Code Generation & Documentation**
  - [LuaSnip](https://github.com/L3MON4D3/LuaSnip) (v2.\*): Snippet engine
  - [friendly-snippets](https://github.com/rafamadriz/friendly-snippets): Snippet collection
  - [neogen](https://github.com/danymat/neogen): Documentation generator
  - [ts-comments.nvim](https://github.com/folke/ts-comments.nvim): Comment utilities

- **Git Integration**
  - Git hunks and signs via mini.diff

### Testing & Debugging

- [neotest](https://github.com/nvim-neotest/neotest): Testing framework
- [vim-test](https://github.com/vim-test/vim-test): Testing framework
- [trouble.nvim](https://github.com/folke/trouble.nvim): Diagnostics and quickfix management

### UI & Theme

- [kanagawa.nvim](https://github.com/rebelot/kanagawa.nvim): Beautiful theme inspired by Kanagawa wave
- [mini.nvim](https://github.com/echasnovski/mini.nvim): Buffer management via mini.tabline/mini.bufremove
- Statusline, tabline, icons, and starter via mini.nvim ecosystem
- [noice.nvim](https://github.com/folke/noice.nvim): Improved notifications and command-line UI
- [tiny-term.nvim](https://github.com/jellydn/tiny-term.nvim): Lightweight terminal manager with simple toggles

Theme switching:

- Default theme: `kanagawa`
- Switch theme: `:Theme kanagawa`
- Check current theme: `:Theme`

### Navigation & Search

- [flash.nvim](https://github.com/folke/flash.nvim): Navigation and search enhancements
- [which-key.nvim](https://github.com/folke/which-key.nvim): Keybinding hints and management
- [fff.nvim](https://github.com/dmtrKovalenko/fff.nvim): Fast fuzzy file picker with frecency scoring, git integration, and live grep
- [oil.nvim](https://github.com/stevearc/oil.nvim): File explorer that lets you edit your filesystem like a buffer
- Fuzzy finder and extra pickers via mini.nvim ecosystem
- [better-escape.nvim](https://github.com/max397574/better-escape.nvim): Better escape functionality
- [grug-far.nvim](https://github.com/MagicDuck/grug-far.nvim): Advanced search and replace functionality

### Picker Keymaps (FFF)

#### General

| Keymap | Mode | Description |
| --- | --- | --- |
| `<leader><space>` | n | Find Files (FFF — frecency-scored) |
| `<leader>/` | n | Live Grep (FFF) |
| `<leader>ff` | n | Find Files (FFF) |
| `<leader>fr` | n | Recent Files |
| `<C-e>` | n | Find Files at project directory (FFF) |
| `<leader>,` | n | Switch Buffer |
| `<leader>:` | n | Command History |

#### FFF Prefix (`<leader>'`)

| Keymap | Mode | Description |
| --- | --- | --- |
| `<leader>'f` | n | FFF find files |
| `<leader>'g` | n | FFF live grep |
| `<leader>'z` | n | FFF fuzzy grep |
| `<leader>'c` | n | FFF search current word |
| `<leader>'r` | n | FFF recent files |

#### Explorer

| Keymap | Mode | Description |
| --- | --- | --- |
| `<leader>e` | n | File Explorer (oil — floating window) |

#### Find (`<leader>f`)

| Keymap | Mode | Description |
| --- | --- | --- |
| `<leader>fb` | n | Buffers |
| `<leader>fc` | n | Find Config File (FFF) |
| `<leader>fa` | n | Find Files (all, including gitignored) |
| `<leader>fg` | n | Find Git Files (including untracked) |
| `<leader>fR` | n | Resume last picker |

#### Git (`<leader>g`)

| Keymap | Mode | Description |
| --- | --- | --- |
| `<leader>gc` | n | Git Commits |
| `<leader>gs` | n | Git Status |
| `<leader>gS` | n | Git Stash |
| `<leader>gb` | n | Git Branches |
| `<leader>gB` | n | Git Buffer Commits |

#### Search (`<leader>s`)

| Keymap | Mode | Description |
| --- | --- | --- |
| `<leader>sb` | n | Search Current Buffer |
| `<leader>sB` | n | Search Lines in Open Buffers |
| `<leader>sg` | n | Grep (all files, including hidden) |
| `<leader>sw` | n | Search word under cursor (FFF) |
| `<leader>fw` | n | Search word under cursor (FFF) |
| `<leader>fw` | v | Search visual selection (FFF) |
| `<leader>s"` | n | Registers |
| `<leader>sa` | n | Find Actions (Commands) |
| `<leader>s:` | n | Command History |
| `<leader>sc` | n | Autocmds |
| `<leader>sC` | n | Commands |
| `<leader>sd` | n | Document Diagnostics |
| `<leader>sD` | n | Workspace Diagnostics |
| `<leader>sh` | n | Help Pages |
| `<leader>sH` | n | Highlights |
| `<leader>si` | n | LSP Incoming Calls |
| `<leader>so` | n | LSP Outgoing Calls |
| `<leader>sj` | n | Search Jumplist |
| `<leader>sk` | n | Search Keymaps |
| `<leader>sl` | n | Location List |
| `<leader>sm` | n | Search Marks |
| `<leader>sM` | n | Man Pages |
| `<leader>sq` | n | Search Quickfix |
| `<leader>st` | n | Todo Comments |
| `<leader>sT` | n | Todo/Fix/Fixme |
| `<leader>su` | n | Changelist |
| `<leader>sp` | n | Search for Plugin Spec (FFF) |
| `<leader>uC` | n | Colorschemes |

#### LSP

| Keymap | Mode | Description |
| --- | --- | --- |
| `gd` | n | Goto Definition |
| `gD` | n | Goto Declaration |
| `gr` | n | References |
| `gi` | n | Goto Implementation |
| `gy` | n | Goto Type Definition |
| `<leader>ss` | n | LSP Document Symbols |
| `<leader>sS` | n | LSP Workspace Symbols |

### Task Management & Productivity

- [hurl.nvim](https://github.com/jellydn/hurl.nvim): Run HTTP requests directly from `.hurl` files
- [overseer.nvim](https://github.com/stevearc/overseer.nvim): Task runner and job management
- [persistence.nvim](https://github.com/folke/persistence.nvim): Session management
- [quick-code-runner.nvim](https://github.com/jellydn/quick-code-runner.nvim): Quick code execution
- [refactoring.nvim](https://github.com/ThePrimeagen/refactoring.nvim): Code refactoring tools
- [todo-comments.nvim](https://github.com/folke/todo-comments.nvim): Highlight and search for todo comments

### File Type Support

- [render-markdown.nvim](https://github.com/MeanderingProgrammer/render-markdown.nvim): Markdown rendering and preview
- [previm](https://github.com/previm/previm): Markdown preview in browser
- [ts-error-translator.nvim](https://github.com/dmmulroy/ts-error-translator.nvim): TypeScript error translation
- [typecheck.nvim](https://github.com/jellydn/typecheck.nvim): Type checking for TypeScript

### VSCode Integration

This configuration works seamlessly with VSCode/Cursor through the
[vscode-neovim](https://github.com/vscode-neovim/vscode-neovim) extension. The configuration includes:

- [VSCode-specific keymaps](lua/plugins/vscode.lua) for enhanced productivity
- Integration with VSCode's built-in features
- Support for multiple cursors and fast cursor movement
- Git integration and file navigation
- Task running and debugging support

To use this configuration in VSCode/Cursor:

1. Install the vscode-neovim extension
2. Set your Neovim configuration path to point to this config:

```json
    "vscode-neovim.NVIM_APPNAME": "tiny-nvim",
   ```

3. Restart VSCode/Cursor (or **Developer: Reload Window** after pulling keymap changes)

You'll get the same Neovim experience in VSCode, including all the plugins and keybindings.

**Neovim 0.13 / Cursor notes**

| Key | Behavior under vscode-neovim |
| --- | --- |
| `-` | Reveal active file in VS Code explorer (built-in `nvim.dir` buffer tree is disabled) |
| `g<Space>` | Treesitter **expand** selection (preferred; no flash letter marks) |
| `gS` / visual `<BS>` | Treesitter **shrink** selection |
| `S` | Labeled treesitter select via vscode decorations |
| `s` | Flash jump |

`Ctrl+Space` is often stolen by macOS Input Sources or Cursor Suggest. Prefer `g<Space>`,
or restore Neovim ownership in Cursor `keybindings.json`:

```json
{
  "key": "ctrl+space",
  "command": "vscode-neovim.send",
  "args": "<C-Space>",
  "when": "editorTextFocus && neovim.init && neovim.mode != 'insert'"
}
```

Native visual `an`/`in` treesitter textobjects may land on recent nightlies; until the
public API is stable, keep using `g<Space>` / `gS`.

### Language Support

The configuration includes specialized support for various programming languages in the `lua/langs` directory:

- **TypeScript / JavaScript**: `vtsls` by default; one of biome / oxlint / eslint from nearest project markers
- **Lua**: `lua_ls` with syntax highlighting and completion
- **Go**: `gopls` LSP integration
- **Python**: Astral `ty` (types) + `ruff` (lint/format)
- **Markdown**: Markdown editing with preview support

Each language configuration is modular and can be customized according to your needs.

### Theme

This configuration uses [kanagawa.nvim](https://github.com/rebelot/kanagawa.nvim) as the default theme. The theme is inspired by the Kanagawa wave and provides a beautiful, elegant color scheme that's easy on the eyes while maintaining good contrast and readability.

</details>

## Keymaps

<details>
<summary>Click to expand keymaps</summary>

### Buffer Management

| Key             | Description                 |
| --------------- | --------------------------- |
| `<leader>bo`    | Delete Other Buffers        |
| `<leader>br`    | Delete Buffers to the Right |
| `<leader>bl`    | Delete Buffers to the Left  |
| `<S-h>` or `[b` | Previous Buffer             |
| `<S-l>` or `]b` | Next Buffer                 |
| `<leader>bb`    | Switch to Other Buffer      |
| `<leader>`      | Switch to Other Buffer      |

### Window Management

| Key           | Description            |
| ------------- | ---------------------- |
| `<C-h>`       | Go to Left Window      |
| `<C-j>`       | Go to Lower Window     |
| `<C-k>`       | Go to Upper Window     |
| `<C-l>`       | Go to Right Window     |
| `<C-Up>`      | Increase Window Height |
| `<C-Down>`    | Decrease Window Height |
| `<C-Left>`    | Decrease Window Width  |
| `<C-Right>`   | Increase Window Width  |
| `<leader>ww`  | Other Window           |
| `<leader>wd`  | Delete Window          |
| `<leader>w-`  | Split Window Below     |
| `<leader>w\|` | Split Window Right     |
| `<leader>-`   | Split Window Below     |
| `<leader>\|`  | Split Window Right     |

### Tab Management

| Key              | Description      |
| ---------------- | ---------------- |
| `<leader><tab>l` | Last Tab         |
| `<leader><tab>o` | Close Other Tabs |
| `<leader><tab>f` | First Tab        |
| `<leader><tab>`  | New Tab          |
| `<leader><tab>]` | Next Tab         |
| `<leader><tab>d` | Close Tab        |
| `<leader><tab>[` | Previous Tab     |

### Movement & Editing

| Key        | Description                                      |
| ---------- | ------------------------------------------------ |
| `j`        | Down (with gj for wrapped lines)                 |
| `k`        | Up (with gk for wrapped lines)                   |
| `<A-j>`    | Move Line Down                                   |
| `<A-k>`    | Move Line Up                                     |
| `gl`       | Go to end of line                                |
| `gh`       | Go to start of line                              |
| `<A-a>`    | Select all text                                  |
| `g<Space>` | Treesitter expand selection (no flash labels)    |
| `gS`       | Treesitter shrink selection (visual)             |

### Git Operations

| Key           | Description   |
| ------------- | ------------- |
| `]h`          | Next Hunk     |
| `[h`          | Previous Hunk |
| `]H`          | Last Hunk     |
| `[H`          | First Hunk    |
| `<leader>ghs` | Stage Hunk    |
| `<leader>ghr` | Reset Hunk    |
| `<leader>gc`  | Git Log       |
| `<leader>gs`  | Git Hunks     |
| `<leader>gS`  | Git Stash     |
| `<leader>gg`  | Lazygit       |

### LSP & Code Actions

| Key          | Description             |
| ------------ | ----------------------- |
| `<leader>ca` | Code Action             |
| `<leader>cr` | Rename                  |
| `<leader>cf` | Format Document         |
| `<leader>.`  | Quick Fix / Code Action |
| `gd`         | Go to Definition        |
| `K`          | Show Documentation      |

### Copilot _(extra plugin)_

| Key     | Description         |
| ------- | ------------------- |
| `<C-y>` | Accept Suggestion   |
| `<C-i>` | Accept Line         |
| `<C-j>` | Next Suggestion     |
| `<C-k>` | Previous Suggestion |
| `<C-d>` | Dismiss Suggestion  |

### Search & Replace

| Key          | Description                                   |
| ------------ | --------------------------------------------- |
| `<leader>sr` | Search and Replace (with file type filtering) |
| `n`          | Next Search Result                            |
| `N`          | Previous Search Result                        |
| `<leader>ur` | Redraw / Clear hlsearch / Diff Update         |

### Diagnostics & Quickfix

| Key          | Description                       |
| ------------ | --------------------------------- |
| `<leader>xx` | Toggle Diagnostics                |
| `<leader>xX` | Toggle Buffer Diagnostics         |
| `<leader>cs` | Toggle Symbols                    |
| `<leader>cl` | Toggle LSP Definitions/References |
| `<leader>xL` | Toggle Location List              |
| `<leader>xQ` | Toggle Quickfix List              |
| `[q`         | Previous Quickfix                 |
| `]q`         | Next Quickfix                     |
| `<leader>cd` | Line Diagnostics                  |
| `]d`         | Next Diagnostic                   |
| `[d`         | Previous Diagnostic               |
| `]e`         | Next Error                        |
| `[e`         | Previous Error                    |
| `]w`         | Next Warning                      |
| `[w`         | Previous Warning                  |

### File Operations

| Key          | Description                         |
| ------------ | ----------------------------------- |
| `<C-s>`      | Save File                           |
| `<leader>fn` | New File                            |
| `<leader>qq` | Quit All                            |
| `<C-c>`      | Copy whole file content             |
| `<leader>m`  | Markdown preview (Previm)          |
| `<leader>tm` | Toggle Markdown preview (Render)    |
| `-`          | Open parent directory (oil; native `nvim.dir` disabled) |
| `<leader>e`  | File Explorer (oil — floating window) |
| `<C-s>`      | Save all changes (oil)              |
| `q`          | Close oil buffer                    |
| `<C-y>`      | Copy entry path (oil)               |

### Search & Navigation

| Key              | Description           |
| ---------------- | --------------------- |
| `<leader><space>` | Find Files (FFF)     |
| `<leader>/`       | Live Grep (FFF)      |
| `<leader>ff`      | Find Files (FFF)     |
| `<leader>'f`      | FFF find files       |
| `<leader>'g`      | FFF live grep        |

### UI & Formatting

| Key          | Description              |
| ------------ | ------------------------ |
| `<leader>ui` | Inspect Position         |
| `<leader>uI` | Inspect Tree             |
| `<leader>uf` | Toggle Autoformat        |
| `<leader>zz` | Open Lazy Plugin Manager |
| `<leader>?`  | Show Buffer Keymaps      |

### Todo Comments

| Key          | Description                  |
| ------------ | ---------------------------- |
| `<leader>st` | Show all todo comments       |
| `<leader>sT` | Show todo/fix/fixme comments |

### Dashboard

| Item            | Description           |
| --------------- | --------------------- |
| Find File       | FFF find files        |
| Find Text       | FFF live grep         |
| Recent Files    | Recently opened files |
| Config          | FFF find files in config |
| Restore Session | Load last session     |
| Lazy            | Open lazy.nvim        |
| Update          | Update plugins        |
| Quit            | Quit Neovim           |

### Terminal

| Key          | Description        |
| ------------ | ------------------ |
| `<esc><esc>` | Enter Normal Mode  |
| `<C-h>`      | Go to Left Window  |
| `<C-j>`      | Go to Lower Window |
| `<C-k>`      | Go to Upper Window |
| `<C-l>`      | Go to Right Window |
| `<leader>ft` | Toggle Terminal    |
| `<C-/>`      | Toggle Terminal    |

### Treesitter

| Key         | Description                          |
| ----------- | ------------------------------------ |
| `<C-space>` | Increment Selection                  |
| `<bs>`      | Decrement Selection (in visual mode) |

### Folding

| Key  | Description                                  |
| ---- | -------------------------------------------- |
| `zv` | Close all folds except the current one       |
| `zj` | Close current fold when open, open next fold |
| `zk` | Close current fold when open, open prev fold |

### Neovide Specific

| Key     | Description           |
| ------- | --------------------- |
| `<D-s>` | Save File             |
| `<D-c>` | Copy (in visual mode) |
| `<D-v>` | Paste (in all modes)  |

### AI (Sidekick)

| Key          | Description                         |
| ------------ | ----------------------------------- |
| `<leader>aa` | Sidekick - Toggle CLI               |
| `<leader>as` | Sidekick - Select CLI tool          |
| `<leader>ad` | Sidekick - Detach CLI session       |
| `<leader>at` | Sidekick - Send "this" context      |
| `<leader>af` | Sidekick - Send file                |
| `<leader>av` | Sidekick - Send visual selection    |
| `<leader>ap` | Sidekick - Select prompt            |
| `<leader>ac` | Sidekick - Toggle Claude            |
| `<leader>am` | Sidekick - Generate commit message  |
| `<Tab>`      | Next Edit Suggestion - Jump/Apply   |
| `<C-.>`      | Sidekick - Switch focus to/from CLI |

### Claude Code (extra)

| Key          | Description              |
| ------------ | ------------------------ |
| `<C-,>`      | Toggle Claude            |
| `<leader>Cc` | Toggle Claude            |
| `<leader>Cf` | Focus Claude             |
| `<leader>Cs` | Send selection to Claude |
| `<leader>Cb` | Add buffer to Claude     |
| `<leader>Ca` | Accept diff              |
| `<leader>Cd` | Deny diff                |
| `<leader>Cp` | Select prompt            |
| `<leader>Ce` | Explain code             |
| `<leader>Cr` | Review code              |
| `<leader>Ct` | Write tests              |
| `<leader>Cm` | Generate commit message  |
| `<leader>Co` | Optimize code            |
| `<leader>Cx` | Fix issues               |
| `<leader>CR` | Refactor code            |
| `<leader>CD` | Add documentation        |
| `<leader>CS` | Security review          |

### Testing

| Key           | Description         |
| ------------- | ------------------- |
| `<leader>cjt` | Run Test Nearest    |
| `<leader>cjT` | Run Test File       |
| `<leader>cjS` | Run Test Suite      |
| `<leader>ctt` | Run File            |
| `<leader>ctT` | Run All Test Files  |
| `<leader>ctr` | Run Nearest         |
| `<leader>ctl` | Run Last            |
| `<leader>cts` | Toggle Summary      |
| `<leader>cto` | Show Output         |
| `<leader>ctO` | Toggle Output Panel |
| `<leader>ctS` | Stop                |
| `<leader>ctw` | Toggle Watch        |

### Task Runner & Code Execution

| Key          | Description           |
| ------------ | --------------------- |
| `<leader>ot` | Run Task              |
| `<leader>oq` | Quick Action          |
| `<leader>or` | Rerun Last Task       |
| `<leader>oo` | Toggle at bottom      |
| `<leader>cp` | Quick Code Runner/Pad |

### Hurl (API Testing)

| Key          | Description                       |
| ------------ | --------------------------------- |
| `<leader>hA` | Run All requests                  |
| `<leader>ha` | Run Api request                   |
| `<leader>he` | Run Api request to entry          |
| `<leader>hE` | Run Api request from entry to end |
| `<leader>hv` | Run Api in verbose mode           |
| `<leader>hV` | Run Api in very verbose mode      |
| `<leader>hr` | Rerun last command                |
| `<leader>hh` | Hurl Runner/Show Last Response    |
| `<leader>hg` | Add global variable               |
| `<leader>hG` | Manage global variable            |
| `<leader>tH` | Toggle Hurl Split/Popup           |
| `<leader>hd` | Debug Info                        |

</details>

## Neovide

```toml
# .config/neovide/config.toml
fork = true # Detach from the terminal instead of waiting for the Neovide process to terminate.
frame = "buttonless" # Transparent decorations including a transparent bar.
maximized = true # Maximize the window on startup, while still having decorations and the status bar of your OS visible.
title-hidden = true
```

# Fonts

<details>
<summary>Click to expand font recommendations</summary>

I recommend using the following repo to get a "Nerd Font" (Font that supports icons)

[getnf](https://github.com/ronniedroid/getnf)

</details>

## Project-Specific Configuration

<details>
<summary>Click to expand project configuration details</summary>

This configuration supports project-specific settings through `.nvim-config.lua` files. When Neovim starts, it will automatically look for a `.nvim-config.lua` file in the current working directory and load it if available.

### Quick Setup with ProjectSettings

You can quickly create a `.nvim-config.lua` file using the `:ProjectSettings` command. This interactive command will:

1. Show available plugins and LSP servers
2. Let you select which ones to enable
3. Create a `.nvim-config.lua` file with your selections

Example usage:

```vim
:ProjectSettings
```

Available options:

1. Plugins:
   - `no-neck-pain`: Additional UI plugin
   - `codecompanion`: AI code companion
   - `avante`: Alternative AI assistant
   - `mcphub`: Minecraft Plugin Hub
   - `fold-preview`: Fold preview
   - `difft`: Structural diffs

2. LSP Servers:
   - `vtsls`: TypeScript/JavaScript language server (default; `ts_ls` is legacy)
   - `biome` / `oxlint` / `eslint`: JS lint — nearest directory with markers (biome > oxlint > eslint; not all at once)
   - `lua_ls`: Lua language server
   - `json`: JSON language server
   - `ty` / `ruff`: Astral Python stack (types + lint/format)
   - `gopls`: Go language server
   - `tailwindcss`: Tailwind CSS language server

When prompted, enter your selections as comma-separated values:

```
Plugins: no-neck-pain,codecompanion
LSP: biome
```

### Manual Configuration

You can also manually create a `.nvim-config.lua` file:

```lua
-- Project-specific Neovim configuration

-- TypeScript LSP: default is "vtsls"; set "ts_ls" only for legacy typescript-language-server
vim.g.lsp_typescript_server = "vtsls"

-- Optional: force JS linter (default auto: nearest dir, biome > oxlint > eslint)
-- vim.g.lsp_js_linter = "biome" -- or "oxlint" | "eslint" | false

-- Force additional LSP servers (rarely needed; eslint is not auto-started)
vim.g.lsp_on_demands = {
  -- e.g. "eslint" if you must force it without config markers
}

-- Enable extra plugins
vim.g.enable_extra_plugins = {
  "no-neck-pain",  -- Additional UI plugin
}

-- Note: fff.nvim (file picker) and oil.nvim (file explorer) are always enabled.
-- They do not need to be listed here.

-- Set any other project-specific settings
vim.opt.tabstop = 2
vim.opt.shiftwidth = 2
```

This file is not tracked by git, making it perfect for project-specific customizations.

</details>

## Extra Plugins

<details>
<summary>Click to expand extra plugins</summary>

This configuration includes several extra plugins that can be enabled on demand through your project-specific configuration. These plugins provide additional functionality without bloating the core configuration.

### Available Extra Plugins

1. **[no-neck-pain.nvim](https://github.com/shortcuts/no-neck-pain.nvim)**
   - Distraction-free writing mode with customizable width
   - Alternative to zen-mode with a focus on reducing neck strain
   - Keymaps:
     - `<leader>cz`: Toggle No Neck Pain mode
     - `<leader>zu`: Increase width
     - `<leader>zd`: Decrease width

2. **[codecompanion.nvim](https://github.com/olimorris/codecompanion.nvim)**
   - AI code companion with GitHub Copilot integration
   - Rich set of features including code explanation, refactoring, and inline documentation
   - Supports slash commands for context-aware actions
   - Keymaps prefix: `<leader>A`
   - Visual mode selections:
     - `<leader>Ae`: Explain selected code
     - `<leader>Af`: Fix selected code
     - `<leader>At`: Generate unit tests for selected code
     - `<leader>Ar`: Refactor selected code
     - `<leader>Ad`: Add inline documentation
     - `<leader>An`: Suggest better naming

3. **[avante.nvim](https://github.com/yetone/avante.nvim)**
   - Alternative AI code assistant using Copilot
   - Replaces the standard Copilot implementation
   - Provides a more streamlined interface

4. **[mcphub.nvim](https://github.com/ravitemer/mcphub.nvim)**
   - Minecraft Plugin Hub integration
   - Access Minecraft plugins directly from Neovim
   - Command: `:MCPHub`

5. **[nvim-ufo](https://github.com/kevinhwang91/nvim-ufo)**
   - Ultra-fast folding with treesitter and indent providers
   - Enhanced fold text with line count display
   - Improves code navigation and readability
   - Keymaps:
     - `zR`: Open all folds
     - `zM`: Close all folds

6. **[fold-preview.nvim](https://github.com/anuvyklack/fold-preview.nvim)**
   - Preview folded code without opening the fold
   - Includes pretty-fold.nvim for better fold text formatting
   - Smart fold navigation with h/l keys
   - Shows fold level indicators and line counts

7a. **[copilot-chat.nvim](https://github.com/CopilotC-Nvim/CopilotChat.nvim)** - Traditional AI chat interface with GitHub Copilot - Interactive conversations, code explanations, and commit message generation - Alternative to sidekick.nvim if you prefer a dedicated chat window - Automatically disables sidekick.nvim when enabled - Keymaps (when enabled): - `<leader>ap`: Prompt actions - `<leader>am`: Generate commit message - `<leader>af`: Fix diagnostic - `<leader>al`: Clear buffer and chat history - `<leader>av`: Toggle chat window - `<leader>a?`: Select models

7b. **[copilot.vim](https://github.com/github/copilot.vim)** - GitHub Copilot integration moved to extra plugins - Provides AI-powered code completion and suggestions - Keymaps (when enabled): - `<C-y>`: Accept suggestion - `<C-i>`: Accept line - `<C-j>`: Next suggestion - `<C-k>`: Previous suggestion - `<C-d>`: Dismiss suggestion - Note: This plugin is disabled by default and can be enabled via extra plugins

7c. **[blink-copilot](https://github.com/fang2hou/blink-copilot)** - Copilot source for blink.cmp - Note: This plugin is disabled by default and can be enabled via extra plugins

7d. **[claudecode.nvim](https://github.com/coder/claudecode.nvim)** - Claude Code integration (floating terminal + prompt shortcuts) - Note: This plugin is disabled by default and can be enabled via extra plugins

8. **[difft.nvim](https://github.com/ahkohd/difft.nvim)**
   - Beautiful structural diffs using difft
   - Shows git diffs with better syntax highlighting and structure awareness
   - Supports multiple layouts: buffer, float, or ivy_taller
   - Keymaps:
     - `<leader>gd`: Toggle Difft viewer

9. **[scooter](https://github.com/liamg/scooter)**
    - Blazingly fast file search and navigation
    - Alternative to grug-far with better performance
    - Interactive fuzzy search with file preview
    - Automatically disables grug-far.nvim when enabled
    - Keymaps:
      - `<leader>sr`: Open scooter (normal mode)
      - `<leader>sr`: Search selected text in scooter (visual mode)

### Enabling Extra Plugins

To enable any of these plugins, add them to your `.nvim-config.lua` file:

```lua
vim.g.enable_extra_plugins = {
  "no-neck-pain",
  "codecompanion",
  "avante",
  "mcphub",
  "nvim-ufo",
  "fold-preview",
  "copilot-chat",  -- Alternative to sidekick.nvim
  "copilot",       -- GitHub Copilot integration
  "blink-copilot", -- Copilot source for blink.cmp
  "claudecode",    -- Claude Code integration
  "difft",
  "scooter"        -- Alternative to grug-far.nvim
}
```

Note that some plugins like `avante.nvim`, `copilot-chat`, and `scooter` will disable conflicting plugins when enabled.

</details>

## Uninstall

```sh
  rm -rf ~/.config/nvim
  rm -rf ~/.local/share/nvim
  rm -rf ~/.cache/nvim
  rm -rf ~/.local/state/nvim
```

# Tips

<details>
<summary>Click to expand helpful tips</summary>

- Improve key repeat on Mac OSX, need to restart

```sh
defaults write NSGlobalDomain KeyRepeat -int 1
defaults write NSGlobalDomain InitialKeyRepeat -int 14
```

- VSCode on Mac

To enable key-repeating, execute the following in your Terminal, log out and back in, and then restart VS Code:

```sh
# For VS Code
defaults write com.microsoft.VSCode ApplePressAndHoldEnabled -bool false
# For VS Code Insider
defaults write com.microsoft.VSCodeInsiders ApplePressAndHoldEnabled -bool false
# If necessary, reset global default
defaults delete -g ApplePressAndHoldEnabled
# For Cursor
defaults write com.todesktop.230313mzl4w4u92 ApplePressAndHoldEnabled -bool false
```

Also increasing Key Repeat and Delay Until Repeat settings in System Preferences -> Keyboard.

[![Key repeat rate](https://i.gyazo.com/e58be996275fe50bee31412ea5930017.png)](https://gyazo.com/e58be996275fe50bee31412ea5930017)

- Disable `full stop with double-space` if you see the delay with `<space>-<space>`

[![Which-key](https://i.gyazo.com/6403f6c57d2e54aca230589b2173eeb0.png)](https://gyazo.com/6403f6c57d2e54aca230589b2173eeb0)

</details>

## Resources

<details>
<summary>Click to expand learning resources</summary>

This config targets **Neovim 0.13+**. The 0.11 links below still explain the built-in LSP/`lsp/` foundation this repo uses.

- [What's New in Neovim 0.11](https://gpanders.com/blog/whats-new-in-neovim-0-11/): A detailed overview of the latest features and improvements in Neovim 0.11.
- [Neovim 0.11 Built-in Completion Setup](https://gist.github.com/miroshQa/7c61292bc37070bb7606a29e07fe00e2): A comprehensive guide for setting up built-in completion in Neovim 0.11+.

[![IT Man - LazyVim Power User Guide](https://i.ytimg.com/vi/jveM3hZs_oI/hqdefault.jpg)](https://www.youtube.com/watch?v=jveM3hZs_oI)

[![IT Man - Talk #33 NeoVim as IDE [Vietnamese]](https://i.ytimg.com/vi/dFi8CzvqkNE/hqdefault.jpg)](https://www.youtube.com/watch?v=dFi8CzvqkNE)

[![IT Man - Talk #35 #Neovim IDE for Web Developer](https://i.ytimg.com/vi/3EbgMJ-RcWY/hqdefault.jpg)](https://www.youtube.com/watch?v=3EbgMJ-RcWY)

[![IT Man - Step-by-Step Guide: Integrating Copilot Chat with Neovim [Vietnamese]](https://i.ytimg.com/vi/By_CCai62JE/hqdefault.jpg)](https://www.youtube.com/watch?v=By_CCai62JE)

[![IT Man - Power up your Neovim with Gen.nvim](https://i.ytimg.com/vi/2nt_qcchW_8/hqdefault.jpg)](https://www.youtube.com/watch?v=2nt_qcchW_8)

[![IT Man - Boost Your Neovim Productivity with GitHub Copilot Chat](https://i.ytimg.com/vi/6oOPGaKCd_Q/hqdefault.jpg)](https://www.youtube.com/watch?v=6oOPGaKCd_Q)

[![IT Man - Get to know GitHub Copilot Chat in #Neovim and be productive IMMEDIATELY](https://i.ytimg.com/vi/sSih4khcstc/hqdefault.jpg)](https://www.youtube.com/watch?v=sSih4khcstc)

[![IT Man - Master Neovim with CopilotChat.nvim v3: Features, Demos, and Innovations](https://i.ytimg.com/vi/PfYnLcSVPh0/hqdefault.jpg)](https://www.youtube.com/watch?v=PfYnLcSVPh0)

[![IT Man - Enhance Your Neovim Experience with LSP Plugins](https://i.ytimg.com/vi/JwWNIQgL4Fk/hqdefault.jpg)](https://www.youtube.com/watch?v=JwWNIQgL4Fk)

[![IT Man - Bringing Zed AI Experience to Neovim with codecompanion.nvim](https://i.ytimg.com/vi/KbWI4ilHKv4/hqdefault.jpg)](https://www.youtube.com/watch?v=KbWI4ilHKv4)

</details>

## Author

👤 **Dung Huynh Duc**

- Website: https://productsway.com/
- Twitter: [@jellydn](https://twitter.com/jellydn)
- Github: [@jellydn](https://github.com/jellydn)

## Show your support

Give a ⭐️ if this project helped you!

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://productsway.com/"><img src="https://avatars.githubusercontent.com/u/870029?v=4?s=100" width="100px;" alt="Dung Duc Huynh (Kaka)"/><br /><sub><b>Dung Duc Huynh (Kaka)</b></sub></a><br /><a href="https://github.com/jellydn/tiny-nvim/commits?author=jellydn" title="Documentation">📖</a> <a href="https://github.com/jellydn/tiny-nvim/commits?author=jellydn" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ZakHargz"><img src="https://avatars.githubusercontent.com/u/54669265?v=4?s=100" width="100px;" alt="Zak Hargreaves"/><br /><sub><b>Zak Hargreaves</b></sub></a><br /><a href="https://github.com/jellydn/tiny-nvim/commits?author=ZakHargz" title="Code">💻</a></td>
    </tr>
  </tbody>
</table>

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

tiny-nvim

tiny-nvim Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

tiny-nvim

tiny-nvim Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README