Neovim Configuration - Kanagawa Dotfiles

Overview

The Kanagawa dotfiles include a powerful Neovim configuration based on LazyVim, featuring automatic theme synchronization, custom plugins, and optimized settings for modern development.

This setup uses LazyVim as the base configuration framework, with custom plugins and theme integration via theme_bridge.lua.

Configuration Structure

~/.config/nvim/
├── init.lua                 # Main entry point
├── lua/
│   ├── config/             # LazyVim configuration
│   │   ├── lazy.lua        # Lazy.nvim setup
│   │   ├── options.lua     # Vim options
│   │   ├── keymaps.lua     # Custom keymaps
│   │   └── autocmds.lua    # Autocommands
│   ├── plugins/            # Custom plugins
│   │   ├── themes.lua      # Theme definitions
│   │   ├── smear.lua       # Smear cursor plugin
│   │   ├── render-markdown.lua
│   │   ├── live-preview.lua
│   │   └── sidekick.lua
│   ├── custom/             # Custom modules
│   │   └── smart_runner.lua
│   └── theme_bridge.lua    # Theme synchronization

Main Configuration

The init.lua file bootstraps LazyVim and adds custom functionality:

-- bootstrap lazy.nvim, LazyVim and your plugins
require("config.lazy")

-- Enable auto-save globally
vim.o.autowriteall = true

-- Auto-save on insert leave and text change
vim.api.nvim_create_autocmd({ "InsertLeave", "TextChanged", "TextChangedP" }, {
  pattern = "*",
  callback = function()
    vim.cmd("silent! write")
  end,
})

Lazy.nvim Setup
Language Support
Auto-save

Plugin Manager Configuration

The lua/config/lazy.lua file configures the Lazy.nvim plugin manager:

require("lazy").setup({
  spec = {
    -- Load LazyVim and its plugins
    { "LazyVim/LazyVim", import = "lazyvim.plugins" },
    
    -- AI plugins
    { import = "lazyvim.plugins.extras.ai.copilot" },
    
    -- Debugging support
    { import = "lazyvim.plugins.extras.dap.core" },
    { import = "lazyvim.plugins.extras.lang.python" },
    
    -- Import custom plugins
    { import = "plugins" },
  },
  defaults = {
    lazy = false,
    version = false,
  },
  checker = {
    enabled = true,
    notify = false,
  },
})

LazyVim Base

Pre-configured Neovim distribution

GitHub Copilot

AI-powered code completion

DAP Debugging

Debug Adapter Protocol support

Python Support

Full Python development environment

LSP Configuration

Mason Setup

require("mason").setup()
require("mason-lspconfig").setup({
    ensure_installed = { "angularls", "ts_ls" }
})

Angular Configuration

local lspconfig = require('lspconfig')

-- Angular Language Server
lspconfig.angularls.setup({
  root_dir = lspconfig.util.root_pattern(
    "angular.json", 
    "nx.json", 
    "package.json"
  ),
})

-- TypeScript Language Server
lspconfig.ts_ls.setup({})

Angular Template Support

vim.api.nvim_create_autocmd({"BufRead", "BufNewFile"}, {
  pattern = {"*.component.html"},
  callback = function()
    vim.opt.filetype = "html.angular"
  end,
})

This configuration provides full Angular support including template syntax highlighting and LSP features.

Automatic File Saving

Files are automatically saved when:

Leaving insert mode
Text is changed
Text is changed in insert mode

vim.o.autowriteall = true

vim.api.nvim_create_autocmd(
  { "InsertLeave", "TextChanged", "TextChangedP" }, 
  {
    pattern = "*",
    callback = function()
      vim.cmd("silent! write")
    end,
  }
)

Auto-save is silent and won’t show save notifications. Make sure you’re comfortable with this behavior.

Theme Integration

Theme Bridge System

The theme_bridge.lua file synchronizes Neovim’s theme with the system theme:

-- lua/theme_bridge.lua
return 'everforest'

Theme Plugin Configuration

The lua/plugins/themes.lua file defines all available themes and loads the active one:

local status_ok, theme_bridge = pcall(require, "theme_bridge")
local current_theme = status_ok and theme_bridge or "kanagawa-wave"

