# Theming overview

Source: https://docs.streamlit.io/develop/concepts/configuration/theming

In this guide, we provide an overview of theming and visual customization of Streamlit apps. Streamlit themes are defined using configuration options, which are most commonly defined in a `.streamlit/config.toml` file. For more information about setting configuration options, see [Working with configuration options](https://docs.streamlit.io/develop/concepts/configuration/options). For a complete list of configuration options and definitions, see the API reference for [config.toml](https://docs.streamlit.io/develop/api-reference/configuration/config.toml#theme).

You can configure a light and dark theme for your app that the user can change through the [app menu](https://docs.streamlit.io/develop/concepts/architecture/app-chrome#theme). The sidebar is separately
configurable from the main app for almost all theming options.

The following options can be set in the `[theme]` table of `config.toml` and can't be set separately in the sidebar, dark-theme, or
light-theme tables:

- **Base color scheme**: Set your custom theme to inherit from Streamlit's light or dark theme, or use an external theming TOML file.
- **Base font**: Set the base font weight and size. (This can be configured separately for heading and code font.)
- **Metric value font**: Set the font size and weight of `st.metric` values.
- **Sidebar border**: Set the visibility of the sidebar border.

The following options can be configured separately for the main body of your app and the sidebar. They can also be specified separately for
dark and light themes (`[theme.light]`, `[theme.light.sidebar]`, `[theme.dark]`, `[theme.dark.sidebar]`):

- **Font family**: Set the font family for body text, headings, and code.
- **Font style**: Set the weight and size of heading and code font, and set visibility of link underlines.
- **Text color**: Set the color of body, inline code, and link text.
- **Primary color**: Set the color of interactive elements and highlights.
- **Background color**: Set the color of app, widget, code block, and dataframe header backgrounds.
- **Border radius**: Set the roundness of elements and widgets.
- **Border color**: Set the color and visibility of element, widget, sidebar, and dataframe borders.
- **Basic color palette**: Set the color palette (red, orange, yellow, green, blue, violet, and gray/grey) for things like colored Markdown text and sparklines.
- **Chart color**: Set series colors for ECharts, Altair, Vega-Lite, and Plotly charts, including the simple chart commands like `st.line_chart`. Unset light, dark, and sidebar sections inherit from `[theme]`.
- **Padding**: Set the space between the header and the first element, and the space after the last element.

## Example themes

The following light theme is inspired by [Anthropic](https://docs.anthropic.com/en/home).
[Example app: doc-theming-overview-anthropic-light-inspired](https://doc-theming-overview-anthropic-light-inspired.streamlit.app/)

The following dark theme is inspired by [Spotify](https://open.spotify.com/).
[Example app: doc-theming-overview-spotify-inspired](https://doc-theming-overview-spotify-inspired.streamlit.app/)

## Working with theme configuration during development

Most theme configuration options can be updated while an app is running. This makes it easy to iterate on your custom theme. If you change your app's primary color, save your `config.toml` file, and rerun your app, you will immediately see the new color. However, some configuration options (like those in the `[server]` table) require you to restart the Streamlit server to reflect the updates. If in doubt, when updating your app's configuration, stop the Streamlit server in your terminal and restart your app with the `streamlit run` command.
