https://github.com/hyperb1iss/silkcircuit-nvim

Vibrant cyberpunk-inspired Neovim theme with neon colors and extensive plugin support
https://github.com/hyperb1iss/silkcircuit-nvim

astronvim colorscheme cyberpunk developer-tools neon neovim neovim-colorscheme neovim-theme vim-colorscheme

Last synced: 11 months ago
JSON representation

Vibrant cyberpunk-inspired Neovim theme with neon colors and extensive plugin support

Host: GitHub
URL: https://github.com/hyperb1iss/silkcircuit-nvim
Owner: hyperb1iss
License: mit
Created: 2025-07-25T18:45:18.000Z (11 months ago)
Default Branch: main
Last Pushed: 2025-07-27T03:14:35.000Z (11 months ago)
Last Synced: 2025-07-27T05:22:30.680Z (11 months ago)
Topics: astronvim, colorscheme, cyberpunk, developer-tools, neon, neovim, neovim-colorscheme, neovim-theme, vim-colorscheme
Language: Lua
Homepage: https://hyperbliss.tech
Size: 671 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

          # 💜⚡ SilkCircuit: Electric Dreams for Neovim 🌃



[![Neovim](https://img.shields.io/badge/Neovim%200.8+-e135ff.svg?style=for-the-badge&logo=neovim&logoColor=white)](https://neovim.io/)

[![Lua](https://img.shields.io/badge/Made%20with%20Lua-80ffea.svg?style=for-the-badge&logo=lua&logoColor=white)](https://www.lua.org/)

[![License](https://img.shields.io/badge/License-MIT-ff79c6?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](https://opensource.org/licenses/MIT)

[![Theme](https://img.shields.io/badge/Theme-SilkCircuit-e135ff?style=for-the-badge&logo=paintbrush&logoColor=white)](https://github.com/hyperb1iss/silkcircuit-nvim)

[![WCAG](https://img.shields.io/badge/WCAG%20AA-Compliant-50fa7b?style=for-the-badge&logo=accessibility&logoColor=white)](https://www.w3.org/WAI/WCAG21/quickref/)

[![Load Time](https://img.shields.io/badge/Load%20Time-<5ms-f1fa8c?style=for-the-badge&logo=lightning&logoColor=black)](https://github.com/hyperb1iss/silkcircuit-nvim)

[![Plugins](https://img.shields.io/badge/40+%20Plugins-Supported-bd93f9?style=for-the-badge&logo=puzzle-piece&logoColor=white)](https://github.com/hyperb1iss/silkcircuit-nvim#-plugin-support)

[![Variants](https://img.shields.io/badge/4%20Variants-Neon%20|%20Vibrant%20|%20Soft%20|%20Glow-ffb86c?style=for-the-badge&logo=swatchbook&logoColor=white)](https://github.com/hyperb1iss/silkcircuit-nvim#-theme-variants)

🌌 _Pure electric energy with vibrant purples, blazing pinks, and neon accents_ 🎆

[⚡ Installation](#-installation) • [💜 Features](#-features) • [🎨 Configuration](#-configuration) • [🔮 Plugin Support](#-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](https://github.com/folke/lazy.nvim) (Recommended)

```lua

{

  "hyperb1iss/silkcircuit-nvim",

  lazy = false,

  priority = 1000,

  config = function()

    vim.cmd.colorscheme("silkcircuit")

  end,

}

```

### 📦 Using [packer.nvim](https://github.com/wbthomason/packer.nvim)

```lua

use {

  "hyperb1iss/silkcircuit-nvim",

  config = function()

    vim.cmd("colorscheme silkcircuit")

  end

}

```

### 🔮 Using [vim-plug](https://github.com/junegunn/vim-plug)

```vim

Plug 'hyperb1iss/silkcircuit-nvim'

colorscheme silkcircuit

```

## 🛸 AstroNvim

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

```lua

-- 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

```lua

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:

```lua

-- 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:

```lua

require("silkcircuit").setup({

  transparent = true,

})

```

### 🎯 Custom Highlights

Override any highlight group:

```lua

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

```bash

# 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](extras/README.md) for detailed setup instructions.

## 💜 Color Palette

| Color | Hex | Preview |

|-------|-----|---------|

| Background | `#0a0a0f` | ![#0a0a0f](https://placehold.co/20x20/0a0a0f/0a0a0f.png) |

| Foreground | `#e0e0e0` | ![#e0e0e0](https://placehold.co/20x20/e0e0e0/e0e0e0.png) |

| Purple | `#e135ff` | ![#e135ff](https://placehold.co/20x20/e135ff/e135ff.png) |

| Pink | `#ff79c6` | ![#ff79c6](https://placehold.co/20x20/ff79c6/ff79c6.png) |

| Cyan | `#80ffea` | ![#80ffea](https://placehold.co/20x20/80ffea/80ffea.png) |

| Green | `#50fa7b` | ![#50fa7b](https://placehold.co/20x20/50fa7b/50fa7b.png) |

| Yellow | `#f1fa8c` | ![#f1fa8c](https://placehold.co/20x20/f1fa8c/f1fa8c.png) |

| Orange | `#ffb86c` | ![#ffb86c](https://placehold.co/20x20/ffb86c/ffb86c.png) |

## 🛠️ 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](https://github.com/hyperb1iss/silkcircuit-nvim/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.

```bash

# 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](STYLE_GUIDE.md) and [CLAUDE.md](CLAUDE.md) for development guidelines.

## 📜 License

MIT License - see [LICENSE](LICENSE) for details.

---



Created by [Stefanie Jane 🌠](https://github.com/hyperb1iss)

If you love SilkCircuit, [buy me a Monster Ultra Violet ⚡](https://ko-fi.com/hyperb1iss)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/hyperb1iss/silkcircuit-nvim

Awesome Lists containing this project

README