gloam

Fifty-four terminal and editor theme design systems. Each built from a single atmospheric concept: semantic color tokens, a matched 16-color ANSI palette, and generated configs for every major terminal emulator and IDE.

Every token in every theme clears 4.5:1 contrast against its background. Not as a selling point — as a baseline.

Supported targets: VS Code · Starship · Neovim · iTerm2 · Alacritty · Kitty · WezTerm · Ghostty · tmux · Zed · Windows Terminal · Helix · IntelliJ · Oh My Posh · Sublime Text · Apple Terminal

Quick Start
Themes
- Absinthe
- Aether
- Amethyst
- Apricot
- Bamboo
- Basalt
- Bloom
- Boreal
- Brume
- Canopy
- Carmine
- Cast
- Cinder
- Cirrus
- Cobalt
- Cordovan
- Damson
- Daybook
- Dusk
- Ember
- Espresso
- Eventide
- Fern
- Fjord
- Graphite
- Iris
- Ironcast
- Kiln
- Lapis
- Lichen
- Madder
- Nacreous
- Nocturne
- Noir
- Ochre
- Overcast
- Parchment
- Petrichor
- Phosphor
- Rosewater
- Sable
- Saffron
- Seafoam
- Solano
- Stark
- Sumi
- Synthwave
- Tallow
- Tungsten
- Umbra
- Verdigris
- Verdure
- Weld
- Wisteria
Choosing a theme
Design System
Install
- Prerequisites
- VS Code
- Starship
- Neovim
- iTerm2
- tmux
- Helix
- IntelliJ / JetBrains IDEs
- Oh My Posh
- Sublime Text
- Apple Terminal
Structure
Contributing

Quick Start

npx github:marvinrichter/gloam eventide starship

Replace eventide with any theme name and starship with any target (see Install for all options).

What makes gloam different

Each theme starts with a specific atmospheric or material moment — not a color preference, but a concept with constraints. Color choices must be defensible from that concept. The four-token semantic model (primary, accent, muted, error) keeps prompt elements consistent across every theme: wherever you expect the directory, the git branch, the time — they are always in the same token role, with different colors but the same structure.

Every token in every theme clears WCAG AA 4.5:1 against its background. The generator produces all 16 format files from a single JSON source, so themes are never hand-tuned per-target. Change one value in the JSON and every format regenerates in sync.

Themes

Absinthe

La fée verte. Vintage chemistry lab, art nouveau, the forbidden liqueur glowing green in candlelight. Single-line layout — alchemical precision.

 ~/gloam   main ~2  ···························  ◇ 14:32
▸

Token	Hex	Role
primary	`#70E0A0`	absinthe green — directory, languages
accent	`#E8C848`	golden anise — git, cursor
muted	`#7A8A7A`	wormwood gray — chrome, time
error	`#E05858`	toxic warning

Background #080D0A · Foreground #D8E8D4 · Layout: single-line · Fill: · · Cursor: ▸

Design system guide →

Aether

Deep space observatory. Running code at the edge of the universe. The background holds residual violet-blue — the void between galaxies.

╭  user  ~/gloam  ⟫  main ~2  ················  ✦ 14:32
╰─⟫

Token	Hex	Role
primary	`#5EE8B8`	aurora green — directory, languages
accent	`#C084FC`	nebula violet — git, cursor
muted	`#8886B0`	cosmic dust — chrome, time
error	`#FF6B6B`	solar flare

Background #0C0B1A · Foreground #D4D8F0 · Layout: two-line box · Fill: · · Cursor: ⟫

Design system guide →

Amethyst

Purple quartz crystal grown in a dark matrix. The background is the host rock. The primary is the crystal — violet, translucent. The accent is rutile gold, mineral inclusions catching light from inside.

╭  user  ~/gloam  ⟫  main ~2  ················  ✧ 14:32
╰─⟫

Token	Hex	Role
primary	`#C084F0`	amethyst violet — directory, languages
accent	`#E8B84A`	rutile gold inclusions — git, cursor
muted	`#9080A8`	shadow purple — chrome, time
error	`#E05858`	fault

Background #0C0811 · Foreground #EAD8F8 · Layout: two-line box · Fill: · · Cursor: ⟫

Design system guide →

Apricot

First light through an apricot grove — the specific warm golden-peach of morning sun through fruit-laden branches, a warmth that exists for exactly twenty minutes before it becomes ordinary daylight.

  marvin  ~/gloam   main ~2  ·····················  ◯ 14:32
›

Token	Hex	Role
primary	`#7A5810`	golden amber-apricot — directory, languages
accent	`#904018`	warm amber-brown — git, cursor
muted	`#806050`	warm brown-grey — chrome, time
error	`#B01818`	deep red

Background #FDF6ED · Foreground #200E06 · Layout: single-line · Fill: · · Cursor: ›

Light theme. All tokens are dark colors on a warm cream-peach background. See apricot.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Bamboo

Hanko seal pressed in vermilion. The red stamp, not the grove. Dry ink on parchment.

 ~/gloam   main ~2  ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄  ⊛ 14:32 ›

Token	Hex	Role
primary	`#E06848`	vermilion seal — directory, languages
accent	`#80B8A0`	celadon complement — git, cursor
muted	`#888A90`	rice paper grey — chrome, time
error	`#D86060`	broken wax

Background #090C08 · Foreground #E0DDD4 · Layout: single-line · Fill: ┄ · Cursor: ›

Design system guide →

Basalt

Hawaiian lava reaching the Pacific. Black volcanic rock, white sea foam, extraordinary teal water, twenty minutes of gold before the sun drops.

[ ~/gloam ][ main ~2 +1 ]              [∎ 14:32]
▸

Token	Hex	Role
primary	`#50C8B8`	Hawaiian teal — directory, languages
accent	`#E8B040`	sunset gold — git, cursor
muted	`#7888A0`	volcanic sea-gray — chrome, time
error	`#E05858`	lava heat shimmer

Background #090A0B · Foreground #E0E4E8 · Layout: single-line · Fill: ╌ · Cursor: ▸

Design system guide →

Bloom

Pale roses pressed between book pages — blush petals drying on cream paper.

 ~/gloam   main ~2  ∵∵∵∵∵∵∵∵∵∵∵∵∵∵∵∵∵∵∵  ✽ 14:32 ›

Token	Hex	Role
primary	`#7A1840`	carmine rose — directory, languages
accent	`#5A2080`	dried plum — git, cursor
muted	`#7A5868`	dusty rose-grey — chrome, time
error	`#8A1020`	deep crimson

