💜⚡ SilkCircuit: Electric Dreams for Neovim 🌃

🌌 Pure electric energy with vibrant purples, blazing pinks, and neon accents 🎆

⚡ Installation • 💜 Features • 🎨 Configuration • 🔮 Plugin Support

🎭 Overview

SilkCircuit pumps maximum visual voltage through your Neovim. Electric purples 💜, blazing pinks 🌸, and neon cyans 💎 create a coding environment that's both striking and readable. Engineered for speed with <5ms load times and WCAG AA contrast compliance.

🦄 Features

• 🎪 Electric Color System — Vibrant palette with semantic color mappings
• 🏎️ <5ms Load Time — Bytecode compilation with intelligent caching
• 👁️ WCAG AA Compliant — Validated contrast ratios for extended coding sessions
• 🎛️ Theme Variants — Neon (100%), Vibrant (85%), Soft (70%), and Glow (ultra-dark) modes
• 🔮 40+ Plugin Integrations — Auto-detected support for your entire toolchain
• 💾 Persistent Preferences — Settings survive across sessions

💫 Installation

🎯 Using lazy.nvim (Recommended)

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

📦 Using packer.nvim

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

🔮 Using vim-plug

Plug 'hyperb1iss/silkcircuit-nvim'
colorscheme silkcircuit

🛸 AstroNvim

SilkCircuit integrates seamlessly with AstroNvim, just like any community colorscheme:

-- In your lua/community.lua file:
return {
  "AstroNvim/astrocommunity",
  { "hyperb1iss/silkcircuit-nvim", name = "silkcircuit" },
}

-- In your lua/plugins/astroui.lua file:
return {
  "AstroNvim/astroui",
  opts = {
    colorscheme = "silkcircuit",
  },
}

That's it! No additional configuration needed.

🎨 Configuration

🎪 Default Setup

require("silkcircuit").setup({
  transparent = false,     -- Enable transparent background
  terminal_colors = true,  -- Configure terminal colors
  dim_inactive = false,    -- Dim inactive windows
  variant = "neon",       -- Theme variant: "neon" | "vibrant" | "soft" | "glow"

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

  integrations = {
    -- Auto-detected by default
    telescope = true,
    neotree = true,
    notify = true,
    cmp = true,
    mini = true,
    -- See :h silkcircuit-integrations for full list
  },
})

🌈 Theme Variants

Switch between intensity levels:

-- Via setup
require("silkcircuit").setup({
  variant = "vibrant", -- "neon" | "vibrant" | "soft" | "glow"
})

-- Or use commands
:SilkCircuit neon     -- 100% intensity
:SilkCircuit vibrant  -- 85% intensity
:SilkCircuit soft     -- 70% intensity
:SilkCircuit glow     -- Ultra-dark backgrounds with pure neon colors

🌌 Transparent Background

For a sleek, transparent look:

require("silkcircuit").setup({
  transparent = true,
})

🎯 Custom Highlights

Override any highlight group:

require("silkcircuit").setup({
  on_highlights = function(highlights, colors)
    highlights.Function = { fg = colors.cyan, bold = true }
    highlights.Comment = { fg = colors.gray, italic = true }
  end,
})

🌟 Plugin Support

SilkCircuit auto-detects and themes 40+ plugins:

🎯 Core Functionality

• 🔭 Telescope → Fuzzy finder
• 🌳 Neo-tree → File explorer
• 💡 LSP → Language servers
• 🌿 Treesitter → Syntax highlighting
• 🎹 nvim-cmp → Completion
• 📦 Mason → Package manager

🏃 Navigation & Motion

• ⚡ Flash / Leap → Jump motions
• 🎣 Harpoon → File marks
• 🗝️ Which-Key → Keybinding hints
• 🦘 Mini.jump → Enhanced jumps

🔧 Git & Development

• 📊 Gitsigns → Git indicators
• 🎭 Neogit → Git interface
• 🐛 DAP → Debugging
• 🧹 none-ls → Formatting/linting

💎 UI Components

