# Pimp My DocC Documentation

Documentation webpages produced by DocC come with a default visual styling that is, I feel sorry to say it, boring. Callouts are not colorized per default (exception: warning)

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1678088827408/fcab1523-3def-49a0-bdfd-d8d9061f1635.png align="center")

In this blog post, I'll talk about how to customize the appearance of your documentation pages. These customization options are <mark>available with Swift 5.8</mark>, distributed with Xcode 14.3 (Beta).

You don't have to change the generated HTML / CSS, which is great news. You adjust the styling by adding a `theme-settings.json` file to the root of your documentation catalog.

Let's add a dash of color to a tip callout. A callout is named "aside" in DocC. To colorize the border of the tip aside:

```json
{
  "theme": {
    "color": {
        "aside-tip-border": "rgb(0, 124, 55)"
    }
  }
}
```

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1678088849895/3b039c76-b28b-49cc-a709-f343c4a93442.png align="center")

Let's make it more colorful by applying a background color

```json
{
  "meta": {},
  "theme": {
    "color": {
        "aside-tip-border": "rgb(0, 124, 55)",
        "aside-tip-background": "rgb(0, 124, 55, 0.5)"
    }
  }
}
```

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1678088860170/caa42064-98c1-4af8-b5d6-83e8acf6cd52.png align="center")

I hope the DocC renderer will create default colors for asides one day. There is an open GitHub issue 🤞

%[https://github.com/apple/swift-docc-render/issues/399] 

You saw that it is possible to customize a specific element (here: aside), but you can change the appearance of more elements and colors/fonts globally.

![](https://www.swift.org/images/theme-screenshot-02.png align="center")

The [Open API specification](https://github.com/apple/swift-docc/blob/main/Sources/SwiftDocC/SwiftDocC.docc/Resources/ThemeSettings.spec.json) for the `theme-settings.json` file is pretty neat. Even more helpful is the complete example of a fully customized documentation website which is mentioned in the [Customizing the Appearance of Your Documentation Pages](https://www.swift.org/documentation/docc/customizing-the-appearance-of-your-documentation-pages) article on swift.org.