Background #FFF0F0 · Foreground #2A1420 · Layout: single-line · Fill: ∵ · Cursor: ›

Light theme. All tokens are dark colors on a barely-pink white background. See bloom.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Boreal

Aurora borealis — the blue-green curtain that begins at the treeline and rises until it fills the sky. The shimmering 557nm line of excited oxygen.

╭  user  ~/gloam  ›  main ~2  ···············  ✦ 14:32
╰─❯

Token	Hex	Role
primary	`#18A8C8`	aurora cyan — directory, languages
accent	`#40D0E0`	ice glow — git, cursor
muted	`#5890A0`	cold steel — chrome, time
error	`#C05868`	muted coral

Background #060A10 · Foreground #C8D8E8 · Layout: two-line box · Fill: · · Cursor: ❯

Design system guide →

Brume

The seafront before the fog burns off — everything reduced to values, the boundary between sea and sky erased.

◌ 14:32  ~/gloam  main ≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈ ›

Token	Hex	Role
primary	`#1A6068`	sea-teal — directory, languages
accent	`#1A7880`	deep teal — git, cursor
muted	`#486878`	slate — chrome, time
error	`#8A1A28`	deep crimson

Background #EEF2F0 · Foreground #1C3030 · Layout: single-line · Fill: ≈ · Cursor: ›

Light theme. All tokens are dark colors on a pale fog-gray background. See brume.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Canopy

Sunlight through a forest canopy at midday — chartreuse patches of light on dark undergrowth.

╭  ~/gloam   main ~2  ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅  ❧ 14:32
╰─❯

Token	Hex	Role
primary	`#90C860`	sunlit canopy — directory, languages
accent	`#C8A060`	filtered amber — git, cursor
muted	`#709068`	shaded undergrowth — chrome, time
error	`#D06060`	alarm red

Background #080E0A · Foreground #D4E0C8 · Layout: two-line box · Fill: ⋅ · Cursor: ❯

Design system guide →

Carmine

Cochineal pigment ground from dried insects — the oldest organic red dye, dark and mineral.

╭  ~/gloam   main ~2  ╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴╴  ◉ 14:32
╰─❯

Token	Hex	Role
primary	`#E87070`	cochineal red — directory, languages
accent	`#FFAA70`	warm coral — git, cursor
muted	`#9A7880`	muted rosewood — chrome, time
error	`#E04848`	deep alarm

Background #100808 · Foreground #F2E4E0 · Layout: two-line box · Fill: ╴ · Cursor: ❯

Design system guide →

Cast

Molten brass cooling in an industrial mould — the oxidized yellow-green that forms on the surface.

╭  ~/gloam   main ~2  ∴∴∴∴∴∴∴∴∴∴∴∴∴∴∴∴∴∴  ∅ 14:32
╰─❯

Token	Hex	Role
primary	`#C8C060`	oxidized brass — directory, languages
accent	`#D8C040`	molten surface — git, cursor
muted	`#888880`	cold casting grey — chrome, time
error	`#D06060`	heat fault

Background #101010 · Foreground #C8C8C0 · Layout: two-line box · Fill: ∴ · Cursor: ❯

Design system guide →

Cinder

Post-fire charcoal — the warm ash of a cooling fire, mineral grey and still-warm tones where embers have burned to dust.

  marvin  ~/gloam   main ~2  ·····················  ◒ 14:32
❯

Token	Hex	Role
primary	`#C0A070`	warm ash gold — directory, languages
accent	`#B08858`	ember-brown — git, cursor
muted	`#988070`	cool ash grey — chrome, time
error	`#D85040`	heat fault

Background #0D0B09 · Foreground #E4DCD0 · Layout: single-line · Fill: · · Cursor: ❯

Design system guide →

Cirrus

High-altitude ice crystal clouds at midday. Sky-white background, prussian blue sky, deep teal horizon. Cold precision. The shadows are lavender, not gray.

[ ~/gloam ][ main ~2 +1 ]·························[∘ 14:32]
›

Token	Hex	Role
primary	`#1E4888`	prussian sky blue — directory, languages
accent	`#1A7060`	deep teal at altitude — git, cursor
muted	`#506098`	lavender cloud shadow — chrome, time
error	`#882028`	danger red

Background #EEF1F6 · Foreground #181C28 · Layout: single-line · Fill: · · Cursor: ›

Light theme. All tokens are dark colors on a sky-white background. See cirrus.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Cobalt

Cobalt glass in a dark room — the specific blue of cobalt oxide, glowing with internal light.

╭  ~/gloam   main ~2  ╍╍╍╍╍╍╍╍╍╍╍╍╍╍╍╍╍╍  ⊕ 14:32
╰─❯

Token	Hex	Role
primary	`#6878F0`	royal periwinkle — directory, languages
accent	`#70D8F0`	electric cyan — git, cursor
muted	`#7888B8`	deep night blue — chrome, time
error	`#E05858`	alarm red

Background #080C18 · Foreground #D8E0F0 · Layout: two-line box · Fill: ╍ · Cursor: ❯

Design system guide →

Cordovan

A cordovan leather workshop. Two materials tell the whole story: the tan-caramel of the leather itself and the cold blue-steel of the buckles and clasps.

╭  user  ~/gloam  ❯  main ~2  ────────────────────────────  ⊕ 14:32
╰─❯

Token	Hex	Role
primary	`#C49A6A`	cordovan tan — directory, languages
accent	`#6B9AB8`	cold steel (buckles, clasps) — git, cursor
muted	`#9A7D6A`	worn leather shadow — chrome, time
error	`#D06060`	warning

Background #120A06 · Foreground #EAE0D4 · Layout: two-line box · Fill: ─ · Cursor: ❯

Design system guide →

Damson

The small oval plum that stains your fingers before you can put it down. Not quite blue, not quite red — the color that exists between violet and magenta without resolving into either.

╭─ ✦ 09:41  ~/gloam ∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙╮
╰─  main ❯

Token	Hex	Role
primary	`#D428BC`	damson skin — directory, languages
accent	`#FF60D8`	bright cerise — git, cursor
muted	`#887898`	bloom on the skin — chrome, time
error	`#C86060`	coral red

Background #090610 · Foreground #E8D8F8 · Layout: two-line box · Fill: ∙ · Cursor: ❯

Design system guide →

Daybook

A Georgian merchant's daily ledger. Cream paper ruled in faded blue, entries in dark sepia, totals and corrections in rubrication rust-red. Afternoon light through a tall window.

