Skip to content

her/enlighten

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

91 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Enlighten - A Lighter Theme

Currently a work in progress.

Finished:

In Progress:

  • A color scheme with multiple language & highlight group support - enlighten.vim
  • Accessibility for users across all color scheme implementations.

enlighten.terminal πŸ‘©β€πŸŽ¨

Download enlighten.terminal and open it with Terminal.app to auto import.

curl -fLo ~/Downloads/enlighten.terminal \
  https://raw.githubusercontent.com/her/enlighten/master/enlighten.terminal

But Why?

Research has shown that text is easier to read on a light background. Users make less mistakes and it's easier on the eyes. However, most themes for both terminal emulators and text editors across the internet cater towards light text on a dark background.

The goal of this project is to develop the world's most beautiful and legible light theme for every day use. It should be accessible to everyone, adaptable to the user, and available on as many platforms as possible. Color choices should be based on a model of readability, easy discernment, and wherever possible should use color theory and science to lead development decisions.

This project is in it's early stages and I wouldn't say that it currently lives up to the stated goals. Going forward changes and developments should seek to uphold the ideals of this project by following it's goals.

Accessibility

Regular Bright
#000000 Black #666666 Bright Black
#B83520 Red #D84D62 Bright Red
#268800 Green #5EB055 Bright Green
#C1512C Yellow #DFC240 Bright Yellow
#2C69EE Blue #4D7DEA Bright Blue
#722ECF Magenta #C990F8 Bright Magenta
#408065 Cyan #55B0B2 Bright Cyan
#A3AFB6 White #FEFBED Bright White

Minimum contrast ratio requirements for AA grade
Normal text - 4.5:1
Large text - 3:1

Minimum contrast ratio requirements for AAA grade
Normal text - 7:1
Large text - 4.5:1

βœ… - Pass
❌ - Fail

Passing requirements for color and brightness:
Color Difference - Minimum 500
Brightness Difference - Minimum 125

πŸ‘ - Pass
⚠️ - Fail

Compared against a background color of #FFFFFF

Examle of accessible color meansurement values:

Grade Contrast Ratio Color Difference Brightness Difference
AAA 21:1 765 255

As a list:
AAA, 21:1, 765, 255

#000000 Black #000000 βœ… πŸ‘
AAA, 21:1, 765, 255

#C30600 Red #C30600 βœ… πŸ‘
AA, 6.3:1, 564, 194

#007E00 Green #007E00 βœ… πŸ‘
AA, 5.3:1, 639, 182

#CD7F40 Yellow #CD7F40 ❌ ⚠️
Fail, 3.1:1, 369, 112

#006A9D Blue '#006A9D' βœ… πŸ‘
AA, 5.9:1, 502, 175

#3C2DA2 Magenta #3C2DA2 βœ… ⚠️
AAA, 10.1:1, 498, 193

#306B6A Cyan #306B6A βœ… πŸ‘
AA, 6.1:1, 504, 166

#A3AFB6 White #A3AFB6 ❌ ⚠️
Fail, 2.2:1, 245, 83

#666666 Bright Black #666666 βœ… ⚠️
AA, 5.7:1, 459, 153

#EC0000 Bright Red #EC0000 βœ… πŸ‘
AA, 4.6:1, 529, 185

#008500 Bright Green #008500 βœ… πŸ‘
AA, 4.8:1, 632, 177

#E9AD53 Bright Yellow #E9AD53 ❌ ⚠️
Fail, 2:1, 276, 75

#1761BE Bright Blue #1761BE βœ… ⚠️
AA, 6:1, 455, 170

#B20F4A Bright Magenta #B20F4A βœ… ⚠️
AA, 6.9:1, 498, 185

#276F6F Bright Cyan #276F6F βœ… πŸ‘
AA, 5.9:1, 504, 166

#FFFFFF Bright White #FFFFFF ❌ ⚠️
Fail, 1:1, 0, 0

Notes on Grading

AAA grade is given for passing all the above requirements.
AA grade will be given for passing Normal Text requirements.

⚠️ Careful consideration before use. Against another listed color this may be fine to use, but you should take into account the user.

Included Highlight Groups

Ruby, Python, Javascript, JSON, SQL, YAML, XML, HTML, CSS, Markdown, Shell, Vim's defaults (Language Constructs, Variable Types, C Family), netrw.

Will add other highlight groups once the above are completed. Possibly next being, Perl, php. Also am considering other add-on syntax groups like NGINX or Docker (which would require extending vim with a syntax library for these technologies).

Notes

Valuable Vim Docs

:h group-name :h highlight-groups :h cterm-colors

If editing a colorscheme this applies it to the current buffer

:w :so %

Output all the current highlight groups

:so $VIMRUNTIME/syntax/hitest.vim

Colour Contrast Analyser

Color Oracle

Color Usage Research Lab

https://colorusage.arc.nasa.gov/GuidelinesHierarchy.php

About

🎨 Enlighten

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published