VCC

VCC - Neovim Color Scheme Changer

VCC is a fast and lightweight command-line interface (CLI) tool designed for managing Neovim color schemes seamlessly. With robust support for multiple popular themes and their variants, VCC enhances the visual experience of any Neovim setup.

Key Features

• Diverse Themes: Easily switch between five popular themes including Catppuccin, Tokyo Night, Gruvbox, Rose Pine, and Kanagawa.
• Multiple Variants: Each theme comes with authentic variants to suit different preferences.
• High Performance: Built using Go, VCC offers impressive speed and efficiency.
• Customizable: Users can define custom configuration file paths for tailored setups.
• No Dependencies: VCC operates independently without requiring additional dependencies, making it ideal for any Neovim configuration.
• Cross-Platform Compatibility: This tool is functional on macOS, Linux, and Windows operating systems.

Available Themes and Usage

Explore the following themes and their respective variants:

Basic Application

To apply the default variant of a theme:

vcc catppuccin  
vcc tokyonight  
vcc gruvbox  

To apply a specific variant:

vcc catppuccin -v mocha  
vcc tokyonight -v storm  
vcc kanagawa -v dragon  

Custom Configuration Path

For utilizing a custom configuration file path:

vcc catppuccin -v latte -p ~/.config/nvim/colors/my-theme.lua  
vcc gruvbox --variant dark --path ./custom-colorscheme.lua  

Command Options

The following command options are available for theme commands:

Architecture Overview

VCC employs a clean, modular architecture that enhances its maintainability and extensibility.

vcc/  
├── cmd/                   # Command definitions  
│   ├── catppuccin.go      # Catppuccin theme command  
│   ├── tokyonight.go      # Tokyo Night theme command  
│   ├── gruvbox.go         # Gruvbox theme command  
│   ├── rosepine.go        # Rose Pine theme command  
│   ├── kanagawa.go        # Kanagawa theme command  
│   └── root.go            # Root command  
├── utils/                  # Utility functions  
│   ├── variants.go        # Theme variant management  
│   └── config/            # Configuration file writers  
│       ├── common.go      # Unified path management  
│       ├── catppuccinFile.go  
│       ├── tokyonightFile.go  
│       ├── gruvboxFile.go  
│       ├── rosepineFile.go  
│       └── kanagawaFile.go  
└── main.go                # Application entry point  

VCC generates Neovim configuration files in Lua format that are compatible with lazy.nvim.
For more information on lazy.nvim, visit the lazy.nvim GitHub repository.

Example of Generated Configuration

return {  
  {  
    "catppuccin/nvim",  
    name = "catppuccin",  
    priority = 1000,  
    config = function()  
      require("catppuccin").setup({ flavour = "mocha" })  
      vim.cmd.colorscheme("catppuccin")  
    end,  
  },  
}  

Development Guide

For developers interested in contributing to VCC or adding new themes, the process is straightforward:

1. Add Variants: Define variants in utils/variants.go.
2. Create Config Writer: Implement the configuration writer in utils/config/newthemeFile.go.
3. Add Command: Create a command in cmd/newtheme.go.

VCC is designed for efficient performance and a user-friendly experience, making it an essential tool for managing color schemes in Neovim.