🔧 Installation

Packer

    use({
        "themercorp/themer.lua",
        config = function()
	      require("themer").setup({
	          colorscheme = "rose_pine",
	          styles = {
	            	["function"] = { style = 'italic' },
	             	functionbuiltin = { style = 'italic' },
	             	variable = { style = 'italic' },
	              	variableBuiltIn = { style = 'italic' },
	            	parameter  = { style = 'italic' },
	          },
	      })
        end
    })

vim-plug

Plug 'themercorp/themer.lua'

Now you can place this base configuration in your init.vim file:

lua << EOF
	      require("themer").setup({
	          colorscheme = "rose_pine",
	          styles = {
	            	["function"] = { style = 'italic' },
	             	functionbuiltin = { style = 'italic' },
	             	variable = { style = 'italic' },
	              	variableBuiltIn = { style = 'italic' },
	            	parameter  = { style = 'italic' },
	          },
	      })
EOF

or you can also place this in your init.vim file:

colorscheme themer_catppuccin

🍰 Supported Plugins

🌹 Supported colorschemes

| | Colorschemes | Code Names | | --- | -------------- | ---------------- | | ✅ | Catppuccin | catppuccin | | ✅ | Rose Pine | rose_pine | | ✅ | Rose Pine Moon | rose_pine_moon | | ✅ | EverForest | everforest | | ✅ | Doom One | doom_one | | ✅ | Rose Pine Dawn | rose_pine_dawn | | ✅ | Dracula | dracula | | ✅ | Papa Dark | papa_dark | | ✅ | One Dark | onedark | | ✅ | Nord | nord | | ✅ | Kurai | kurai |

This list may not be updated. See lua/themer/modules/themes

🧰 Configuring Themer

Heres the default config table

{
    colorscheme = "rose_pine", -- default colorscheme
    transparent = false,
    term_colors = true,
    dim_inactive = false,
    disable_telescope_themes = {},
    styles = {
        heading = {
            h1 = {},
            h2 = {},
        },
        ["function"] = {},
        functionBuiltIn = {},
        variable = {},
        variableBuiltIn = {},
        include = {},
        identifier = {},
        keyword = {},
        keywordBuiltIn = {},
        struct = {},
        string = {},
        parameter = {},
        field = {},
        type = {},
        typeBuiltIn = {},
        property = {},
        comment = {},
        punctuation = {},
        constructor = {},
        operator = {},
        constant = {},
        constantBuiltIn = {},
        todo = {},
        character = {},
        conditional = {},
        number = {},
        statement = {},
        uri = {},
        diagnostic = {
            underline = {
                error = {},
                warn = {},
                info = {},
                hint = {},
            },
            virtual_text = {
                error = {},
                warn = {},
                info = {},
                hint = {},
            },
        },
    },
    remaps = {
        palette = {},
        -- per colorscheme palette remaps, for example:
        -- remaps.palette = {
        --     rose_pine = {
        --     	fg = "#000000"
        --     }
        -- },
        -- remaps.highlights = {
        --     rose_pine = {
	      --	base = {
        --     	  Normal = { bg = "#000000" }
       	--	},
       	--     }
        -- },
        --
        -- Also you can do remaps.highlights.globals  for global highlight remaps
        highlights = {},
    },

    langs = {
        html = true,
        md = true,
    },

    plugins = {
        treesitter = true,
        indentline = true,
        barbar = true,
        bufferline = true,
        cmp = true,
        gitsigns = true,
        lsp = true,
        telescope = true,
    },
    enable_installer = false, -- enable installer module
}

🧸 Extra Goodies

🖱️ Scroll Colors

Scroll the colorschemes on the fly with :SCROLLCOLOR (Inspired by scroll-colors.vim)

🔭 Telescope Picker

You can use a telescope picker to preview the themes and load the colorschemes on the fly

To use the picker

lua require("telescope").load_extension("themes")
Telescope themes

Reload

While developing your own colorscheme with themer, you can use the reload module to reload the colors on the fly.

To start the reload module :ThemerReload and start editing. Whenever you leave Insert mode, themer will try to load the theme as per table returned by the current buffer lua file.

Installer

You can use themer to install other themes which are yet to be ported to themer (or can just port them with import api to themer 😉)

To enable installer add this to your config

require("themer").setup({ enable_installer = true })

You can use :ThemerInstall to browse and install themes. (using telescope 🔭) And can do :ThemerUnInstall to uninstall installed themes.

Themer will load installed themes along with setup.

Exporting theme to other stuff

You can export current colorscheme to the following:

XResources :lua require("themer.modules.export.xres").write_config()
Kitty :lua require("themer.modules.export.kitty").write_config()
Alacritty :lua require("themer.modules.export.alacritty").write_config()
Compiled Neovim colorscheme :lua require("themer.modules.export.nvim").write_colorscheme(require("themer.modules.themes.catppuccin")) (PS: This one needs the color palette as the param)
Compiled Vim colorscheme :lua require("themer.modules.export.vim").write_colorscheme(require("themer.modules.themes.catppuccin")) (PS: This one also needs the color palette as the param)

Using API to access colors

You can use colors api to access color palette of given theme

require("themer.modules.core.api").get_cp("catppuccin")

🤝 Contributing

Adding more plugin higs

All plugin highlight groups are in modules/core/mapper.lua

Feel free to add new plugin hig groups in availablePlugins table and then tweaking config.options.plugins to add plugin to the list.

Adding new colorscheme

Here's an example colorscheme with themer palette

