> For the complete documentation index, see [llms.txt](https://zypec.gitbook.io/particles/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zypec.gitbook.io/particles/colors/adding-new-color-scheme.md).

# Adding New Color Scheme

This page was last updated for version v1.2.0

## Description

To create a new color scheme, add a new section with unique key to **colors** section in `colors.yml`. Then, copy the hex codes of the desired colors and paste them into the list. The larger the size value, the slower/softer the transition between colors will be. You can also set a display name for color schemes.

```yaml
color-scheme-key:
    name: "<NAME>"
    values: [ '<HEX>', '<HEX>', .. ]
    size: <INTEGER>
```

{% hint style="info" %}
You can pull a color name from the translations file. Putting the color name key between `%`, like  `%key%` will be replaced with the translation. You can repeat this as many times as you want.&#x20;

#### Examples

1. <pre class="language-yaml"><code class="lang-yaml"><strong>name: "&#x3C;gold>%color%: &#x3C;gradient:red:blue>%red-to-blue%" # &#x3C;gradient:red:blue> can be done with MiniMessage format 
   </strong></code></pre>
2. <pre class="language-yaml"><code class="lang-yaml"><strong>name: "&#x3C;gold>%color%: &#x3C;rainbow>%rainbow%" 
   </strong></code></pre>

#### Example Translation File

> File: `translations_en.yml`

```yaml
colors:
     color: "Renk"
     red-to-blue: "Kırmızı > Mavi"
     rainbow: "Rengarenk"
```

{% endhint %}

## Examples

{% tabs %}
{% tab title="colors.yml" %}

```yaml
colors:
  gradient-red-to-blue:
    name: "%gradient-red-to-blue%"
    values: [ '#FC5C7D', '#6A82FB' ]
    size: 50
  heart:
    name: "%heart%"
    values: [ '#f54242', '#fc9090' ]
    size: 7
  rocket:
    name: "<aqua>Rocket!"
    values: [ '#5bf5c7', '#42ff75', "#0eb33b", "#0eb381" ]
    size: 10
  christmas:
    name: "<gold>%color%: %christmas%"
    values: [ '#ef233c', '#d5f2e3', '#73ba9b', '#003e1f', '#d90429', '#823a14' ]
    size: 30
```

{% endtab %}
{% endtabs %}