# Create and share a color scheme

**URL:** https://meta.discourse.org/t/create-and-share-a-color-scheme/61196
**Category:** Developer Guides
**Tags:** how-to
**Created:** [4월 18, 2017, 2:44오후 UTC](https://meta.discourse.org/t/create-and-share-a-color-scheme/61196 "2017-04-18T14:44:23Z")
**Posts on this page:** 2
**Page:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [4월 18, 2017, 2:44오후 UTC](https://meta.discourse.org/t/create-and-share-a-color-scheme/61196/1 "2017-04-18T14:44:23Z")

</div>

Discourse now supports importing color schemes from remote repository. Here I will demonstrate how you would go about doing this.

### Navigate to colors and add a color scheme.

Head to `/admin/customize/colors` on your site and create a color scheme.

 ![Creating a color scheme in the admin colors screen](https://global.discourse-cdn.com/meta/original/3X/b/7/b7fced237ee399d52c634a3ab6fcc9416db65605.png)

Tips:

- I used a chrome plugin ([color picker](https://chrome.google.com/webstore/detail/colorpick-eyedropper/ohcpnigalekghcmgcdcenkpelffpdolg?hl=en)) to select colors from an existing image of a palette on the web.

- If you create a theme, assign the color scheme to the theme and preview it, changes will be reflected live.

### Create a new git repository with the color scheme

```sh
mkdir my-awesome-scheme
cd my-awesome-scheme
git init .
vim about.json

```

For `about.json` add a skeleton config file

```json
{
  "name": "My awesome color schemes",
  "about_url": "",
  "license_url": "",
  "color_schemes": {}
}

```

Add a `LICENSE` file, I [usually use MIT](https://github.com/SamSaffron/discourse-solarized/blob/master/LICENSE)

```sh
vim LICENSE

```

### Push changes to GitHub

Check in all your changes:

```sh
git add LICENSE
git add about.json
git commit -am "first commit"

```

Create an account on [GitHub.com](https://github.com) and then create a new repository.

### (Optional) create a topic on Discourse as a home to discuss your colors

Ideally you would create a topic in the #Customization > Theme category with some screenshots of your color scheme. You will use this as your `about_url`

### Fill in the missing information in your about.json file

- Navigate to your LICENSE page on GitHub, fill in that URL as your `license_url`

- Either use the GitHub project URL or Discourse topic URL as your `about_url`

- Press `Copy to Clipboard` on your color scheme and paste that in to the color\_schemes section

At the end of the process your about.json file will look something like:

```json
{
  "name": "Solarized",
  "about_url": "https://github.com/SamSaffron/discourse-solarized",
  "license_url": "https://github.com/SamSaffron/discourse-solarized/blob/master/LICENSE",
  "color_schemes": {
    "Solarized Light": {
      "primary": "586E75",
      "secondary": "EEE8D5",
      "tertiary": "268BD2",
      "quaternary": "CB4B16",
      "header_background": "002B36",
      "header_primary": "93A1A1",
      "highlight": "B58900",
      "danger": "CB4B16",
      "success": "859900",
      "love": "DC322F"
    }
  }
}

```

Check in the change and push to GitHub

```sh
git commit -am "added more details"
git push

```

### Test your color scheme is correct

- Delete your local color scheme
- In the `admin/customize/theme` screen import your theme from GitHub

 ![Importing a theme from GitHub in the admin customize screen](https://global.discourse-cdn.com/meta/original/4X/c/1/d/c1de6b52ae98df03f557c91f1ae02251f08cda18.png)

- Visit `admin/customize/colors` and ensure your color scheme looks correct.

🎊

You can now easily share your color scheme with others!

See also:

> [@Structure of themes and theme components](https://meta.discourse.org/t/how-to-develop-custom-themes/60848):
>
> Discourse supports [native themes](https://meta.discourse.org/t/native-theme-support/47494/26) that can be sourced from a .tar.gz archive or from a remote git repository including [private repositories](https://meta.discourse.org/t/how-to-source-a-theme-from-a-private-git-repository/82584). An example theme is at: [GitHub - discourse/discourse-simple-theme: Sam's simple discourse theme · GitHub](https://github.com/SamSaffron/discourse-simple-theme) The git repository will be checked for updates ([once a day](https://github.com/discourse/discourse/blob/main/app/jobs/scheduled/check_out_of_date_themes.rb)), or by using the Check for Updates button. When changes are detected the Check for Updates button will change to the Update to Latest. [image] To create a theme you need to foll…

* * *

_Last Reviewed by @SaraDev on 2022-06-03T01:00:00Z_

* * *

This document is version controlled - suggest changes [on github](https://github.com/discourse/discourse/blob/main/docs/developer-guides/docs/05-themes-components/31-color-scheme.md).

---

<div class="post-metadata">

### Author: ![j127](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/j127/32/79093_2.png) [@j127](https://meta.discourse.org/u/j127)
#### Post date: [8월 1, 2025, 6:49오후 UTC](https://meta.discourse.org/t/create-and-share-a-color-scheme/61196/3 "2025-08-01T18:49:05Z")

</div>

> [@Discourse](#):
>
> ```plaintext
> {
> "name": "Solarized",
> "about_url": "https://github.com/SamSaffron/discourse-solarized",
> "license_url": "https://github.com/SamSaffron/discourse-solarized/blob/master/LICENSE",
> "color_schemes": {
> "Solarized Light": {
> "primary": "586E75",
> "secondary": "EEE8D5",
> "tertiary": "268BD2",
> "quaternary": "CB4B16",
> "header_background": "002B36",
> "header_primary": "93A1A1",
> "highlight": "B58900",
> "danger": "CB4B16",
> "success": "859900",
> "love": "DC322F"
> }
> }
> }
> 
> ```

거기에 추가할 수 있는 필드가 두 가지 더 있다고 생각합니다: `hover`와 `selected`입니다.
