Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/erickm13/Salchipapa.Dots/llms.txt

Use this file to discover all available pages before exploring further.

Alacritty is the GPU-accelerated terminal emulator option in Salchipapa.Dots. Its configuration lives at SalchipapaAlacritty/alacritty.toml and is symlinked into ~/.config/alacritty by the installer, keeping the entire setup declarative and version-controlled. The config is intentionally lean — font, window, cursor, and color palette only — letting Alacritty’s defaults handle everything else while keeping startup time near-instant.

​
Installation

1

Create the symlink

Link the config directory into the standard XDG config location:
ln -s ~/Salchipapa.Dots/SalchipapaAlacritty ~/.config/alacritty
2

Install the terminfo entry (recommended)

For the best Neovim and shell compatibility, install the Alacritty terminfo entries:
sudo tic -xe alacritty,alacritty-direct extra/alacritty.info
Without the terminfo entry, some terminal escape sequences used by Neovim (undercurl, true italic, etc.) may not render correctly. The extra/alacritty.info file ships with the Alacritty source. See the Alacritty installation guide for details.
3

Install IosevkaTerm NF

The font must be installed on the host OS (Windows-side for WSL2) before Alacritty will find it.
Download IosevkaTerm Nerd Font from nerdfonts.com. On WSL2, install the font on the Windows host so Alacritty (which renders natively on Windows) can discover it.

​
Configuration Reference

​
Font

SettingValue
FamilyIosevkaTerm NF
Size14

​
Window

SettingValue
opacity0.75
blurtrue
option_as_alt"Both"
The option_as_alt = "Both" setting maps the macOS Option key as the Alt modifier on both sides of the keyboard, which is required for many Neovim keybinds (<M-…>) when running on macOS.

​
Cursor

SettingValue
styleBlock
blink_interval500 ms
unfocused_hollowtrue
vi_mode_styleBlock

​
Environment

VariableValue
TERMxterm-256color
Setting TERM to xterm-256color ensures maximum compatibility with terminal tools that probe for color capability. If you install the Alacritty terminfo entry (step 2 above), you can change this to alacritty for the full feature set.

​
Solarized Osaka Color Palette

The active color theme is Solarized Osaka, derived from craftzdog/solarized-osaka.nvim. Below is the complete palette as it appears in alacritty.toml: 
# --- Base Colors ---
[colors.primary]
background = "#001419"
foreground = "#839395"

[colors.cursor]
cursor = "#839395"
text   = "#001419"

[colors.selection]
background = "#1a6397"
text       = "#839395"

# --- Normal Colors ---
[colors.normal]
black   = "#001014"
red     = "#db302d"
green   = "#849900"
yellow  = "#b28500"
blue    = "#268bd3"
magenta = "#d23681"
cyan    = "#29a298"
white   = "#9eabac"

# --- Bright Colors ---
[colors.bright]
black   = "#001419"
red     = "#db302d"
green   = "#849900"
yellow  = "#b28500"
blue    = "#268bd3"
magenta = "#d23681"
cyan    = "#29a298"
white   = "#839395"
A second, commented-out palette called Gentleman Theme is preserved in alacritty.toml as a fallback. Swap the active [colors.*] blocks with the ones below to use it:
[colors.primary]
background = "#06080f"
foreground = "#f3f6f9"

[colors.cursor]
cursor = "#e0c15a"
text   = "#06080f"

[colors.selection]
background = "#263356"
text       = "#f3f6f9"

[colors.normal]
black   = "#06080f"
red     = "#cb7c94"
green   = "#b7cc85"
yellow  = "#ffe066"
blue    = "#7fb4ca"
magenta = "#ff8dd7"
cyan    = "#7aa89f"
white   = "#f3f6f9"

[colors.bright]
black   = "#8a8fa3"
red     = "#de8fa8"
green   = "#d1e8a9"
yellow  = "#fff7b1"
blue    = "#a3d4d5"
magenta = "#ffaeea"
cyan    = "#7fb4ca"
white   = "#f3f6f9"

​
Full Configuration File

# ╔══════════════════════════════════════════════════════════════════════════════╗
# ║                         GENTLEMAN DOTS - ALACRITTY                           ║
# ║                          Optimized for Neovim                                ║
# ╚══════════════════════════════════════════════════════════════════════════════╝

# ┌──────────────────────────────────────────────────────────────────────────────┐
# │                                   FONT                                       │
# └──────────────────────────────────────────────────────────────────────────────┘

[font]
size = 14

[font.normal]
family = "IosevkaTerm NF"


# ┌──────────────────────────────────────────────────────────────────────────────┐
# │                                  WINDOW                                      │
# └──────────────────────────────────────────────────────────────────────────────┘

[window]
opacity = 0.75
blur = true
option_as_alt = "Both"


# ┌──────────────────────────────────────────────────────────────────────────────┐
# │                                  CURSOR                                      │
# └──────────────────────────────────────────────────────────────────────────────┘

[cursor]
style = "Block"
blink_interval = 500
unfocused_hollow = true
vi_mode_style = "Block"


# ┌──────────────────────────────────────────────────────────────────────────────┐
# │                                 TERMINAL                                     │
# └──────────────────────────────────────────────────────────────────────────────┘

[terminal]
# For best Neovim compatibility, install alacritty terminfo:
# sudo tic -xe alacritty,alacritty-direct extra/alacritty.info

[env]
TERM = "xterm-256color"

[hints]
enabled = []


# ┌──────────────────────────────────────────────────────────────────────────────┐
# │                         SOLARIZED OSAKA THEME                                │
# │              (from craftzdog/solarized-osaka.nvim extras/alacritty)          │
# └──────────────────────────────────────────────────────────────────────────────┘

[colors.primary]
background = "#001419"
foreground = "#839395"

[colors.cursor]
cursor = "#839395"
text   = "#001419"

[colors.selection]
background = "#1a6397"
text       = "#839395"

[colors.normal]
black   = "#001014"
red     = "#db302d"
green   = "#849900"
yellow  = "#b28500"
blue    = "#268bd3"
magenta = "#d23681"
cyan    = "#29a298"
white   = "#9eabac"

[colors.bright]
black   = "#001419"
red     = "#db302d"
green   = "#849900"
yellow  = "#b28500"
blue    = "#268bd3"
magenta = "#d23681"
cyan    = "#29a298"
white   = "#839395"

Build docs developers (and LLMs) love

Get started for freeTalk to us