Angrboða is expressive without shouting and calm without disappearing. Its ember-red and spectral-violet accents sit on a neutral foundation tuned for long sessions. Dark and light modes share one typed source palette, with measured contrast for ordinary text and consistent generated ports.

Install

VS Code and Cursor

Install carlssonloke.angrboda from the VS Code Marketplace, or download the .vsix from the latest GitHub release:

code --install-extension angrboda-1.8.1.vsix
# or
cursor --install-extension angrboda-1.8.1.vsix

Then choose Angrboda Dark or Angrboda Light from Preferences: Color Theme.

Everywhere else

For supported terminals, editors, and AI tools, install directly from npm:

npx angrboda list
npx angrboda zed --dry-run
npx angrboda zed

No global package or project dependency is added. The installer protects existing files, identifies conflicts during --dry-run, and creates backups only when you explicitly use --force.

Alternatively, download angrboda-themes-1.8.1.zip from the latest release, or use the generated files in ports/:

unzip angrboda-themes-1.8.1.zip
cd angrboda
node install.mjs list
node install.mjs zed --dry-run
node install.mjs zed

The installer supports Alacritty, Claude Code, Codex, Gemini CLI, Ghostty, Helix, Kitty, OpenCode, WezTerm, and Zed. It never edits an application's main configuration file.

| Tool | Format | Modes | | ----------------- | ------------------------- | ------------ | | VS Code + Cursor | VSIX / native themes | dark + light | | Zed | native theme family | dark + light | | Sublime Text | .sublime-color-scheme | dark + light | | Helix | native TOML theme | dark + light | | Ghostty | native theme | dark + light | | Kitty | .conf | dark + light | | Alacritty | TOML import | dark + light | | Warp | custom theme YAML | dark + light | | WezTerm | Lua color schemes | dark + light | | iTerm2 | importable color presets | dark + light | | Windows Terminal | JSON schemes | dark + light | | Claude Code | native custom themes | dark + light | | Codex CLI | TextMate .tmTheme | dark + light | | Gemini CLI | native AI harness themes | dark + light | | OpenCode | native adaptive AI theme | automatic | | Chrome + DevTools | unpacked Chrome theme | dark | | Base16 | universal scheme palettes | dark + light |

See the port installation guide for exact paths and setup.

Palette

| Role | Dark | Light | | ---------- | --------- | --------- | | Background | #141216 | #FCF9FD | | Foreground | #F5EFF8 | #211B24 | | ANSI black | #94899A | #453B49 | | Ember | #FF718A | #B52643 | | Violet | #D6A4FF | #68459B | | Cyan | #80CBC4 | #176E6B | | Green | #78C98D | #25723A |

The build validates primary text, syntax colors, and all 16 terminal ANSI colors against WCAG AA contrast.

Development

npm ci
npm run dev
npm run check
npm run package:vsix

Releases

Releases are automatic. Push to master and the Release workflow reads the conventional commits since the last tag, then bumps, tags, packages, creates the GitHub release and publishes to the VS Code Marketplace, Open VSX and npm.

| Commit type | Bump | | ------------------------- | ----- | | feat: | minor | | fix: perf: revert: | patch | | ! or BREAKING CHANGE: | major | | anything else | none |

A push with no releasing commits does nothing, so docs and chore work never cuts a version. To force a level, run the workflow by hand:

gh workflow run release.yml -f level=minor

Check what the next push would do:

node scripts/next-release.mjs --explain

Edit src/colors.ts and src/theme.ts. The build regenerates both VS Code themes and every port, keeping the system in sync. See CONTRIBUTING.md for the project workflow.

Every release contains both the editor VSIX and a checksummed ZIP with every generated port, its documentation, and source themes. The exact VSIX attached to the release is the one published to both marketplaces. Publishing needs two repository secrets, VSCE_PAT and OVSX_PAT; the workflow fails before tagging if either is missing. npm needs no secret, it publishes over OIDC with provenance.

Name

Angrboða is the giantess of the Ironwood in Norse mythology—a fitting namesake for a theme that holds light and shadow in the same system.

License

MIT © Loke Carlsson.