📋 Project Description

Kalidozza is a handcrafted color scheme for editors and terminals, born from a simple but firm idea: the code we write for hours deserves a palette that cares for our eyes instead of wearing them down.

The core philosophy is warm-first: the base scale and main accents lean into a warm spectrum — terracottas, ambers, creams, soft oranges — to minimise the harsh blue whites common in "cold" themes. A small set of cool accent tokens is kept for syntax diversity, so structure (keywords, strings, numbers, types) stays crystal clear at a glance. The result: less visual fatigue, better sleep quality when coding at night, and a visual experience that feels friendly rather than clinical.

"Code with care." — let your code look as good as it feels to write.

🎯 Project Goals

1. Care for the eyes: lean the base scale into the warm spectrum, away from the harsh blue whites of "cold" themes.
2. Look good on any file: highlight structure (keywords, strings, functions, types) even without semantic highlighting.
3. Stay readable: keep a small cool-accent layer so the palette never feels flat or monotone.
4. Be cross-platform: deliver the same visual experience across multiple editors and terminals.

🛠️ Tech Stack

Main language:   Lua (Neovim)
Editors:         Neovim 0.9+ · VSCode
Token format:    Warm-biased base scale + cool accent layer
Inspiration:     Sunsets, terracotta, aged paper
Philosophy:      Warm-first · low harsh blue · friendly to the eye
License:         MIT

🎨 Palette — Doom Kalidozza Dark

Kalidozza is organised in three layers — a base scale (backgrounds → foregrounds), a main accent set, and a set of harmonic complements — then mapped to code faces and Org outline levels.

🟫 Base Scale (backgrounds & foregrounds)

🌈 Main Accents

🎶 Harmonic Complements

🔖 Face Assignments

📑 Org / Outline Levels

The full palette is defined in lua/kalidozza/palette.lua (Neovim) and themes/kalidozza-color-theme.json (VSCode).

✨ Features

• 🧡 Warm-first palette — earthy base, never harsh blue whites.
• 👁️ Eye Comfort First — less fatigue, better sleep.
• 🎨 Handcrafted Tokens — every color with purpose.
• 🌈 Cool Accent Layer — syntax diversity without losing warmth.
• 🌗 Multi-Editor — Neovim + VSCode (more coming soon).
• 🌓 Light/dark variants — a light variant is also available.
• 🔌 Tree-sitter & LSP — first-class semantic highlighting.
• 🪶 Lightweight — no external dependencies, just Lua/JSON.

🛠️ Installation

Neovim (with lazy.nvim)

{
  "Kalidozza-theme/neovim",
  lazy = false,
  priority = 1000,
  config = function()
    vim.cmd.colorscheme("kalidozza")
    -- Optional: light variant
    -- vim.cmd.colorscheme("kalidozza-light")
  end,
}

VSCode

code --install-extension Kalidozza-theme.vscode

Or via the command palette (Ctrl+Shift+P):

> Extensions: Install Extensions
> Kalidozza

Then activate the theme with Preferences: Color Theme → Kalidozza.

🌗 Variants & Roadmap

📈 Next Steps

• Publish the package on packer.nvim, lazy.nvim and rocks.nvim
• Release the terminal variants (Kitty, Ghostty)
• Release the GTK/Adwaita theme based on Noctalia
• Build a dedicated documentation site with just-the-docs
• Interactive palette generator (HSL → warm variants)
• Extended LSP support: lua_ls, rust, tsserver, pyright

🤝 Contributing

The project is open source under the MIT license. Pull requests, issues and token suggestions are welcome in the Kalidozza-theme organisation.