RazikSF/lumina-themes

github github
colorscheme
stars 3
issues 0
subscribers 0
forks 0
CREATED

UPDATED


Lumina

License: MIT VS Code: Marketplace VSCodium ยท Cursor: Open VSX

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.

  • Easy on the eyes. Soft text, tinted by the background.
  • Readable by everyone. Every colour stays legible and distinct, colour-blind readers included.
  • The same everywhere. One design in every editor, and in over 150 Emacs packages.

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.

Flavors

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.

Gallery

Rayleigh

Cherenkov

Quartz

Olive

Dusk

Oxblood

Lagoon

Ember

Canopy

Harbor

Espresso

Aurora

Parchment

Nebula

Polaire

Vitrail

Install

Emacs

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

Neovim

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" } })

VS Code

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.

WezTerm

config.color_scheme_dirs = { "/path/to/lumina-themes/wezterm" }
config.color_scheme = "lumina-rayleigh-dark"

Terminals and other tools: base24

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.

Names

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.

Contributing

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.

License

MIT.