return {
  -- Catppuccin
  {
    "catppuccin/nvim",
    name = "catppuccin",
    priority = 1000,
    opts = {
      flavour = "mocha",
      transparent_background = true,
      term_colors = true,
    },
  },
  
  -- Gruvbox
  {
    "ellisonleao/gruvbox.nvim",
    priority = 1000,
    config = function()
      require("gruvbox").setup({
        transparent_mode = true,
      })
    end,
  },
  
  -- Everforest
  {
    "neanias/everforest-nvim",
    name = "everforest",
    version = false,
    lazy = false,
    priority = 1000,
  },
  
  -- Kanagawa
  {
    "rebelot/kanagawa.nvim",
    name = "kanagawa",
    priority = 1000,
    lazy = true,
    config = function()
      require("kanagawa").setup({
        transparent = true,
        dimInactive = false,
        terminalColors = true,
        overrides = function(colors)
          return {
            LineNr = { bg = "none" },
            NormalFloat = { bg = "none" },
            FloatBorder = { bg = "none" },
            TelescopeNormal = { bg = "none" },
            TelescopeBorder = { bg = "none" },
          }
        end,
      })
    end,
  },
  
  -- Apply theme dynamically
  {
    "LazyVim/LazyVim",
    opts = {
      colorscheme = current_theme,
    },
  },
}

Theme Bridge Read

Neovim reads the current theme from theme_bridge.lua

Plugin Load

The corresponding theme plugin is loaded with transparent background

Apply Colorscheme

LazyVim applies the colorscheme on startup

Custom Plugins

Smear Cursor

Smooth cursor animation plugin:

-- lua/plugins/smear.lua
return {
  "sphamba/smear-cursor.nvim",
  opts = {
    stiffness = 0.8,
    trailing_stiffness = 0.6,
    stiffness_insert_mode = 0.7,
    trailing_stiffness_insert_mode = 0.7,
    damping = 0.95,
    damping_insert_mode = 0.95,
    distance_stop_animating = 0.5,
  },
}

Smear Cursor

Smooth, animated cursor movements

Render Markdown

Live markdown rendering in Neovim

Live Preview

Real-time preview for web development

CMake Tools

C/C++ build integration

Available Themes

Everforest
Kanagawa
Catppuccin
Gruvbox

Everforest Theme

A comfortable, warm theme with excellent readability:

{
  "neanias/everforest-nvim",
  name = "everforest",
}

Current default theme in the Kanagawa dotfiles.

Kanagawa Theme

Dark theme inspired by the famous painting “The Great Wave off Kanagawa”:

{
  "rebelot/kanagawa.nvim",
  name = "kanagawa",
}

Features custom transparency and float window styling.

Catppuccin Mocha

Pastel theme with excellent color harmony:

{
  "catppuccin/nvim",
  name = "catppuccin",
  opts = {
    flavour = "mocha",
    transparent_background = true,
  },
}

Gruvbox

Classic, retro groove theme:

{
  "ellisonleao/gruvbox.nvim",
  config = function()
    require("gruvbox").setup({
      transparent_mode = true,
    })
  end,
}

Key Features

LazyVim Base

Pre-configured distribution with sensible defaults

Theme Sync

Automatic theme synchronization with system

LSP Support

Language servers for TypeScript, Angular, Python, and more

Auto-save

Automatic file saving on changes

GitHub Copilot

AI-powered code completion

DAP Debugging

Full debugging capabilities

Plugin Management

All plugins are managed by Lazy.nvim:

# Inside Neovim
:Lazy          # Open plugin manager
:Lazy update   # Update all plugins
:Lazy sync     # Sync plugins with config
:Lazy clean    # Remove unused plugins

Getting Started

Configuration

Themes

Components

Scripts

Guides

​Overview

​Configuration Structure

​Main Configuration

​Plugin Manager Configuration

LazyVim Base

GitHub Copilot

DAP Debugging

Python Support

​LSP Configuration

​Mason Setup

​Angular Configuration

​Angular Template Support

​Automatic File Saving

​Theme Integration

​Theme Bridge System

​Theme Plugin Configuration

​Custom Plugins

​Smear Cursor

Smear Cursor

Render Markdown

Live Preview

CMake Tools

​Available Themes

​Everforest Theme

​Kanagawa Theme

​Catppuccin Mocha

​Gruvbox

​Key Features

LazyVim Base

Theme Sync

LSP Support

Auto-save

GitHub Copilot

DAP Debugging

​Plugin Management

​Next Steps

Theme Selection

Keybindings

Build docs developers (and LLMs) love

Overview

Configuration Structure

Main Configuration

Plugin Manager Configuration

LSP Configuration

Mason Setup

Angular Configuration

Angular Template Support

Automatic File Saving

Theme Integration

Theme Bridge System

Theme Plugin Configuration

Custom Plugins

Smear Cursor

Available Themes

Everforest Theme

Kanagawa Theme

Catppuccin Mocha

Gruvbox

Key Features

Plugin Management

Next Steps