[ ~/my-ledger ][ main ~2 +1 ]·····················[¶ 14:32]
›

Token	Hex	Role
primary	`#284878`	ruling blue — directory, languages
accent	`#884830`	rubrication rust-red — git, cursor
muted	`#6A5E4E`	paper shadow — chrome, time
error	`#882020`	dark crimson

Background #F2EEE6 · Foreground #1E1A14 · Layout: single-line · Fill: · · Cursor: ›

Light theme. All tokens are dark colors on a cream paper background. See daybook.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Dusk

Mid-tone twilight — the sky twenty minutes after sunset, lavender-grey with the last warmth still in it.

╭  ~/gloam   main ~2  ⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰⋰  ◓ 14:32
╰─❯

Token	Hex	Role
primary	`#C490C8`	twilight lavender — directory, languages
accent	`#E8A860`	last amber — git, cursor
muted	`#9098A8`	dusk blue-grey — chrome, time
error	`#D06060`	signal red

Background #282834 · Foreground #C8C4BC · Layout: two-line box · Fill: ⋰ · Cursor: ❯

Design system guide →

Ember

The watch fire at 3am. The entire world is orange and black. The background is deep charcoal-brown — not pure black, but warm, like cooling coal.

╭  user  ~/gloam  ❯  main ~2  ················  ◈ 14:32
╰─❯

Token	Hex	Role
primary	`#FFAB40`	ember amber — directory, languages
accent	`#FF6D00`	active flame — git, cursor
muted	`#9E8E78`	smoke gray-brown — chrome, time
error	`#FF4040`	sudden flare

Background #111008 · Foreground #F5EDD4 · Layout: two-line box · Fill: · · Cursor: ❯

Design system guide →

Espresso

A pulled espresso shot — the specific dark amber-brown of coffee crema, warm and bitter, with the near-black depth of the liquid beneath.

  marvin  ~/gloam   main ~2  ·····················  ◔ 14:32
❯

Token	Hex	Role
primary	`#C87030`	crema amber — directory, languages
accent	`#E89840`	bright gold highlight — git, cursor
muted	`#A07860`	warm coffee brown — chrome, time
error	`#DC4030`	heat fault

Background #0D0906 · Foreground #F0E4D0 · Layout: single-line · Fill: · · Cursor: ❯

Design system guide →

Eventide

The moment between day and night. Deep indigo sky, warm gold navigation, twilight lavender chrome, sunset coral git.

╭  user  ~/gloam  ❯  main ~2  ────────────────────────────  ◆ 14:32
╰─❯

Token	Hex	Role
primary	`#E8B86D`	warm gold — directory, languages
accent	`#FF7F57`	sunset coral — git, cursor
muted	`#8B84C4`	twilight lavender — chrome, time
error	`#E85D5D`	aurora red

Background #0D0F1A · Foreground #F0EAD6 · Layout: two-line box · Fill: ─ · Cursor: ❯

Design system guide →

Fern

Morning light through fern fronds — soft sage-green filtering warm amber sun.

 ~/gloam   main ~2  ≀≀≀≀≀≀≀≀≀≀≀≀≀≀≀≀≀≀≀  ❄ 14:32 ›

Token	Hex	Role
primary	`#1A4A2A`	fern stem — directory, languages
accent	`#604A10`	morning amber — git, cursor
muted	`#4A5E50`	shadow leaf — chrome, time
error	`#6A1818`	deep crimson

Background #EEF2EC · Foreground #1A2E1A · Layout: single-line · Fill: ≀ · Cursor: ›

Light theme. All tokens are dark colors on a pale sage-grey background. See fern.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Fjord

Norwegian fjord at dusk. Cold deep-blue water, perfectly still. A single amber light from a distant farmhouse. No username — cold, anonymous, Nordic.

╭  ~/gloam   main ~2  ················  ∼ 14:32
╰─›

Token	Hex	Role
primary	`#6EB5E0`	ice sky blue — directory, languages
accent	`#E8C46A`	distant amber light — git, cursor
muted	`#688EAA`	fog over water — chrome, time
error	`#E06060`	warning light

Background #0A0F18 · Foreground #D4E0E8 · Layout: two-line box · Fill: · · Cursor: ›

Design system guide →

Graphite

Dry graphite on smooth paper — near-neutral, the faint mauve sheen of the pencil mark before ink replaces it.

╭  ~/gloam   main ~2  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯  ◑ 14:32
╰─❯

Token	Hex	Role
primary	`#C4B8C8`	graphite mauve — directory, languages
accent	`#D8C8A0`	pale gold — git, cursor
muted	`#808888`	graphite shadow — chrome, time
error	`#D06060`	alarm red

Background #0C0C0C · Foreground #E0E0E0 · Layout: two-line box · Fill: ⋯ · Cursor: ❯

Design system guide →

Iris

The heart of a Siberian iris in July — a violet so saturated it seems to vibrate. The yellow-orange signal patch of the falls against absolute darkness.

╭  user  ~/gloam  ›  main ~2  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯  ✦ 14:32
╰─❯

Token	Hex	Role
primary	`#9060E0`	iris violet — directory, languages
accent	`#B088F8`	bright iris — git, cursor
muted	`#8070B0`	violet-gray — chrome, time
error	`#D06868`	warm red

Background #08060E · Foreground #E0D8F8 · Layout: two-line box · Fill: ⋯ · Cursor: ❯

Design system guide →

Ironcast

Cast iron under a pre-storm sky — the cold blue-grey of heavy cloud seen through a foundry window.

╭  ~/gloam   main ~2  ══════════════════  ▪ 14:32
╰─❯

Token	Hex	Role
primary	`#78A8C8`	storm sky blue — directory, languages
accent	`#C8D838`	acid yellow — git, cursor
muted	`#7090A8`	cold iron grey — chrome, time
error	`#D06060`	danger signal

Background #0B0D10 · Foreground #CDD4DC · Layout: two-line box · Fill: ═ · Cursor: ❯

Design system guide →

Kiln

A wood-firing kiln at peak temperature — the specific deep red-orange of ceramic clay at cone 10, the surface just before vitrification.

╭  marvin  ~/gloam   main ~2  ────────────────────────  ⊡ 14:32
╰─❯

Token	Hex	Role
primary	`#E05830`	fired clay red — directory, languages
accent	`#F08040`	kiln glow orange — git, cursor
muted	`#A87060`	terracotta shadow — chrome, time
error	`#DC4030`	overfired fault

Background #100908 · Foreground #F2E0D0 · Layout: two-line box · Fill: ─ · Cursor: ❯