• 📍 Lualine → Status line
• 📑 BufferLine → Buffer tabs
• 🔔 Notify / Noice → Notifications
• 🎪 Alpha → Dashboard
• 📏 Mini.statusline → Minimal status

🎨 Editor Enhancement

• 🌈 Rainbow Delimiters → Bracket pairs
• 📐 Indent Blankline → Indentation guides
• 🔍 Mini.indentscope → Active indent
• 💫 Mini.cursorword → Word highlighting

All integrations activate automatically when plugins are detected.

🌃 Complete Environment Setup

SilkCircuit extends beyond Neovim with matching themes for your entire development environment:

🎯 Quick Setup

# Get the complete SilkCircuit experience
git clone https://github.com/hyperb1iss/silkcircuit-nvim.git
cd silkcircuit-nvim

# Electric git colors with conventional commit support
cat extras/gitconfig >> ~/.gitconfig

# Terminal themes (choose your terminal)
cp extras/kitty.conf ~/.config/kitty/themes/silkcircuit.conf
cp extras/alacritty.yml ~/.config/alacritty/themes/silkcircuit.yml
cp extras/warp.yaml ~/.warp/themes/silkcircuit.yaml

# VSCode theme (all variants included)
cd extras/vscode && npx @vscode/vsce package
# Install the generated .vsix file in VSCode/Cursor

# System info theme
cp extras/macchina/silkcircuit.toml ~/.config/macchina/themes/

# AstroNvim integration
cp -r extras/astronvim/* ~/.config/nvim/lua/

🚀 What's Included

• 🎨 VSCode Themes - All 4 variants (Neon, Vibrant, Soft, Glow) for VSCode/Cursor
• ⚡ Git Configuration - Electric colors with conventional commit highlighting
• 🖥️ Terminal Themes - Alacritty, Kitty, Warp, Windows Terminal, iTerm2
• 🚀 AstroNvim Integration - Complete setup with enhanced components
• 📊 System Tools - Macchina theme for system info display
• 🎨 Tool Configs - FZF, Lualine, and more

See extras/README.md for detailed setup instructions.

💜 Color Palette

Color	Hex	Preview
Background	#0a0a0f
Foreground	#e0e0e0
Purple	#e135ff
Pink	#ff79c6
Cyan	#80ffea
Green	#50fa7b
Yellow	#f1fa8c
Orange	#ffb86c

🛠️ Troubleshooting

🤔 Theme not loading?

• ⚡ Neovim 0.8.0+ required
• 🎨 Add vim.opt.termguicolors = true to config
• 📦 Verify plugin installation: :Lazy or :PackerStatus

🎭 Colors incorrect?

• 🖥️ Terminal must support true colors
• 🔄 Test with different terminal emulator
• ⚙️ Verify terminal color settings

🏎️ Performance issues?

• 🩺 Run :checkhealth silkcircuit for diagnostics
• 🔐 Check cache directory permissions
• 🧹 Clear cache: :SilkCircuitClearCache

💭 Need help?

• 💜 Run :checkhealth silkcircuit
• 📬 Check Issues
• 📝 Include config and error messages

🎮 Commands

Command	Description
:SilkCircuit {variant}	Switch theme variant (neon/vibrant/soft/glow)
:SilkCircuitContrast	Check WCAG contrast compliance
:SilkCircuitCompile	Compile theme for performance
:SilkCircuitIntegrations	Show detected plugin integrations
:checkhealth silkcircuit	Run health check diagnostics

💖 Contributing

Contributions welcome! Submit issues and pull requests.

# Clone the repo
git clone https://github.com/hyperb1iss/silkcircuit-nvim.git
cd silkcircuit-nvim

# Install dev dependencies
make setup

# Run tests and linting
make test
make lint

See STYLE_GUIDE.md and CLAUDE.md for development guidelines.

📜 License

MIT License - see LICENSE for details.

---

Created by Stefanie Jane 🌠

If you love SilkCircuit, buy me a Monster Ultra Violet ⚡