-- Generated by Themer
return {
  ["cursorlinenr"] = "#ff9e3b",
  ["dimmed"] = { ["inactive"] = "#54546d", ["subtle"] = "#727169" },
  ["built_in"] = {
    ["function"] = "#7fb4ca",
    ["constant"] = "#7fb4ca",
    ["keyword"] = "#957fb8",
    ["variable"] = "#e46876",
    ["type"] = "#7aa89f",
  },
  ["gitsigns"] = { ["remove"] = "#c34043", ["add"] = "#76946a", ["change"] = "#dca561" },
  ["pum"] = {
    ["sbar"] = "#223249",
    ["sel"] = { ["fg"] = "#0", ["bg"] = "#2d4f67" },
    ["fg"] = "#dcd7ba",
    ["bg"] = "#223249",
    ["thumb"] = "#2d4f67",
  },
  ["heading"] = { ["h1"] = "#7e9cd8", ["h2"] = "#0" },
  ["uri"] = "#7fb4ca",
  ["inc_search"] = { ["fg"] = "#223249", ["bg"] = "#ff9e3b" },
  ["syntax"] = {
    ["tag"] = "#957fb8",
    ["constant"] = "#ffa066",
    ["preproc"] = "#ffa066",
    ["string"] = "#98bb6c",
    ["parameter"] = "#e6c384",
    ["field"] = "#e6c384",
    ["variable"] = "#0",
    ["number"] = "#d27e99",
    ["statement"] = "#957fb8",
    ["todo"] = { ["fg"] = "#658594", ["bg"] = "#223249" },
    ["function"] = "#7e9cd8",
    ["punctuation"] = "#9cabca",
    ["struct"] = "#7aa89f",
    ["operator"] = "#c0a36e",
    ["conditional"] = "#957fb8",
    ["type"] = "#7aa89f",
    ["comment"] = "#727169",
    ["keyword"] = "#957fb8",
    ["property"] = "#e6c384",
    ["constructor"] = "#957fb8",
    ["include"] = "#ffa066",
  },
  ["border"] = "#54546d",
  ["fg"] = "#dcd7ba",
  ["match"] = "#7e9cd8",
  ["diagnostic"] = { ["warn"] = "#ff9e3b", ["info"] = "#658594", ["error"] = "#e82424", ["hint"] = "#6a9589" },
  ["bg"] = { ["alt"] = "#16161d", ["selected"] = "#363646", ["base"] = "#1f1f28" },
  ["diff"] = { ["text"] = "#49443c", ["remove"] = "#43242b", ["add"] = "#2b3328", ["change"] = "#252535" },
  ["accent"] = "#7fb4ca",
  ["search_result"] = { ["fg"] = "#dcd7ba", ["bg"] = "#2d4f67", ["telescope"] = "#7fb4ca" },
}

Also add the theme name to README and add it to colors/

Porting another vim/neovim theme

You can use lua/themer/modules/import/init.lua to generate color palette and port that theme to themer

colorscheme my_awesome_theme
lua require("themer.modules.import").write_colorscheme()

Using themer to make your colorscheme plugin

You can use lua/themer/modules/export/nvim.lua and lua/themer/modules/export/vim.lua to create a single vim file (with no dependancy on themer) and can use that for creating your colorscheme plugin easily. Also contribute theme palette to themer, if possible.

:green_heart: Credits

Massive shoutouts to the people who supported the project! These are:

Binx, for making that gorgeous logo for free!
- Github
- Reddit
All the contributors who helped in the project

Tabline

akinsho/bufferline.nvim

crispgm/nvim-tabline

koenverburg/minimal-tabline.nvim

nanozuki/tabby.nvim

noib3/nvim-cokeline

romgrk/barbar.nvim

Status Line

alvarosevilla95/luatab.nvim

b0o/incline.nvim

datwaft/bubbly.nvim

feline-nvim/feline.nvim

konapun/vacuumline.nvim

NTBBloodbath/galaxyline.nvim

nvim-lualine/lualine.nvim

rebelot/heirline.nvim

tamton-aquib/staline.nvim

windwp/windline.nvim

Keybinding

b0o/mapx.nvim

folke/which-key.nvim

mrjones2014/legendary.nvim

simrat39/rust-tools.nvim

LSP

b0o/SchemaStore.nvim

folke/trouble.nvim

jose-elias-alvarez/nvim-lsp-ts-utils

neovim/nvim-lspconfig

nvim-lua/lsp_extensions.nvim

nvim-lua/lsp-status.nvim

ray-x/navigator.lua

williamboman/nvim-lsp-installer

Guides

bennypowers/nvim-regexplainer

nvim-lua/kickstart.nvim

Colorschemes

catppuccin/nvim

dharmx/nvim-colo

ful1e5/onedark.nvim

HUAHUAI23/nvim-quietlight

kvrohit/substrata.nvim

lalitmee/cobalt2.nvim

luisiacc/gruvbox-baby

mhartington/oceanic-next

Mofiqul/adwaita.nvim

Mofiqul/dracula.nvim

mrjones2014/lighthaus.nvim

navarasu/onedark.nvim

NTBBloodbath/doom-one.nvim

rebelot/kanagawa.nvim

rose-pine/neovim

RRethy/nvim-base16

sunjon/Shade.nvim

themercorp/themer.lua

zanglg/nova.nvim

Comment

danymat/neogen

Utility

echasnovski/mini.nvim

hood/popui.nvim

meznaric/conmenu

mrjones2014/dash.nvim

Cursor Line

edluffy/specs.nvim

mg979/vim-visual-multi

Code Runner

FeiyouG/command_center.nvim

Extras

folke/zen-mode.nvim

goolord/alpha-nvim

Start Up

henriquehbr/nvim-startup.lua

lewis6991/impatient.nvim

Session

HUAHUAI23/telescope-session.nvim

Fuzzy Finder

ibhagwan/fzf-lua

nvim-telescope/telescope.nvim

vijaymarupudi/nvim-fzf

Misc