Design system guide →

Lapis

Lapis lazuli ground to pigment — the ultramarine blue of medieval manuscripts, dense and mineral, the most expensive color in history.

╭  marvin  ~/gloam   main ~2  ·····················  ✸ 14:32
╰─❯

Token	Hex	Role
primary	`#5078F0`	ultramarine — directory, languages
accent	`#6090FF`	bright cobalt — git, cursor
muted	`#6878A8`	mineral blue-grey — chrome, time
error	`#E84040`	vermilion contrast

Background #060810 · Foreground #D0D8F0 · Layout: two-line box · Fill: · · Cursor: ❯

Design system guide →

Lichen

Crustose lichen on a granite boulder — the specific grey-green of lichen growth, mineral grey as the substrate, the quiet organic spread of something very slow and very old.

╭  marvin  ~/gloam   main ~2  ·····················  ∴ 14:32
╰─❯

Token	Hex	Role
primary	`#759075`	sage-green-grey — directory, languages
accent	`#90B878`	lighter lichen — git, cursor
muted	`#708868`	grey-green chrome — chrome, time
error	`#C07060`	terracotta-red

Background #0A0D0B · Foreground #D8E0D4 · Layout: two-line box · Fill: · · Cursor: ❯

Design system guide →

Madder

The dye vat at a medieval cloth workshop — Rubia tinctorum in water. The oldest cultivated red. Not vermilion — garnet, the cooler red with violet in it.

╭  user  ~/gloam  ›  main ~2  ╼╼╼╼╼╼╼╼╼╼╼╼╼╼╼╼╼  ✶ 14:32
╰─❯

Token	Hex	Role
primary	`#E04060`	garnet crimson — directory, languages
accent	`#F07898`	bright rose — git, cursor
muted	`#B08098`	dusty pink — chrome, time
error	`#E04848`	warm red

Background #0E0608 · Foreground #F0E0E8 · Layout: two-line box · Fill: ╼ · Cursor: ❯

Design system guide →

Nacreous

Iridescent nacreous clouds, 15–25 km above the polar surface. Teal-green shifting to pink, like oil on cold water. Only visible in polar winter, before sunrise.

╭  marvin  ~/gloam   main ~2 +1  ················  ✧ 14:32
╰─⟫

Token	Hex	Role
primary	`#78D8C8`	nacreous teal-green — directory, languages
accent	`#E890C8`	nacreous pink — git, cursor
muted	`#8888A8`	ice fog — chrome, time
error	`#E06868`	warning red

Background #0B0C10 · Foreground #E4E8F0 · Layout: two-line box · Fill: · · Cursor: ⟫

Design system guide →

Nocturne

Chopin at night. Candlelight on ivory keys, blood-red velvet curtain, the piano warm from decades of low light. Everything played pianissimo.

╭  marvin  ~/gloam   main ~2 +1  ──────────────  ○ 14:32
╰─❯

Token	Hex	Role
primary	`#E0D0A8`	candlelight ivory — directory, languages
accent	`#D05A6A`	blood-red velvet — git, cursor
muted	`#848080`	candlesmoke gray — chrome, time
error	`#E04848`	hot candleflame

Background #100A0C · Foreground #EEE8E0 · Layout: two-line box · Fill: ─ · Cursor: ❯

Design system guide →

Noir

A single incandescent bulb in a dark room — film noir, warm gold light, hard shadows.

 ~/gloam   main ~2  ∶∶∶∶∶∶∶∶∶∶∶∶∶∶∶∶∶∶∶  ● 14:32 ›

Token	Hex	Role
primary	`#E8D080`	incandescent gold — directory, languages
accent	`#E89048`	warm amber — git, cursor
muted	`#909090`	shadow grey — chrome, time
error	`#D06060`	alarm

Background #0A0A0A · Foreground #E8E0D0 · Layout: single-line · Fill: ∶ · Cursor: ›

Design system guide →

Ochre

Dawn on mesa rock. The moment the first light hits iron oxide and turns the cliffs to fire.

 ~/gloam  main ~2  ···············  ◌ 14:32 ›

Token	Hex	Role
primary	`#722018`	iron oxide red — directory, languages
accent	`#1A6068`	deep teal — git, cursor
muted	`#705040`	weathered sienna — chrome, time
error	`#7A1828`	deep crimson

Background #F2E4D0 · Foreground #220E08 · Layout: single-line · Fill: · · Cursor: ›

Light theme. All tokens are dark colors on a warm sandstone background. See ochre.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Overcast

An overcast November morning — the specific diffuse silver-grey of total cloud cover, the light that has no direction, no shadow, no warmth.

╭  marvin  ~/gloam   main ~2  ──────────────────────────  ◦ 14:32
╰─❯

Token	Hex	Role
primary	`#4040C8`	pure blue — directory, languages
accent	`#3060C8`	mid blue — git, cursor
muted	`#505870`	blue-grey — chrome, time
error	`#C02030`	warm red

Background #F0F2F5 · Foreground #181C28 · Layout: two-line box · Fill: ─ · Cursor: ❯

Light theme. All tokens are dark colors on a cool grey background. See overcast.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Parchment

Aged vellum. The material monks copied manuscripts onto. Iron gall ink as primary. Rust-brown as accent. The only light theme in the set — everything inverts.

 ~/gloam   main ~2  ···························  § 14:32
›

Token	Hex	Role
primary	`#4A2E12`	iron gall ink — directory, languages
accent	`#7A3A10`	rust-brown (second ink) — git, cursor
muted	`#6B5A48`	faded ink — chrome, time
error	`#8B2020`	dark crimson

Background #E8D6B4 · Foreground #2A1E12 · Layout: single-line · Fill: · · Cursor: ›

Light theme. All tokens are dark colors on a warm cream background. See parchment.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Petrichor

The smell of rain on dry earth, one minute before it falls. Grass green ground, ozone electric sky, the tension between cool charge and warm earth.

[ ~/gloam ][ main ~2 +1 ]─────────────────────[∼ 14:32]
›

Token	Hex	Role
primary	`#78C888`	new grass green — directory, languages
accent	`#58C8D8`	ozone electric blue — git, cursor
muted	`#78806A`	dry earth surface — chrome, time
error	`#D05858`	storm warning red

Background #0A0C0A · Foreground #D8DCCC · Layout: single-line · Fill: ─ · Cursor: ›

Design system guide →

Phosphor

