GitHub - danfry1/mind-the-gap: A vibrant dark color theme inspired by the London Underground tube map (original) (raw)
A vibrant dark color theme inspired by the London Underground tube map.
Built for Neovim, VS Code, terminals, tmux, and CLI tools.
Features
- Tube map colours — every accent is named after a line, using official TfL values where possible
- Single source of truth — every color lives in
palette.json, all outputs are generated - WCAG AA contrast — validated at build time, never ships unreadable text
- 15 Neovim plugin integrations — Telescope, cmp, gitsigns, mini.nvim, noice, trouble, flash, snacks, and more
- Treesitter + LSP semantic tokens — full highlighting with 450+ groups
- 13 terminal/CLI targets — Kitty, Alacritty, WezTerm, Ghostty, iTerm2, foot, Windows Terminal, tmux, fzf, bat, delta, lazygit, OpenCode
- Transparent mode — use your terminal's background
- Configurable italics — toggle italics for comments and keywords
Palette
Backgrounds & foregrounds
| 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):
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.










