# Colors Usage

Within Shimoku you can use the different style tokens for components such as charts or html. This allows consistency to be maintained and makes it easy for Theme changes to be uncomplicated.

From the [theming](https://docs.shimoku.com/dev/building-web-app/theming) json you can change the hexes to adapt them to your color palette.

{% hint style="danger" %}
**DO NOT MODIFY the Variable name**
{% endhint %}

{% hint style="info" %}
Use the variable name within your graphics or html for consistency.
{% endhint %}

{% hint style="info" %}
To easily modify the styles **change the HEX color of the variable**. Check that the affected components are displayed correctly as you want.
{% endhint %}

For ease of use an enumerator can be used where all these names are already defined, you can import it from the library like this:&#x20;

```python
from shimoku import ShimokuPalette
```

### Main palette

<table><thead><tr><th width="77">Preview</th><th>Color name</th><th width="113">HEX</th><th width="252">Variable name</th><th>Comments</th></tr></thead><tbody><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FD6VElEv6PjUatuKJU1bP%2Fimage.png?alt=media&#x26;token=5d8ce817-5816-485d-9794-a8c4509dff4a" alt="" data-size="line"></td><td>Color primary</td><td>#002FD8</td><td>var(--color-primary)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FZ234yukrJoIcMsgb1wKk%2Fimage.png?alt=media&#x26;token=a2d5d639-8131-4728-a97b-756a884dd0f7" alt="" data-size="line"></td><td>Color primary light</td><td>#B8C7F9</td><td>var(--color-primary-light)  </td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2F8pyJA4ueul5VsvEdY8H0%2Fimage.png?alt=media&#x26;token=7574815e-673e-4322-9e74-876780ffc3fc" alt="" data-size="line"></td><td>Color primary dark</td><td>#0315B9</td><td>var(--color-primary-dark) </td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FWjIQmfpe1xZdQVEF1XXW%2Fimage.png?alt=media&#x26;token=5f3f4264-1d63-462d-9d1b-04f17873a02c" alt="" data-size="line"></td><td>Color secondary</td><td>#29D86F</td><td>var(--color-secondary)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FXe2ciFZJejJAtxlPvm12%2Fimage.png?alt=media&#x26;token=9e1a1b71-9764-42f1-ad59-3475e8323185" alt="" data-size="line"></td><td>Color secondary light</td><td>#C7F0D8</td><td>var(--color-secondary-light) </td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2Fsqv1cfLwE4WBk3V4IxFn%2Fimage.png?alt=media&#x26;token=bc13782e-6156-46fd-8d89-73c01c54e2dd" alt="" data-size="line"></td><td>Color secondary dark</td><td>#09B85A</td><td>var(--color-secondary-dark) </td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FRKVeThDS9iYct8nKsKRO%2Fimage.png?alt=media&#x26;token=ab341f33-b01f-4123-a022-5ac0240a5f9c" alt="" data-size="line"></td><td>Color success</td><td>#2e7d32</td><td>var(--color-success)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FENmDIL3oRU31552icQPr%2Fimage.png?alt=media&#x26;token=96e75126-a34f-4124-9abb-09b68647f1fc" alt="" data-size="line"></td><td>Color success light</td><td>#4caf50</td><td>var(--color-success-light)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FfHZBR2QciEbPK3kBkHf3%2Fimage.png?alt=media&#x26;token=4c7d7af4-bc4d-4606-808c-0fe37e942f5d" alt="" data-size="line"></td><td>Color warning</td><td>#ed6c02</td><td>var(--color-warning)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2F7CvhDtb66OVtYtcQJlRo%2Fimage.png?alt=media&#x26;token=c50d11a8-f3bd-4f5e-b21c-83a2c7f0ac4b" alt="" data-size="line"></td><td>Color warning light</td><td>#ff9800</td><td>var(--color-warning-light)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2Fl4rQPwFA1LiiZLRnxWMW%2Fimage.png?alt=media&#x26;token=8c4b2219-0b64-4222-81c8-c612ea134c7d" alt="" data-size="line"></td><td>Color error</td><td>#d32f2f</td><td>var(--color-error)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FcXrinwsfNYlrF14FKSL7%2Fimage.png?alt=media&#x26;token=abfd183e-ed33-42b6-8fa1-6ac31f59aa04" alt="" data-size="line"></td><td>Color error light</td><td>#ef5350</td><td>var(--color-error-light)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FOM5ACsoO1TKaFajOkZ4i%2Fimage.png?alt=media&#x26;token=09c40328-21b2-4dc1-9b03-474a70e47b40" alt="" data-size="line"></td><td>Color status error</td><td>#F76868</td><td>var(--color-status-error)</td><td></td></tr><tr><td></td><td>Color white</td><td>#FFFFFF</td><td>var(--color-white)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FKSoBESpVWS8srpEddM6X%2Fimage.png?alt=media&#x26;token=58135ed7-5978-41f3-91a9-797cca2e4c13" alt="" data-size="line"></td><td>Color black</td><td>#202A36</td><td>var(--color-black)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FKSoBESpVWS8srpEddM6X%2Fimage.png?alt=media&#x26;token=58135ed7-5978-41f3-91a9-797cca2e4c13" alt="" data-size="line"></td><td>Color base  icon</td><td>#202A36</td><td>var(--color-base-icon)</td><td></td></tr><tr><td></td><td>Color background-default</td><td>#FFFFFF</td><td>var(--background-default)</td><td></td></tr><tr><td></td><td>Color Background paper</td><td>#FFFFFF</td><td>var(--background-paper)</td><td></td></tr></tbody></table>

### Complementary & Chart series colors

<table><thead><tr><th width="83">Preview</th><th>Color name</th><th width="112">HEX</th><th width="285">Variable</th><th>Comments</th></tr></thead><tbody><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2F2ntF0YVYzpVoIPYlgzSD%2Fimage.png?alt=media&#x26;token=985379a1-a4f7-4ff1-9c5c-07a3002bfd1e" alt="" data-size="line"></td><td>Complementary red</td><td>#EE3A4F</td><td>var(--complementary-red)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2F36HKw3Lj4PrntY21Rooy%2Fimage.png?alt=media&#x26;token=23130ee4-fdcf-434c-ad0b-9d83376f7773" alt="" data-size="line"></td><td>Complementary red light</td><td>#F86C7D</td><td>var(--complementary-red-light)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FvACuuUVsGxUqU2LqUpdr%2Fimage.png?alt=media&#x26;token=408d78bc-fb8f-43b9-9ccd-36de61b8e173" alt="" data-size="line"></td><td>Complementary green</td><td>#2ED020</td><td>var(--complementary-green)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2F7yJ71yNwWPfySVi6lCaz%2Fimage.png?alt=media&#x26;token=6b7c3c56-79ab-4fd3-9d10-a112af63f4ea" alt="" data-size="line"></td><td>Complementary yellow</td><td>#F3B922</td><td>var(--complementary-yellow)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FIBsJtMRJSWjbHBlDaFl2%2Fimage.png?alt=media&#x26;token=ab1313b7-7128-4e19-b179-ca7a3cb1b826" alt="" data-size="line"></td><td>Complementary orange</td><td>#ED5627</td><td>var(--complementary-orange)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FN4J8ilF3mUjQHyS90unf%2Fimage.png?alt=media&#x26;token=d503ce9b-fd65-4071-89ef-4880cb68fbfc" alt="" data-size="line"></td><td>Complementary aqua</td><td>#20C69E</td><td>var(--complementary-aqua)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FY7wzrar8gnDWtfyAFoWd%2Fimage.png?alt=media&#x26;token=f1e9f66e-0e50-4a9e-9c82-b3d025e00645" alt="" data-size="line"></td><td>Complementary violet</td><td>#7208B4</td><td>var(--complementary-violet)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FvUnrF2S3O3BGIeTm38Kk%2Fimage.png?alt=media&#x26;token=e22df448-8535-4d12-9864-55539494eb26" alt="" data-size="line"></td><td>Chart C1</td><td>#4C72F9</td><td>var(--chart-C1)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2Fursm4U09b7zASID77yhY%2Fimage.png?alt=media&#x26;token=b97315a1-6046-47c2-8a88-a57889ff1ba4" alt="" data-size="line"></td><td>Chart C2</td><td>#74D890</td><td>var(--chart-C2)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FGTVUARSHPjbGeKdHF8X6%2Fimage.png?alt=media&#x26;token=deecdaec-ffa3-424b-9f6a-2a510aa21f4f" alt="" data-size="line"></td><td>Chart C3</td><td>#F2BB67</td><td>var(--chart-C3)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FtDI7A6wLz9Gz3jtJbYCm%2Fimage.png?alt=media&#x26;token=521de0fb-9abd-4587-a1ac-b28bdfe71ea1" alt="" data-size="line"></td><td>Chart C4</td><td>#F78A68</td><td>var(--chart-C4)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FKGfMBcFU4PxYwpaRmQ9P%2Fimage.png?alt=media&#x26;token=67271a78-46ee-4ddf-8913-6598e2ad6bc2" alt="" data-size="line"></td><td>Chart C5</td><td>#C6E2E9</td><td>var(--chart-C5)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FEAqnm8ZjZ6jpklUHFgx3%2Fimage.png?alt=media&#x26;token=7cddf2a1-6237-4bf7-ac6e-3544773f7c95" alt="" data-size="line"></td><td>Chart C6</td><td>#9BA4F5</td><td>var(--chart-C6)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FCc24Kh4JZgROhNX7SrIb%2Fimage.png?alt=media&#x26;token=0c119526-c9ab-40cc-a148-5e34563c70f0" alt="" data-size="line"></td><td>Chart C7</td><td>#EAB8CD</td><td>var(--chart-C7)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FgnTc1JpTz2xnuH1Qy4eJ%2Fimage.png?alt=media&#x26;token=8e361140-b445-49a7-be3e-4239ea6b945e" alt="" data-size="line"></td><td>Chart C8</td><td>#D28AC7</td><td>var(--chart-C8)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FnJ2XxiHeSyUXCnBEWONF%2Fimage.png?alt=media&#x26;token=02068fd0-4481-4a6d-af2e-583397a9a041" alt="" data-size="line"></td><td>Chart C9</td><td>#B6AFD0</td><td>var(--chart-C9)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FFWLuKvsIrdF5dpEKza0O%2Fimage.png?alt=media&#x26;token=3fd79746-7fdd-4031-9946-6774c617b9cb" alt="" data-size="line"></td><td>Chart C10</td><td>#4C5AA4</td><td>var(--chart-C10)</td><td></td></tr></tbody></table>

### Grey

<table><thead><tr><th width="98">Preview</th><th width="133">Color name</th><th width="113">HEX</th><th width="219">Var</th><th>Comments</th></tr></thead><tbody><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FfnOplLT26MiuGMLfymfh%2Fimage.png?alt=media&#x26;token=bcf5d801-4175-4ade-acda-0f55347c587d" alt="" data-size="line"></td><td>Grey50</td><td>#fafafa</td><td>var(--color-grey-50)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2F5e1j0wJN4qFXmHPyIyDg%2Fimage.png?alt=media&#x26;token=dad9a3e5-1c25-4e04-8e2b-9eff86cd80e8" alt="" data-size="line"></td><td>Grey100</td><td>#FAFAFB</td><td>var(--color-grey-100)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2Fub0zSjW8Vji34xgosAzf%2Fimage.png?alt=media&#x26;token=03375b90-3392-43af-9b0d-120c3683b018" alt="" data-size="line"></td><td>Grey200</td><td>#F1F1F5</td><td>var(--color-grey-200)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FZdJKuQP9ipSlf2hynNPD%2Fimage.png?alt=media&#x26;token=ab277843-630e-4c8d-80dc-0ab02ffeaa83" alt="" data-size="line"></td><td>Grey300</td><td>#E2E2EA</td><td>var(--color-grey-300)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FQp8OB7e4wOid1UW7cJe9%2Fimage.png?alt=media&#x26;token=5e1b2035-c565-44a4-9605-e465ef9a3293" alt="" data-size="line"></td><td>Grey400</td><td>#D5D5DC</td><td>var(--color-grey-400)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FIJplrAMFig4vZDNadHhF%2Fimage.png?alt=media&#x26;token=0c3a7625-bc30-49c5-9cd9-bae55d4784e7" alt="" data-size="line"></td><td>Grey500</td><td>#AEAEAE</td><td>var(--color-grey-500)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FrXg3uBgyhB0b3QsQgdGo%2Fimage.png?alt=media&#x26;token=17de0197-6837-42b9-912b-7eb4bce9aa20" alt="" data-size="line"></td><td>Grey600</td><td>#92929D</td><td>var(--color-grey-600)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2FbVzLfsXidNDJ9SLSIc3U%2Fimage.png?alt=media&#x26;token=5468c3af-a480-4cc5-bfee-a0c7ef47fae6" alt="" data-size="line"></td><td>Grey700</td><td>#696974</td><td>var(--color-grey-700)</td><td></td></tr><tr><td><img src="https://3782181538-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUlHTfmIZY46Z1EDfyGMz%2Fuploads%2F08sNzAkmfYwtxN48FdwP%2Fimage.png?alt=media&#x26;token=27a3cdf4-6714-4b9b-9e37-dda7110f49bc" alt="" data-size="line"></td><td>Grey800</td><td>#44444F</td><td>var(--color-grey-800)</td><td></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.shimoku.com/dev/building-web-app/theming/colors-usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
