Terracotta Colorscheme

A warm, earthy color scheme for Neovim inspired by terracotta pottery that is insightful and comfortable for the eyes.

Installation

Using lazy.nvim

{
  "Pearljak/terracotta.nvim",
  lazy = false,
  priority = 1000,
  config = function()
    vim.cmd([[colorscheme terracotta]])
  end,
}

With customization:

{
  "Pearljak/terracotta.nvim",
  lazy = false,
  priority = 1000,
  config = function()
    require('terracotta').setup({
      styles = {
        strings = { italic = true },
        keywords = { bold = true },
      }
    })
    vim.cmd([[colorscheme terracotta]])
  end,
}

Using packer.nvim

use {
  "Pearljak/terracotta.nvim",
  config = function()
    -- Optional: configure before loading
    -- require('terracotta').setup({ ... })
    vim.cmd([[colorscheme terracotta]])
  end
}

Using vim-plug

Plug 'Pearljak/terracotta.nvim'

Then in your init.lua:

-- require('terracotta').setup({ ... })

colorscheme terracotta

Usage

Quick Start

vim.cmd([[colorscheme terracotta]])

Optional:

require('terracotta').setup({
  styles = {
    functions = { bold = true },
    keywords = { italic = true },
  },
})

vim.cmd([[colorscheme terracotta]])

Full Configuration Options:

Note: Configuration is completely optional. The theme works perfectly without any setup.

require('terracotta').setup({
  styles = {
    comments = { italic = true },  -- default
    functions = {},                
    keywords = {},                 
    variables = {},                 
    strings = { italic = true },            
  },
  
  transparent = false,              -- default: solid background
  dim_inactive = true,              -- default: dim inactive windows
  border_style = "rounded",
  
  plugins = {
    -- All enabled by default, set to false to disable
    telescope = true,
    nvimtree = true,
    treesitter = true,
    lsp = true,
    cmp = true,
    gitsigns = true,
    bufferline = true,
    indent_blankline = true,
  },
})

Configuration Options

Styles: Customize how different syntax elements appear Theme Options:

• transparent - Transparent background (default: false)
• dim_inactive - Dim inactive windows (default: true)

Plugin Integrations: Enable/disable specific plugins (all true by default)

Configuration Examples

No italic comments:

require('terracotta').setup({
  styles = {
    comments = {},  -- Remove default italic
  }
})

Bold functions + italic keywords:

require('terracotta').setup({
  styles = {
    functions = { bold = true },
    keywords = { italic = true },
  }
})

Transparent background:

require('terracotta').setup({
  transparent = true,
})

Lualine

require('lualine').setup {
  options = {
    theme = 'terracotta'
  }
}

License

MIT License - see LICENSE file for details