💜⚡ SilkCircuit: Electric Meets Elegant

🎭 What Is SilkCircuit?

One palette, one semantic system, five intensity variants, every tool in your workflow. SilkCircuit themes editors, terminals, browsers, system monitors, and CLI tools with consistent colors and WCAG AA contrast ratios across the board.

🌐 Platforms

🎛️ Variants

Five intensity levels, all using the same underlying palette:

🪄 Quick Start

⚡ Universal Installer

The fastest way to theme everything at once. Detects your installed tools and applies matching SilkCircuit configs with backups:

git clone https://github.com/hyperb1iss/silkcircuit.git
cd silkcircuit
./install.sh

git clone https://github.com/hyperb1iss/silkcircuit.git
cd silkcircuit
powershell -ExecutionPolicy Bypass -File .\install.ps1

🎯 Individual Platforms

Pick what you need:

{
  "hyperb1iss/silkcircuit",
  lazy = false,
  priority = 1000,
  config = function()
    vim.cmd.colorscheme("silkcircuit")
  end,
}

use {
  "hyperb1iss/silkcircuit",
  config = function()
    vim.cmd("colorscheme silkcircuit")
  end
}

Plug 'hyperb1iss/silkcircuit'
colorscheme silkcircuit

code --install-extension hyperb1iss.silkcircuit-theme

make chrome
# chrome://extensions/ → Developer mode → Load unpacked
# Select: extras/chrome-theme/silkcircuit-{variant}/

# Ghostty: copy variant config to ~/.config/ghostty/
cp extras/ghostty/silkcircuit-neon ~/.config/ghostty/themes/

# Kitty
cp extras/kitty.conf ~/.config/kitty/themes/silkcircuit.conf

# Alacritty
cp extras/alacritty.yml ~/.config/alacritty/themes/silkcircuit.yml

# Warp
cp extras/warp.yaml ~/.warp/themes/silkcircuit.yaml

# Windows Terminal: import extras/windows-terminal.json in settings

# Windows Terminal: stage the scheme for import
New-Item -ItemType Directory -Force "$env:APPDATA\silkcircuit"
Copy-Item extras\windows-terminal.json "$env:APPDATA\silkcircuit\windows-terminal.json"

# btop (5 variants)
cp extras/btop/silkcircuit_*.theme ~/.config/btop/themes/

# K9s (5 variants)
cp extras/k9s/silkcircuit_*.yaml ~/.config/k9s/skins/

# Git colors with delta integration
cat extras/gitconfig >> ~/.gitconfig

# fzf
source extras/fzf.sh  # or add to .zshrc/.bashrc

# Starship prompt
cp extras/starship/silkcircuit.toml ~/.config/starship.toml

# fzf
. .\extras\fzf.ps1

# Starship prompt
New-Item -ItemType Directory -Force "$HOME\.config"
Copy-Item extras\starship\starship.toml "$HOME\.config\starship.toml"

💜 Neovim

The Neovim theme is the most feature-rich target: bytecode-compiled for <5ms load times, 40+ auto-detected plugin integrations, and persistent preferences.

🎪 Configuration

require("silkcircuit").setup({
  transparent = false,
  terminal_colors = true,
  dim_inactive = false,
  variant = "neon",       -- "neon" | "vibrant" | "soft" | "glow" | "dawn"

  styles = {
    comments = { italic = true },
    keywords = { bold = true },
    functions = { bold = true, italic = true },
    variables = {},
    strings = { italic = true },
  },

  integrations = {
    telescope = true,     -- all auto-detected by default
    neotree = true,
    notify = true,
    cmp = true,
    mini = true,
  },
})

🔮 Plugin Support

All integrations activate automatically when plugins are detected.

• 🎯 Core: Telescope, Neo-tree, LSP, Treesitter, nvim-cmp, Mason
• 🏃 Navigation: Flash, Harpoon, Which-Key, Mini.jump
• 🔧 Git & Dev: Gitsigns, Neogit, DAP
• 💎 UI: Lualine, BufferLine, Notify, Noice, Alpha, Indent Blankline, Rainbow Delimiters

🛸 AstroNvim

return {
  "AstroNvim/astrocommunity",
  { "hyperb1iss/silkcircuit", name = "silkcircuit" },
}

🎮 Commands

🌃 Full Ecosystem

SilkCircuit extends far beyond your editor. See extras/README.md for setup instructions for every supported tool.

🎨 Color Palette

Color	Hex	Usage
Background	#0a0a0f
Foreground	#e0e0e0
💜 Electric Purple	#e135ff	Keywords, primary accents
🌸 Hot Pink	#ff79c6	Strings, secondary
💎 Neon Cyan	#80ffea	Functions, links
✅ Success Green	#50fa7b	Success states
⚡ Electric Yellow	#f1fa8c	Warnings, variables
🔥 Warm Orange	#ffb86c	Numbers, constants

📸 Screenshot Gallery

Neovim

Syntax Highlighting	Theme Highlights

Terminal & CLI Tools

lazygit	btop

bat	fzf

git log	delta

lsd	procs

fastfetch

🛠️ Troubleshooting

🤔 Neovim theme not loading? Requires Neovim 0.8.0+ with vim.opt.termguicolors = true. Run :checkhealth silkcircuit.

🎭 Colors look wrong? Your terminal must support true colors (24-bit). Try a different terminal emulator if unsure.

🏎️ Performance issues? Run :SilkCircuitCompile to regenerate the bytecode cache.

💭 Need help? Open an issue with your config and error output.

💖 Contributing

git clone https://github.com/hyperb1iss/silkcircuit.git
cd silkcircuit
make setup    # install dev dependencies
make test     # run unit tests
make lint     # check code quality

See STYLE_GUIDE.md for the entire SilkCircuit design language.

📜 License

MIT License. See LICENSE for details.