Configuring Serein Colorscheme for Neovim with Lazy.nvim, TreeSitter & Lualine

// SERIES: Serein Workspace (3 lessons · Jump to any part)
  1. 01 Configuring Serein Colorscheme for Neovim with Lazy.nvim, TreeSitter & Lualine
  2. 02 How to Build a Warm Minimalist Dev Setup with VS Code & Windows Terminal
  3. 03 Serein Theme Suite: Extreme Minimalism & The Unified Warm Workspace

For modal editing enthusiasts and terminal maximalists, terminal colorschemes often suffer from two extremes: either washed-out low-contrast gray-on-black or harsh fluorescent highlights that overwhelm syntax hierarchy.

Serein for Neovim is a native Lua colorscheme designed specifically to solve this. Built upon the unified Serein design system by Dyn, it balances warm, organic background tones with readable foreground typography.


1. Why Serein for Neovim?

  • Pure Lua Architecture: Fast initialization with zero runtime overhead.
  • TreeSitter Native: Fine-grained semantic token highlight groups (@keyword, @function, @variable.parameter, @markup.heading).
  • Comprehensive Plugin Support: Pre-configured highlight groups for telescope.nvim, lualine.nvim, which-key.nvim, bufferline.nvim, nvim-cmp, and render-markdown.nvim.
  • Seamless Light/Dark Toggle: Instant switching between Serein Alabaster (Light) and Serein Obsidian (Dark) without restarting Neovim.

2. Installation with lazy.nvim

If you are using the modern lazy.nvim plugin manager, create a new file in your Lua config directory:

~/.config/nvim/lua/plugins/colorscheme.lua (or serein.lua):

return {
  {
    "cmduyeen/serein-neovim",
    name = "serein.nvim",
    lazy = false,
    priority = 1000, -- Load before any other plugins
    config = function()
      require("serein").setup({
        variant = "obsidian", -- Choose "obsidian" (dark) or "alabaster" (light)
        transparent = false,  -- Set to true if you prefer terminal transparency
        integrations = {
          treesitter = true,
          telescope = true,
          cmp = true,
          which_key = true,
          bufferline = true,
        },
      })
      vim.cmd.colorscheme("serein")
    end,
  },
}

3. Pairing Serein with lualine.nvim

Serein includes dedicated statusline integration for lualine.nvim. Simply pass "serein" as your theme:

return {
  {
    "nvim-lualine/lualine.nvim",
    dependencies = { "nvim-tree/nvim-web-devicons" },
    opts = {
      options = {
        theme = "serein",
        component_separators = { left = "", right = "" },
        section_separators = { left = "", right = "" },
      },
    },
  },
}

This pairs your active Vim mode (Normal, Insert, Visual, Command) with subtle semantic accents without high-contrast neon bars distracting your peripheral vision.


4. Keybinding: Instant Light/Dark Mode Switcher

Want to switch from dark mode at night to light mode when working in a sunlit room? Serein provides a built-in toggle helper:

-- Toggle between Serein Obsidian and Alabaster with <leader>ut
vim.keymap.set("n", "<leader>ut", function()
  require("serein").toggle()
end, { desc = "Toggle Serein Light/Dark Theme" })

5. Integrating with Writing & Markdown Plugins

If you use Neovim for note-taking and documentation alongside render-markdown.nvim or obsidian.nvim, Serein automatically styles markdown headers, inline code spans, and callout boxes with gentle, readable background tiers.


Build Your Complete Workspace

Combine Neovim with the matching Serein toolset:

Crafted by Dyn (cmduyeen). Read more terminal tips on Dyn’s Blog or star the repo on GitHub.

Loading comments...