A CRT phosphor screen — the specific green of early computer monitors, the glow that defined a generation of computing before color screens existed.

  marvin  ~/gloam   main ~2  ────────────────────  ▸ 14:32
▸

Token	Hex	Role
primary	`#00D848`	phosphor green — directory, languages
accent	`#40FF80`	bright phosphor — git, cursor
muted	`#50A860`	dim phosphor — chrome, time
error	`#FF4040`	alarm red

Background #040804 · Foreground #C0E8B8 · Layout: single-line · Fill: ─ · Cursor: ▸

Design system guide →

Rosewater

Rosewater after distillation — the exact pink before it evaporates, floral and fading.

╭  ~/gloam   main ~2  ≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈≈  ✿ 14:32
╰─❯

Token	Hex	Role
primary	`#E868A0`	rose petal pink — directory, languages
accent	`#C8A0D8`	pale lilac — git, cursor
muted	`#9A7890`	dusty mauve — chrome, time
error	`#D06060`	alarm red

Background #100A0F · Foreground #F0E0E8 · Layout: two-line box · Fill: ≈ · Cursor: ❯

Design system guide →

Sable

The heraldic color — black, pure and absolute. Silver and gold on black. No box frames. No decorative chrome. The prompt exists because it must.

 ~/gloam   main ~2                               · 14:32
›

Token	Hex	Role
primary	`#C0C8D4`	brushed silver — directory, languages
accent	`#D4AA6A`	champagne gold — git, cursor
muted	`#7A8294`	iron gray — chrome, time
error	`#D44848`	crimson

Background #080808 · Foreground #E8E8E8 · Layout: single-line · Fill: · Cursor: ›

Design system guide →

Saffron

Morning spice market. Saffron cloth, indigo dye pots, the hour before the light becomes merciless.

╭  ~/gloam   main ~2  ──────────────────────────  ◈ 14:32
╰─❯

Token	Hex	Role
primary	`#5E3008`	dark amber — directory, languages
accent	`#3A2880`	indigo — git, cursor
muted	`#806040`	warm sienna — chrome, time
error	`#802028`	deep crimson

Background #FAF0D8 · Foreground #281808 · Layout: two-line box · Fill: ─ · Cursor: ❯

Light theme. All tokens are dark colors on a pale saffron background. See saffron.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Seafoam

Seafoam on wet pebbles at low tide — the specific pale green-white of foam just before it recedes, mineral and cool.

  marvin  ~/gloam   main ~2  ·····················  ⬦ 14:32
›

Token	Hex	Role
primary	`#1A7858`	sea-green — directory, languages
accent	`#166870`	deep teal — git, cursor
muted	`#406060`	tide-pool grey-green — chrome, time
error	`#C83820`	deep red

Background #EEF5F2 · Foreground #101E18 · Layout: single-line · Fill: · · Cursor: ›

Light theme. All tokens are dark colors on a pale sea-green background. See seafoam.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Solano

High desert at midday. Bleached adobe walls, terracotta rooftiles, ink-shadow, deep Pacific blue.

 ~/gloam  main ~2  ∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿  ☀ 14:32 ›

Token	Hex	Role
primary	`#782010`	terracotta red — directory, languages
accent	`#1A4A7A`	Pacific blue — git, cursor
muted	`#7A5C40`	adobe tan — chrome, time
error	`#8B1A2A`	deep crimson

Background #F5EDE0 · Foreground #2A1C10 · Layout: single-line · Fill: ∿ · Cursor: ›

Light theme. All tokens are dark colors on a warm cream background. See solano.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Stark

Absolute contrast — white page, deep navy ink. No atmospheric reference. Pure signal.

╭  ~/gloam   main ~2  ┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅  ⊞ 14:32
╰─❯

Token	Hex	Role
primary	`#001A8C`	deep navy — directory, languages
accent	`#8C3000`	dark burnt orange — git, cursor
muted	`#3A3A3A`	near-black — chrome, time
error	`#8C0010`	dark crimson

Background #FFFFFF · Foreground #000000 · Layout: two-line box · Fill: ┅ · Cursor: ❯

Light theme. Maximum contrast — very dark tokens on pure white. See stark.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Sumi

Sumi-e ink wash — the deep indigo-purple where pigment pools, the pale wash where it spreads.

 ~/gloam   main ~2  ∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷  ◎ 14:32 ›

Token	Hex	Role
primary	`#8878C8`	ink wash indigo — directory, languages
accent	`#7898B8`	diluted wash — git, cursor
muted	`#788090`	dry paper grey — chrome, time
error	`#D05858`	red pigment

Background #0A0B0D · Foreground #D8D0C0 · Layout: single-line · Fill: ∷ · Cursor: ›

Design system guide →

Synthwave

Neon grids and chrome reflections in a rain-slicked midnight arcade.

╭  ~/gloam   main ~2  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  ⬡ 14:32
╰─⟫

Token	Hex	Role
primary	`#FF60C8`	neon magenta — directory, languages
accent	`#40E8E0`	neon cyan — git, cursor
muted	`#9070C8`	monitor glow — chrome, time
error	`#FF4070`	hot alarm

Background #0D0818 · Foreground #F0E8FF · Layout: two-line box · Fill: ▒ · Cursor: ⟫

Design system guide →

Tallow

Tallow candle burning low — amber light pooling soft on worn wooden surfaces.

 ~/gloam   main ~2  ⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿  ◐ 14:32 ›

Token	Hex	Role
primary	`#E8C888`	candlelight cream — directory, languages
accent	`#D4905A`	terracotta ember — git, cursor
muted	`#9A8870`	worn wood — chrome, time
error	`#D86060`	hot coal

Background #120E08 · Foreground #F0E8D8 · Layout: single-line · Fill: ⠿ · Cursor: ›

Design system guide →

Tungsten

Tungsten filament at operating temperature — past orange, almost white but holding onto gold. The primary is the filament's light. The accent is the oscilloscope watching it.

 ~/gloam   main ~2  ····················  ⋄ 14:32
▸

Token	Hex	Role
primary	`#F0D890`	filament white-gold — directory, languages
accent	`#5A90C8`	scientific blue — git, cursor
muted	`#887A60`	warm gray — chrome, time
error	`#E05858`	fault indicator

Background #0E0C09 · Foreground #F4EED8 · Layout: single-line · Fill: · · Cursor: ▸

Design system guide →

Umbra

The penumbra — the partial shadow at the edge of total darkness. A mathematical concept made visible. Pale morning blue at the boundary. Amethyst violet — the color of transition.

 ~/gloam   main ~2  ·····················  · 14:32
▹

