README.md

🏔 Substrata

A cold, dark color scheme for Neovim written in Lua ported from vim-substrata theme.

✨ Features

• Supports the latest Neovim 0.5 features like TreeSitter and LSP
• Terminal colors inside Neovim
• Color themes for terminals:
  • alacritty
  • gnome-terminal
  • iterm2
  • kitty
  • konsole
  • wezterm

Plugin Support

• TreeSitter
• LSP Diagnostics
• LSP Trouble
• LSP Saga
• Git Signs
• Telescope
• NvimTree
• WhichKey
• Indent Blankline
• BufferLine
• ALE
• vim-sneak
• nvim-cmp
• Hydra

⚡️ Requirements

• Neovim >= 0.5.0

📦 Installation

Install the theme with your preferred package manager:

vim-plug

Plug 'kvrohit/substrata.nvim'

packer

use 'kvrohit/substrata.nvim'

🚀 Usage

Enable the colorscheme:

-- Lua
vim.cmd [[colorscheme substrata]]

" Vim Script
colorscheme substrata

⚙️ Configuration

Configuration needs to be set BEFORE loading the color scheme with colorscheme substrata

Option	Default	Description
substrata_italic_comments	true	Make comments italic
substrata_italic_keywords	false	Make keywords italic
substrata_italic_booleans	false	Make booleans italic
substrata_italic_functions	false	Make functions italic
substrata_italic_variables	false	Make variables italic
substrata_transparent	false	Disable background color
substrata_variant	default	Colorscheme variant

-- Example config in lua
vim.g.substrata_italic_functions = true

-- Load the colorscheme
vim.cmd [[colorscheme substrata]]

" Example config in Vim Script
let g:substrata_italic_functions = 1

" Load the colorscheme
colorscheme substrata

" Setting brighter colorscheme variant
let g:substrata_variant = "brighter"

Preview

Terminal

Shell script

Markdown

YAML

Rust

HTML

CSS

JavaScript

☑️ Extras

• Eclipse color theme: extras/eclipse/substrata.xml
• Gnome Terminal color theme: extras/gnome-terminal/substrata.sh
• iTerm2 color theme: extras/iterm2/substrata.itermcolors
• Konsole color theme: extras/konsole/substrata.colorscheme
• WezTerm color theme: extras/wezterm/colors/Substrata.toml
• kitty color theme: extras/kitty/substrata.conf
• Alacritty color theme: extras/alacritty/substrata.yaml

👍 Credits

• The original authors of the excellent vim-substrata theme.
• Lua plugin derived from neon and influenced by tokyonight.nvim.
• Gnome terminal, Konsole and iTerm2 colors exported from terminal.sexy.