# Themes

Source: https://docs.bearletter.com/blog/themes

The whole look of a blog is `styles.css`. Choosing a theme in the dashboard replaces this file with the theme's stylesheet; after that it is yours. Editing it needs Pro.

## Variables

Every built-in theme starts with one `:root` block of variables. The dashboard's Appearance controls change `--accent`, `--width`, `--font-body` and `--font-size` there and leave the rest alone, so keep that block first.

```css
:root {
  --width: 760px;
  --font-body: Georgia, "Songti SC", serif;
  --font-heading: var(--font-body);
  --font-size: 18px;
  --bg: #fffdf8;
  --text: #2e2b3a;
  --heading: #1d1b26;
  --link: #1d1b26;
  --muted: #4a4658;
  --rule: #e2ddcf;
  --code-bg: #f3efe3;
  --accent: #4b3fd1;
}
```

Themes may add their own variables (Bold has `--band` and `--marker`; Poster has `--panel` and `--accent-text`).

## Light and dark

A theme follows the reader's system. Put the dark values in a media query after the first block:

```css
@media (prefers-color-scheme: dark) {
  :root {
    --bg: #17151f;
    --text: #e4e0d6;
    --heading: #fffdf8;
    --link: #fffdf8;
  }
}
```

A color used for text on a fill (such as dark ink on a yellow button) can stay the same in both modes.

## Page structure

Every page has the same frame:

```html
<body class="post">
  <header class="site-header">
    <a class="title" href="/">Blog name</a>
    <nav class="site-nav">…</nav>
  </header>
  <main>…</main>
  <footer class="site-footer">…</footer>
  <p class="powered-by">…</p>
</body>
```

The body's class says what the page is: `home`, `post`, `page`, `archive`, `directory`, `not-found`, `podcast-show`, plus an article's own `class_name`.

Class names worth styling:

- Lists: `.blog-posts`, `.post-date`, `.post-title`, `.post-description`
- Articles: `.post-meta`, `.tags`, `.post-header`, `.post-footer`, `.sidebar`, `.content`
- Archive: `.archive-filters`, `.archive-search`, `.topic-links`, `.search-status`
- Components: `.subscribe`, `.reply-by-email`, `.social`, `.like-button`
- Podcast: `.podcast-header`, `.podcast-cover`, `.podcast-player`, `.player-play`, `.player-seek`, `.podcast-subscribe`, `.episode-list`, `.episode-title`, `.episode-meta`

Elements inside articles are plain HTML (`h1`–`h4`, `p`, `blockquote`, `pre`, `code`, `table`, `img`, `hr`), so style them by tag.

## Checking a change

Try a stylesheet before saving it: the dashboard's theme cards open a preview of your own blog with that theme, and nothing changes until you choose it.
