GitHub - danfry1/mind-the-gap: A vibrant dark color theme inspired by the London Underground tube map (original) (raw)

Mind the Gap logo

A vibrant dark color theme inspired by the London Underground tube map.
Built for Neovim, VS Code, terminals, tmux, and CLI tools.

Mind the Gap theme preview

Features

Palette

Backgrounds & foregrounds

Swatch Name Hex Role
Crust #04081a Deepest background
Mantle #081020 Status bars, borders
Base #0c1628 Editor background
Surface 0 #162038 Floats, selections
Surface 1 #1e2844 Active UI elements
Surface 2 #283450 Scrollbars, subtle UI
Swatch Name Hex Role
Text #d8dce8 Primary text
Subtext #a8b0c0 Secondary text
Overlay #708098 UI elements
Comment #587088 Comments

Installation

Neovim

lazy.nvim

{ "danfry1/mind-the-gap", lazy = false, priority = 1000, config = function() require("mindthegap").setup() vim.cmd("colorscheme mindthegap") end, }

packer.nvim

use { "danfry1/mind-the-gap", config = function() require("mindthegap").setup() vim.cmd("colorscheme mindthegap") end, }

Options

All options are optional — defaults work out of the box.

require("mindthegap").setup({ transparent = false, -- set to true to use your terminal's background italics = true, -- set to false to disable italic comments/keywords palette_overrides = { -- override base palette colors before they cascade to all groups foregrounds = { text = "#c8c8d8" }, accents = { elizabeth = "#8060C0" }, }, custom_highlights = function(colors, variant) return { Normal = { bg = "#101828" }, } end, })

Plugin support

Highlight groups are included for these plugins (loaded automatically, no config needed):

Plugin Plugin Plugin
telescope.nvim nvim-cmp gitsigns.nvim
mini.nvim noice.nvim nvim-notify
trouble.nvim flash.nvim neo-tree.nvim
oil.nvim lazy.nvim which-key.nvim
indent-blankline.nvim dashboard-nvim / alpha-nvim snacks.nvim

VS Code

Search for "Mind the Gap" in the Extensions Marketplace, or install from the command line:

code --install-extension DanielFry.mind-the-gap-color-theme

Install from source

cd editors/vscode npx @vscode/vsce package code --install-extension mind-the-gap-color-theme-*.vsix


Zed

Search for "Mind the Gap" in the Zed extension marketplace, or install locally:

mkdir -p ~/.config/zed/themes cp editors/zed/themes/mindthegap.json ~/.config/zed/themes/

Then select Mind the Gap from the theme picker (cmd+k cmd+t).


Terminals

Kitty

curl -o ~/.config/kitty/mindthegap.conf https://raw.githubusercontent.com/danfry1/mind-the-gap/main/terminals/kitty/mindthegap.conf

Then add to ~/.config/kitty/kitty.conf:

Alacritty

curl -o ~/.config/alacritty/mindthegap.toml https://raw.githubusercontent.com/danfry1/mind-the-gap/main/terminals/alacritty/mindthegap.toml

Then add to ~/.config/alacritty/alacritty.toml:

import = ["~/.config/alacritty/mindthegap.toml"]

WezTerm

mkdir -p ~/.config/wezterm/colors curl -o ~/.config/wezterm/colors/mindthegap.toml https://raw.githubusercontent.com/danfry1/mind-the-gap/main/terminals/wezterm/mindthegap.toml

Then set in ~/.config/wezterm/wezterm.lua:

config.color_scheme = "Mind the Gap"

iTerm2

curl -o /tmp/mindthegap.itermcolors https://raw.githubusercontent.com/danfry1/mind-the-gap/main/terminals/iterm2/mindthegap.itermcolors open /tmp/mindthegap.itermcolors

Then go to iTerm2 > Settings > Profiles > Colors > Color Presets... and select Mind the Gap.

Ghostty

mkdir -p ~/.config/ghostty/themes curl -o ~/.config/ghostty/themes/mindthegap https://raw.githubusercontent.com/danfry1/mind-the-gap/main/terminals/ghostty/mindthegap

Then add to ~/.config/ghostty/config:

foot

curl -o ~/.config/foot/mindthegap.ini https://raw.githubusercontent.com/danfry1/mind-the-gap/main/terminals/foot/mindthegap.ini

Then add to ~/.config/foot/foot.ini:

include=~/.config/foot/mindthegap.ini

Windows Terminal

curl -o "$env:LOCALAPPDATA\mindthegap.json" https://raw.githubusercontent.com/danfry1/mind-the-gap/main/terminals/windows-terminal/mindthegap.json

Then copy the contents into the schemes array in your Windows Terminal settings.json, and set "colorScheme": "Mind the Gap" on the desired profile.


Tmux

Via TPM (recommended)

~/.tmux.conf

set -g @plugin 'danfry1/mind-the-gap' run '~/.tmux/plugins/tpm/tpm'

Manual

In ~/.tmux.conf

run-shell /path/to/mind-the-gap/tmux/mindthegap.tmux


CLI Tools

fzf

curl -o ~/.config/fzf/mindthegap.sh https://raw.githubusercontent.com/danfry1/mind-the-gap/main/cli/fzf/mindthegap.sh

Then source it in your shell rc:

source ~/.config/fzf/mindthegap.sh

bat

curl -o "$(bat --config-dir)/themes/mindthegap.tmTheme" https://raw.githubusercontent.com/danfry1/mind-the-gap/main/cli/bat/mindthegap.tmTheme bat cache --build

Then set the theme in ~/.config/bat/config:

delta

curl -s https://raw.githubusercontent.com/danfry1/mind-the-gap/main/cli/delta/mindthegap.gitconfig >> ~/.gitconfig

Then set delta as your Git pager in ~/.gitconfig:

lazygit

curl -s https://raw.githubusercontent.com/danfry1/mind-the-gap/main/cli/lazygit/mindthegap.yml >> "$(lazygit --print-config-dir)/config.yml"

OpenCode

mkdir -p ~/.config/opencode/themes curl -o ~/.config/opencode/themes/mindthegap.json https://raw.githubusercontent.com/danfry1/mind-the-gap/main/cli/opencode/mindthegap.json

Then select Mind the Gap using the /theme command in OpenCode, or set it in your tui.json:

{ "theme": "mindthegap" }


Contributing

palette.json is the single source of truth for all colors. All theme files are generated from it.

bun install # install dependencies bun run generate # regenerate all outputs from palette.json bun test # run tests bun run validate # check WCAG AA contrast ratios bun run check # verify generated files are up to date bun run typecheck # typecheck TypeScript

Please run bun run generate and commit the results before opening a PR.

License

MIT