akari-theme 1.9.2

# akari-theme

A terminal color theme inspired by Japanese alleys lit by round lanterns.

Akari (灯) means *light* in Japanese.
This theme is not about darkness, rain, or neon —
it is about warm light, quiet streets, and the presence of life.
 Akari provides two palettes:

- **Akari Night** — lanterns are the primary light source
- **Akari Dawn** — the same alley, as the night fades into morning

![Akari Night vs. Akari Dawn](assets/akari-concept.png)

## Concept

Akari is inspired by a familiar Japanese scene:

- Narrow residential alleys
- Soft, **round lanterns** glowing above
- Wood, stone, plants, and warm shadows
- A night that feels alive, not silent

The goal is to translate this atmosphere into a terminal experience that feels calm,
warm, and readable for long sessions.

## Color Philosophy

- **Light is singular** — Only one warm color (lantern orange) serves as the primary accent
- **Blue is air, not light** — Blue represents the night sky, not a light source
- **Purple stays quiet** — Muted purple for distance, never neon
- **Green is life** — Represents plants and human presence
- **Black is gray** — True black doesn't exist in a lit alley; use warm grays instead

## Supported Tools

| Tool | Category | Installation |
|------|----------|--------------|
| [Ghostty](dist/ghostty/README.md) | Terminal Emulator | Copy theme to `~/.config/ghostty/themes/` |
| [Alacritty](dist/alacritty/README.md) | Terminal Emulator | Import theme in `alacritty.toml` |
| [Helix](dist/helix/README.md) | Editor | Copy theme to `~/.config/helix/themes/` |
| [Neovim](dist/nvim/README.md) | Editor | Install via plugin manager |
| [Visual Studio Code](dist/vscode/README.md) | Editor | Install from [Marketplace](https://marketplace.visualstudio.com/items?itemName=cappyzawa.akari-theme) or [Open VSX](https://open-vsx.org/extension/cappyzawa/akari-theme) |
| [Starship](dist/starship/README.md) | Prompt | Add palette to `~/.config/starship.toml` |
| [tmux](dist/tmux/README.md) | Terminal Multiplexer | Source config in `.tmux.conf` |
| [macOS Terminal](dist/terminal/README.md) | Terminal Emulator | Double-click to import profile |
| [zsh-syntax-highlighting](dist/zsh/README.md) | Shell | Source in `.zshrc` |
| [fzf](dist/fzf/README.md) | CLI | Source in `.bashrc` or `.zshrc` |
| [bat](dist/bat/README.md) | CLI | Copy theme to `$(bat --config-dir)/themes/` |
| [Chrome](dist/chrome/README.md) | Browser | Load unpacked extension |
| [Slack](dist/slack/README.md) | App | Import theme string in Preferences |

## Palette

Color definitions are the single source of truth in TOML format:

- [Akari Night (Dark)](palette/akari-night.toml)
- [Akari Dawn (Light)](palette/akari-dawn.toml)

## Crate Usage

Use akari-theme as a library to access palette colors in your Rust projects:

```toml
# Palette only (minimal dependencies: serde, toml, thiserror)
akari-theme = "1.9"

# With generator functionality
akari-theme = { version = "1.9", features = ["generator"] }
```

```rust
use akari_theme::{Palette, Rgb};

let night = Palette::night();
let bg: Rgb = night.base.background.parse().unwrap();
let color = bg.to_array();  // [f32; 3] for wgpu
```