Token	Hex	Role
primary	`#A0B4C8`	pale morning blue — directory, languages
accent	`#8B6CF0`	amethyst violet — git, cursor
muted	`#728090`	shadow slate — chrome, time
error	`#DC5858`	crimson

Background #070708 · Foreground #E4E8F0 · Layout: single-line · Fill: · · Cursor: ▹

Design system guide →

Verdigris

Ancient bronze turned sea-green by time and salt air. The color of old statues, copper rooftops, oxidized piping. Two materials: the teal patina and the bronze beneath.

╭  user  ~/gloam  ›  main ~2  ────────────────────────────  ⌘ 14:32
╰─›

Token	Hex	Role
primary	`#52C4A8`	verdigris teal — directory, languages
accent	`#CD8B4A`	bronze copper — git, cursor
muted	`#7A9490`	patina gray — chrome, time
error	`#D46060`	oxidation red

Background #0D1210 · Foreground #D4E0D8 · Layout: two-line box · Fill: ─ · Cursor: ›

Design system guide →

Verdure

The first green of April — wet grass in morning light. Not the settled green of summer. The electric, almost aggressive green of things that have just emerged from the ground.

╭  user  ~/gloam  ›  main ~2  ∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿∿  ❧ 14:32
╰─❯

Token	Hex	Role
primary	`#60C848`	spring green — directory, languages
accent	`#90E060`	vivid lime — git, cursor
muted	`#709048`	olive — chrome, time
error	`#D06060`	warm red

Background #080E08 · Foreground #D0E0C0 · Layout: two-line box · Fill: ∿ · Cursor: ❯

Design system guide →

Weld

Molten metal oxidizing — yellow-green flame at the seam where steel fuses.

╭  ~/gloam   main ~2  ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡  ⬢ 14:32
╰─❯

Token	Hex	Role
primary	`#98B838`	oxidation flame — directory, languages
accent	`#E8B040`	molten amber — git, cursor
muted	`#909060`	cooled oxide — chrome, time
error	`#D06060`	heat fault

Background #0E0E08 · Foreground #E8E0C0 · Layout: two-line box · Fill: ≡ · Cursor: ❯

Design system guide →

Wisteria

Wisteria draped over a pergola in May — the pale lavender, the warm light through papery petals. The purple that doesn't resolve.

✿ 14:32  ~/gloam  main ·················· ›

Token	Hex	Role
primary	`#4828A0`	iris violet — directory, languages
accent	`#782870`	plum — git, cursor
muted	`#4A3868`	dark violet-gray — chrome, time
error	`#882020`	deep crimson

Background #F4F0F8 · Foreground #2A1A40 · Layout: single-line · Fill: · · Cursor: ›

Light theme. All tokens are dark colors on a pale lavender background. See wisteria.md for light theme setup notes — iTerm2 requires one additional setting.

Design system guide →

Choosing a theme

All 54 themes share the same structural model — four semantic tokens, 16-color ANSI palette, identical targets. The differences are concept, color temperature, and prompt layout.

By color temperature

Warm (golds, ambers, reds)	Cool (blues, teals, purples)	Neutral (grays, yellows)
Eventide, Ember, Cordovan, Nocturne	Aether, Fjord, Basalt, Verdigris	Tungsten, Sable, Umbra, Absinthe
Solano, Saffron, Ochre, Tallow	Nacreous, Petrichor, Amethyst, Cobalt	Noir, Cast, Graphite, Weld
Bamboo, Carmine, Rosewater, Madder	Ironcast, Sumi, Synthwave, Dusk	Stark, Cinder
Bloom, Apricot, Espresso, Kiln	Boreal, Iris, Damson, Canopy, Cirrus	Phosphor, Lichen
	Fern, Brume, Wisteria, Verdure, Seafoam
	Lapis, Overcast

By background type

Dark themes	Light themes
Eventide, Aether, Ember, Absinthe, Verdigris	Parchment, Daybook, Cirrus
Sable, Fjord, Umbra, Cordovan, Tungsten	Solano, Saffron, Ochre
Amethyst, Nacreous, Petrichor, Nocturne, Basalt	Bloom, Fern, Stark
Bamboo, Canopy, Carmine, Cast, Cobalt	Brume, Wisteria, Apricot
Dusk, Graphite, Ironcast, Noir, Rosewater	Overcast, Seafoam
Sumi, Synthwave, Tallow, Weld, Madder
Boreal, Verdure, Iris, Damson
Espresso, Kiln, Lapis, Lichen, Cinder, Phosphor

By prompt layout

Two-line box (`╭╰─`)	Single-line (no frame)
Eventide, Ember, Verdigris, Fjord	Absinthe, Sable, Umbra, Tungsten
Cordovan, Amethyst, Nacreous, Nocturne	Parchment, Petrichor, Basalt, Daybook
Saffron, Aether, Canopy, Carmine	Cirrus, Solano, Ochre, Bamboo
Cast, Cobalt, Dusk, Graphite	Bloom, Fern, Noir, Sumi
Ironcast, Rosewater, Stark, Synthwave	Tallow, Brume, Wisteria
Weld, Boreal, Iris, Madder, Verdure, Damson	Apricot, Cinder, Espresso
Kiln, Lapis, Lichen, Overcast	Phosphor, Seafoam

Picking a light theme

All fourteen light themes use dark tokens on a light background. Key differences:

Theme	Background	Primary	Feel
Parchment	`#E8D6B4` old paper	`#4A2E12` dark brown	antique manuscript
Daybook	`#F2EEE6` cream	`#284878` navy	ruled notebook
Cirrus	`#EEF1F6` sky white	`#1E4888` steel blue	high altitude, minimal
Solano	`#F5EDE0` adobe	`#782010` terracotta	high desert midday
Saffron	`#FAF0D8` pale gold	`#5E3008` dark amber	morning spice market
Ochre	`#F2E4D0` sandstone	`#722018` iron oxide	dawn on mesa rock
Bloom	`#FFF0F0` barely-pink white	`#7A1840` carmine rose	pressed rose petals
Fern	`#EEF2EC` pale sage-grey	`#1A4A2A` fern stem	woodland morning
Stark	`#FFFFFF` pure white	`#001A8C` deep navy	pure contrast, no atmosphere
Brume	`#EEF2F0` fog gray	`#1A6068` sea-teal	coastal mist, values only
Wisteria	`#F4F0F8` pale lavender	`#4828A0` iris violet	wisteria in bloom
Apricot	`#FDF6ED` warm cream-peach	`#7A5810` golden amber	first light through a grove
Overcast	`#F0F2F5` cool grey	`#4040C8` pure blue	overcast November morning
Seafoam	`#EEF5F2` pale sea-green	`#1A7858` sea-green	seafoam at low tide

