Lightline themes

Creating styles

Before creating a lightline theme, you need at least one color palette in the estilos/palettes directory. Then create your lightline style as a .yml file inside the estilos/lightline folder, and paste this content:

normal1: ""
normal2: ""
normal3: ""
normal4: ""
normal5: ""
normalError: ""
normalWarning: ""
inactive1: ""
inactive2: ""
inactive3: ""
inactive4: ""
inactive5: ""
insert1: ""
insert2: ""
insert3: ""
insert4: ""
insert5: ""
replace1: ""
replace2: ""
replace3: ""
replace4: ""
replace5: ""
visual1: ""
visual2: ""
visual3: ""
visual4: ""
visual5: ""
tablineLeft: ""
tablineSelected: ""
tablineMiddle: ""
tablineRight: ""

Every property in the template is composed of a name and a number, which represent how a part of the status line will look in a particular Vim mode. The first line defines the style of part 1 of the bar in normal mode.

Part 1 represents the first block of the status bar, part 2 the second, and so on. The normalError and normalWarning properties affect block 3 in those states.

The last four lines define the tabline style:

Go to the first definition and fill in its value inside the quotes (''). Write the foreground and background color names separated by a space (these should be in your color template). It should look something like this:

normal1: "myblue mydark"

Add theme to estilo.yml

Open the estilo.yml file and add an object for each theme with its parameters inside the lightline list. Each theme has 3 parameters:

• name: the name of the lightline theme (should not have spaces or dashes -)
• palette: the name of the color palette (same as the file inside the palettes folder without the .yml extension)
• style: same as the file inside the lightline folder without the .yml extension

Example:

lightline:
  - name: "awesome-night"
    palette: "awesome"
    style: "night"
  - name: "awesome-day"
    palette: "awesome"
    style: "day"

Render

From the command line in the project folder:

estilo render

Rendered files will be in the plugins folder of your project.

Activating the theme

Open your Vim config file and add these lines:

" Enable lightline theme
let g:PKG_NAME_lightline = 1
" Set lightline theme (in your lightline config)
let g:lightline = { 'colorscheme': 'MY_THEME_NAME' }

Replace PKG_NAME with the name of your project (the name from estilo.yml), and MY_THEME_NAME with the name of the Lightline theme you want to activate.

Remember to add instructions to the README of your project before publishing it.