Skip to content

Latest commit

 

History

History
294 lines (240 loc) · 15.1 KB

README.md

File metadata and controls

294 lines (240 loc) · 15.1 KB

Tinted Theming: all your themes, everywhere.

Color wheel

Style systems and smart build tooling for crafting high fidelity color schemes and easily using them in all your favorite apps. Originally based on the amazing work of Chris Kempson and his Base16 system.

Features

  • Seamless builder support for multiple style systems (Base16, Base17, Base24, BaseNext DRAFT, etc.)
  • Over 230 beautiful and ready-to-use color schemes. View the Gallery.
  • Over 70 supported GUI and terminal applications. See the full list.
  • Allows end users to choose a color scheme and know it will be available everywhere.
  • Allows color scheme designers to craft a palette of colors once, instantly supporting for many different apps.

Base24 Compatibility

The aim of this project is to offer compatibility with base16. The only limitation is that a base24 builder is needed for base24 templates.

Theme Template Base16 Builder Base24 Builder
Base16 Base16 ✔️ ✔️
Base24 Base16 ✔️ ✔️
Base16 Base24 ✔️
Base24 Base24 ✔️

Documentation and Specification

The builder and styling specs detail how to compile schemes and templates into application specific configurations.

Scheme

A scheme is a fixed palette of named colors and (optionally) instructions for how those colors should be used by apps.

Style

A style guide provides rules governing how a scheme's palette should be applied within apps. This means each color is used consistently for similar purposes across all your apps. Individual styling guides often support different sized pallets and have different ideas about how those colors should be deployed.

See the individual styling guides for more information on each:

  • Base16 - the original, 16 colors with very fixed semantic meanings.
  • Base17 - our evolution of Base16. It's still 16 colors, but far more power and flexibility to create higher fidelity themes and templates.
  • Base24 Hey that's this repo! - an extra 8 colors for full ANSI support in your terminals.
  • BaseNext DRAFT - as many colors as you want, along with the flexibility and complexity.

A scheme is defined using a YAML file. The file specification is in the Builder Guidelines.

Builder

A builder is a build tool used by various template repositories to generate files based on scheme file and template file.

Template

A template describes how a scheme should be transformed to support a specific application. A template repository defines a template file, then uses a builder to generate application specific files using the template.

Templates often include ready-to-use pre-built versions of every scheme. These are typically installed directly by end users to use the schemes in different applications.

Supported Applications (Base24)

To add your own template, submit a pull request to URL and add your repository to the list below. Repository naming scheme: base24-[template-name] (with dashes as separators).

Existing Base16 Templates (Base16)

Scheme Repositories

To add your own scheme, submit a pull request to URL and add your repository to the list below. Repository naming scheme: base24-[scheme-name]-scheme (with dashes as separators).

Generated from existing themes

Existing Base16 Schemes

Builder Repositories

Repository naming scheme: base24-builder-[language] (with dashes as separators). The separate headings are the latest versions of the spec supported by each builder.

Download

Clone

Using The Command Line

  1. Press the Clone or download button in the top right
  2. Copy the URL (link)
  3. Open the command line and change directory to where you wish to clone to
  4. Type 'git clone' followed by URL in step 2
git clone https://github.com/tinted-theming/Base24

More information can be found at https://help.github.com/en/articles/cloning-a-repository

Using GitHub Desktop

  1. Press the Clone or download button in the top right
  2. Click open in desktop
  3. Choose the path for where you want and click Clone

More information can be found at https://help.github.com/en/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop

Download Zip File

  1. Download this GitHub repository
  2. Extract the zip archive
  3. Copy/ move to the desired location

Community

Licence

MIT License (See the LICENSE for more information.)

Changelog

See the Changelog for more information.

Project Chat

Have something you want to discuss, but you're not sure it warrants an issue? Feel free to stop by the #base16 channel on Libera Chat or the bridged Matrix channel to talk about it.

Credits