All light themes require one extra iTerm2 setting: uncheck Use bright colors for bold text (Preferences › Profiles › Colors).

Design System

All themes share the same four-token architecture:

primary   ← directory path, language badges
accent    ← git branch/status, prompt character, cursor
muted     ← username, time, structural chrome (box corners)
error     ← fail state only

Structural and layout choices vary per theme:

Theme	Layout	Box frame	Fill	Prompt
Absinthe	single-line	—	`·`	`▸`
Aether	two-line	`╭╰─`	`·`	`⟫`
Amethyst	two-line	`╭╰─`	`·`	`⟫`
Apricot	single-line	—	`·`	`›`
Bamboo	single-line	—	`┄`	`›`
Basalt	single-line	—	`╌`	`▸`
Bloom	single-line	—	`∵`	`›`
Boreal	two-line	`╭╰─`	`·`	`❯`
Brume	single-line	—	`≈`	`›`
Canopy	two-line	`╭╰─`	`⋅`	`❯`
Carmine	two-line	`╭╰─`	`╴`	`❯`
Cast	two-line	`╭╰─`	`∴`	`❯`
Cinder	single-line	—	`·`	`❯`
Cirrus	single-line	—	`·`	`›`
Cobalt	two-line	`╭╰─`	`╍`	`❯`
Cordovan	two-line	`╭╰─`	`─`	`❯`
Damson	two-line	`╭╰─`	`∙`	`❯`
Daybook	single-line	—	`·`	`›`
Dusk	two-line	`╭╰─`	`⋰`	`❯`
Ember	two-line	`╭╰─`	`·`	`❯`
Espresso	single-line	—	`·`	`❯`
Eventide	two-line	`╭╰─`	`─`	`❯`
Fern	single-line	—	`≀`	`›`
Fjord	two-line	`╭╰─`	`·`	`›`
Graphite	two-line	`╭╰─`	`⋯`	`❯`
Iris	two-line	`╭╰─`	`⋯`	`❯`
Ironcast	two-line	`╭╰─`	`═`	`❯`
Kiln	two-line	`╭╰─`	`─`	`❯`
Lapis	two-line	`╭╰─`	`·`	`❯`
Lichen	two-line	`╭╰─`	`·`	`❯`
Madder	two-line	`╭╰─`	`╼`	`❯`
Nacreous	two-line	`╭╰─`	`·`	`⟫`
Nocturne	two-line	`╭╰─`	`─`	`❯`
Noir	single-line	—	`∶`	`›`
Ochre	single-line	—	`·`	`›`
Overcast	two-line	`╭╰─`	`─`	`❯`
Parchment	single-line	—	`·`	`›`
Petrichor	single-line	—	`─`	`›`
Phosphor	single-line	—	`─`	`▸`
Rosewater	two-line	`╭╰─`	`≈`	`❯`
Sable	single-line	—		`›`
Saffron	two-line	`╭╰─`	`─`	`❯`
Seafoam	single-line	—	`·`	`›`
Solano	single-line	—	`∿`	`›`
Stark	two-line	`╭╰─`	`┅`	`❯`
Sumi	single-line	—	`∷`	`›`
Synthwave	two-line	`╭╰─`	`▒`	`⟫`
Tallow	single-line	—	`⠿`	`›`
Tungsten	single-line	—	`·`	`▸`
Umbra	single-line	—	`·`	`▹`
Verdigris	two-line	`╭╰─`	`─`	`›`
Verdure	two-line	`╭╰─`	`∿`	`❯`
Weld	two-line	`╭╰─`	`≡`	`❯`
Wisteria	single-line	—	`·`	`›`

Each theme's JSON file is the single source of truth. The generator produces all 16 format files from it.

Install

npx github:marvinrichter/gloam <theme> <target>

The installer copies the theme config and wires it into your existing config file — no clone required.

Themes: absinthe · aether · amethyst · apricot · bamboo · basalt · bloom · boreal · brume · canopy · carmine · cast · cinder · cirrus · cobalt · cordovan · damson · daybook · dusk · ember · espresso · eventide · fern · fjord · graphite · iris · ironcast · kiln · lapis · lichen · madder · nacreous · nocturne · noir · ochre · overcast · parchment · petrichor · phosphor · rosewater · sable · saffron · seafoam · solano · stark · sumi · synthwave · tallow · tungsten · umbra · verdigris · verdure · weld · wisteria

Targets: vscode · starship · neovim · alacritty · kitty · wezterm · ghostty · tmux · zed · windows-terminal · helix

Install all themes to one target at once:

npx github:marvinrichter/gloam all starship

Prerequisites

JetBrains Mono Nerd Font — required for all Nerd Font glyphs (language symbols, git icon):

brew install --cask font-jetbrains-mono-nerd-font

VS Code

After running the installer, reload VS Code (Cmd+Shift+P → Reload Window) and select the theme via Cmd+K Cmd+T.

Starship

Install Starship and add the init line to your shell config once:

brew install starship
echo 'eval "$(starship init zsh)"' >> ~/.zshrc    # zsh
echo 'eval "$(starship init bash)"' >> ~/.bashrc  # bash

Then install the theme:

npx github:marvinrichter/gloam eventide starship

The Starship config and iTerm2 theme are a pair. Using one without the other will work, but ANSI-based syntax highlighting (ls, git log, grep) will not harmonize with the prompt.

Neovim

After running the installer, add to init.lua:

vim.cmd("colorscheme <name>")

iTerm2 — manual import

The installer does not support iTerm2. Import manually:

Preferences › Profiles › Colors › Color Presets ▾ › Import…
Select themes/<name>/iterm2.itermcolors
Color Presets ▾ → select the imported theme name

Light themes only: uncheck Use bright colors for bold text (Preferences › Profiles › Colors). Without this, bold text is invisible against the light background. Applies to: Parchment, Daybook, Cirrus, Solano, Saffron, Ochre, Bloom, Fern, Stark, Brume, Wisteria.

tmux

npx github:marvinrichter/gloam eventide tmux

The installer adds a source-file line to ~/.tmux.conf. Reload with:

tmux source-file ~/.tmux.conf

Helix

npx github:marvinrichter/gloam eventide helix

The installer copies helix.toml to ~/.config/helix/themes/<name>.toml. Add to ~/.config/helix/config.toml:

