Colour themes for Emacs, Neovim, VS Code, WezTerm and your terminal: fifteen flavors, each with a dark and a light version, plus Vitrail, a high-contrast pair for low vision.
Each flavor starts from a scene, a sky at dusk, a lagoon, a peat fire, an illuminated manuscript, and takes its colours from it. The colours are calm and of even strength: none shouts louder than the others, so your eyes can rest anywhere on the screen. Rayleigh is the default flavor.
Lumina is a family of immersion themes. At night above all, the background and every ink come from the same scene, so you do not look at a colour scheme: you sit inside it, at the blue hour, by a reactor pool, in an olive grove at dusk.
Rayleigh, the default flavor, in Emacs: the blue hour by night, a clear noon by day.
The same Rayleigh in VS Code, Neovim and the terminal.
| Flavor | Dark | Light | |
|---|---|---|---|
| Rayleigh | Twilight after sunset: the blue hour, the Belt of Venus and the last gold | A clear sky at noon: sky-blue, gold and terracotta inks on cloud white | |
| Cherenkov | The blue glow of a reactor pool: electric blue, cyan and brass | The same glow by day: cobalt, teal and brass on blue-white paper | |
| Quartz | Rock crystal on a neutral night: clear keywords, ice blue, jade, lilac and rose | Crystal by daylight: graphite keywords, ice blue, jade and amethyst on white | |
| Olive | An olive grove at night: sage, sky blue, honey, mauve and terracotta | Limestone in the Mediterranean sun: olive, sky and honey inks | |
| Dusk | Dusk over the hills: coral, honey, mint and lilac on a violet sky | The hour before sunset: brick coral and honey on lavender paper | |
| Oxblood | Oxblood velvet: raspberry, candle gold, orchid, bottle green and teal | The velvet in daylight: raspberry ink on powder-pink paper | |
| Lagoon | A lagoon at night: turquoise, coral, lavender and sand | Shallow water over white sand: teal, coral and lavender on aqua paper | |
| Ember | A peat fire: ember orange, straw gold, sage and steel blue | Warm ash in the morning: ember, straw and moss inks on ash paper | |
| Canopy | Under the forest canopy: amber, leaf green, sky blue and berry red | Light through the leaves: amber and leaf inks on soft green paper | |
| Harbor | A harbour at night: coral lights, sand, sea green and sky blue on navy | A sea chart: navy ink, coral and sea green on cream paper | |
| Espresso | Smoked tea in a coffee roastery: lavender, honey, mint and terracotta on roasted brown | Crema paper, espresso ink, violet and terracotta | |
| Aurora | The northern lights: aurora green, pale gold, pink and violet on a black-teal night | A snowfield under the aurora: green, gold and pink inks on white | |
| Parchment | An illuminated manuscript by lamplight: gold leaf, vermilion, verdigris, lapis and purple | Vellum and iron-gall ink, with the illuminator's gold, vermilion and lapis | |
| Nebula | An indigo nebula: lavender, gold, jade and sky blue | The nebula in an atlas: violet and jade inks on lavender paper | |
| Polaire | A polar night: glacier blue, lilac and the low sun on the ice | Pale ice under a low sun: glacier and slate inks | |
| Vitrail | Stained glass by night: cobalt, gold, emerald, ruby and amethyst glass lit in black lead, for low vision | Stained glass by day: jewel inks on pale stone, for low vision |
The swatches show the six code colours in role order: keywords, functions, types, strings, constants, builtins; dark variant on the left, light on the right.
Rayleigh
Cherenkov
Quartz
Olive
Dusk
Oxblood
Lagoon
Ember
Canopy
Harbor
Espresso
Aurora
Parchment
Nebula
Polaire
Vitrail
Requires Emacs 27.1 or later. The package is lumina-themes.
Emacs 30, use-package with :vc:
(use-package lumina-themes
:vc (:url "https://github.com/RazikSF/lumina-themes" :lisp-dir "emacs")
:config (load-theme 'lumina-rayleigh-dark t))
Doom Emacs, in packages.el:
(package! lumina-themes
:recipe (:host github :repo "RazikSF/lumina-themes"
:files ("emacs/*.el" "emacs/themes/*.el")))
then in config.el:
(setq doom-theme 'lumina-rayleigh-dark)
straight.el:
(straight-use-package
'(lumina-themes :type git :host github :repo "RazikSF/lumina-themes"
:files ("emacs/*.el" "emacs/themes/*.el")))
(load-theme 'lumina-rayleigh-dark t)
elpaca:
(elpaca (lumina-themes :host github :repo "RazikSF/lumina-themes"
:files ("emacs/*.el" "emacs/themes/*.el")))
By hand: clone the repository, then
(add-to-list 'load-path "/path/to/lumina-themes/emacs")
(add-to-list 'custom-theme-load-path "/path/to/lumina-themes/emacs/themes")
(load-theme 'lumina-rayleigh-dark t)
The themes are plain deftheme files with no dependency. Each one sets
about 3 000 faces: the core interface, built-in modes and over 150
packages (org and org-modern, magit, vertico, corfu, company, consult,
marginalia, embark, treemacs, dirvish, lsp-mode, eglot, tree-sitter,
flycheck, flymake, meow, evil, vterm, mu4e, elfeed, markdown, web-mode,
doom-modeline, transient, which-key, avy and more). Faces of packages
you do not use are simply ignored.
Commands (after (require 'lumina-themes)):
| Command | Effect |
|---|---|
lumina-themes-select |
pick a Lumina theme with completion |
lumina-themes-toggle |
switch between the dark and light variant of the current flavor |
lumina-themes-load-random |
load a random Lumina theme (C-u: dark only, C-u C-u: light only) |
lumina-themes-reapply |
re-apply the options below after changing them |
Options, set before loading a theme:
(setq lumina-themes-italic-comments t) ; italic comments (default)
(setq lumina-themes-italic-types nil) ; italic type names
(setq lumina-themes-bold-keywords nil) ; bold instead of semi-bold keywords
(setq lumina-themes-brighter-comments nil) ; comments at the docstring contrast
(setq lumina-themes-comment-bg nil) ; tinted background behind comments
(setq lumina-themes-padded-modeline nil) ; t, or a padding width in pixels
Requires Neovim 0.8 or later with true colours (termguicolors, on by
default since Neovim 0.10 in terminals that support it). The
colorschemes are written in Lua; Vim is not supported.
lazy.nvim:
{
"RazikSF/lumina-themes",
lazy = false,
priority = 1000,
config = function()
vim.cmd.colorscheme("lumina-rayleigh-dark")
end,
}
vim-plug: Plug 'RazikSF/lumina-themes', then
colorscheme lumina-rayleigh-dark.
:colorscheme lumina picks the flavor named by vim.g.lumina_flavor
(Rayleigh when it is unset), dark or light after background.
Each colorscheme sets about 1 600 highlight groups: the interface, tree-sitter captures, LSP semantic tokens, diagnostics, the terminal colours and some 40 plugins (telescope, fzf-lua, snacks, nvim-tree, neo-tree, oil, nvim-cmp, blink.cmp, gitsigns, neogit, diffview, flash, leap, noice, which-key, trouble, lazy, mason, dap-ui, neotest, render-markdown, mini, bufferline, aerial and more). A lualine theme of the same name ships with each one:
require("lualine").setup({ options = { theme = "lumina-rayleigh-dark" } })
Install Lumina Themes from the Visual Studio Marketplace (VS Code) or from Open VSX (VSCodium, Cursor and other editors built on VS Code): search for Lumina Themes in the Extensions view, or run
code --install-extension RazikSF.lumina-themes
Then open the theme picker (Ctrl+K Ctrl+T, Cmd+K Cmd+T on macOS) and
choose a Lumina flavor.
config.color_scheme_dirs = { "/path/to/lumina-themes/wezterm" }
config.color_scheme = "lumina-rayleigh-dark"
The base24/ files are standard tinted-theming
schemes. Use them with tinty or
any tinted-theming template to colour your terminal, bat, fzf, btop
and the rest of your tools.
lumina-<flavor>-<dark|light>, for example lumina-rayleigh-dark or
lumina-aurora-light, in every editor. The high-contrast pair is
lumina-vitrail-dark and lumina-vitrail-light: text above 16:1,
comments above 6:1, every code colour at 7:1 or more (WCAG AAA), and
the six code colours kept apart for colour-blind readers.
The theme files are generated: please do not edit them by hand. Open an issue for a colour that lands wrong, an unreadable surface or a missing package; name the face or highlight group and attach a screenshot.
MIT.