theme = "<name>"

IntelliJ / JetBrains IDEs — manual import

The installer does not support IntelliJ. Import manually:

Settings › Editor › Color Scheme › ⚙ › Import Scheme

Select themes/<name>/intellij.icls.

Oh My Posh — manual copy

Copy the generated file to the Oh My Posh themes directory:

cp themes/<name>/oh-my-posh.omp.json ~/.config/oh-my-posh/themes/<name>.omp.json

Then configure your shell to use it:

eval "$(oh-my-posh init zsh --config ~/.config/oh-my-posh/themes/<name>.omp.json)"

Sublime Text — manual copy

Copy the generated file to your Sublime Text packages:

cp themes/<name>/sublime-text.sublime-color-scheme \
   ~/Library/Application\ Support/Sublime\ Text/Packages/User/

Then select via Preferences › Color Scheme… → <name>.

Apple Terminal — manual import

The installer does not support Apple Terminal directly. Import manually:

Terminal › Preferences › Profiles › ⚙ › Import…
Select themes/<name>/terminal.terminal
Select the imported profile from the list and click Default

All light themes: uncheck Use bright colors for bold text in the imported profile.

Structure

gloam/
├── README.md
├── package.json               npm test / npm run generate / npx entrypoint
├── docs/                      GitHub Pages
│   ├── index.html
│   ├── brand-guidelines.md
│   └── assets/
│       └── tokens.css
├── themes/
│   └── eventide/              one directory per theme
│       ├── eventide.json      machine-readable source of truth
│       ├── eventide.md        design system guide
│       ├── starship.toml      generated
│       ├── iterm2.itermcolors generated
│       ├── alacritty.toml     generated
│       ├── kitty.conf         generated
│       ├── wezterm.lua        generated
│       ├── ghostty            generated
│       ├── windows-terminal.json  generated
│       ├── vscode.json        generated
│       ├── neovim.lua         generated
│       ├── intellij.icls      generated
│       ├── zed.json           generated
│       ├── helix.toml         generated
│       ├── tmux.conf          generated
│       ├── terminal.terminal  generated
│       ├── oh-my-posh.omp.json generated
│       └── sublime-text.sublime-color-scheme  generated
└── scripts/
    ├── install.js             theme installer — `npx github:marvinrichter/gloam`
    ├── generate.js            regenerate all formats from theme JSON files
    ├── generators/            one module per output format
    │   ├── starship.js
    │   ├── iterm2.js
    │   ├── alacritty.js
    │   ├── kitty.js
    │   ├── wezterm.js
    │   ├── ghostty.js
    │   ├── windows-terminal.js
    │   ├── vscode.js
    │   ├── neovim.js
    │   ├── intellij.js
    │   ├── zed.js
    │   ├── helix.js
    │   ├── tmux.js
    │   ├── terminal-app.js
    │   ├── oh-my-posh.js
    │   ├── sublime-text.js
    │   ├── syntax-map.js      shared syntax token → IDE role mapping
    │   └── utils.js           hex/float color utilities
    └── __tests__/             TDD test suite (node:test)

Troubleshooting

Glyphs display as boxes or question marks

The Nerd Font glyphs (language badges, git icon) require JetBrains Mono Nerd Font. Install it and set it as your terminal font:

brew install --cask font-jetbrains-mono-nerd-font

Then set JetBrainsMono Nerd Font (exact name) as your terminal's font family.

Colors look wrong or desaturated

Verify your terminal's color profile is set to sRGB. On iTerm2: Preferences › Profiles › Colors — ensure "Color Space" is sRGB. On macOS, desaturation can occur when the display profile is set to Display P3 without color management in the terminal.

Starship config not loading

Check that the init line is in your shell config and that you have reloaded the shell:

# Verify the init line is present
grep starship ~/.zshrc     # or ~/.bashrc

# Reload
source ~/.zshrc

The installer copies starship.toml to ~/.config/starship.toml. If $STARSHIP_CONFIG is set, it must point to that path.

iTerm2 theme imported but not applied

After import, the theme must be explicitly selected: Preferences › Profiles › Colors › Color Presets ▾ → select the theme name. Import and selection are separate steps.

Contrast looks different on different displays

gloam themes are calibrated for sRGB displays at typical brightness (200–300 nits). High-brightness displays and wide-gamut (P3) profiles can shift perceived contrast. The WCAG 4.5:1 guarantee holds under sRGB conditions. If a token looks low-contrast on your display, check display calibration before filing an issue.

Light theme looks wrong in iTerm2

Uncheck Use bright colors for bold text in Preferences › Profiles › Colors. Without this, bold text is invisible against the light background. This applies to all eleven light themes: Parchment, Daybook, Cirrus, Solano, Saffron, Ochre, Bloom, Fern, Stark, Brume, Wisteria.

Contributing

See CONTRIBUTING.md for setup, theme requirements, and the PR process.

Questions and security

Questions and support: SUPPORT.md
Security vulnerabilities: SECURITY.md — do not open a public issue for security reports

Name		Name	Last commit message	Last commit date
Latest commit History 35 Commits
.githooks		.githooks
.github		.github
docs		docs
scripts		scripts
themes		themes
.editorconfig		.editorconfig
.gitignore		.gitignore
.markdownlint.yaml		.markdownlint.yaml
.npmignore		.npmignore
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
SUPPORT.md		SUPPORT.md
eslint.config.js		eslint.config.js
package-lock.json		package-lock.json
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

gloam

Contents

Quick Start

What makes gloam different

Themes

Absinthe

Aether

Amethyst

Apricot

Bamboo

Basalt

Bloom

Boreal

Brume

Canopy

Carmine

Cast

Cinder

Cirrus

Cobalt

Cordovan

Damson

Daybook

Dusk

Ember

Espresso

Eventide

Fern

Fjord

Graphite

Iris

Ironcast

Kiln

Lapis

Lichen

Madder

Nacreous

Nocturne

Noir

Ochre

Overcast

Parchment

Petrichor

Phosphor

Rosewater

Sable

Saffron

Seafoam

Solano

Stark

Sumi

Synthwave

Tallow

Tungsten

Umbra

Verdigris

Verdure

Weld

Wisteria

Choosing a theme

By color temperature

By background type

By prompt layout

Picking a light theme

Design System

Install

Prerequisites

VS Code

Starship

Neovim

iTerm2 — manual import

tmux

Helix

IntelliJ / JetBrains IDEs — manual import

Oh My Posh — manual copy

Sublime Text — manual copy

Packages