birta 0.7.0

<p align="center">
  <img src="assets/readme/birta-logo.png" width="120" alt="birta logo"/>
</p>

<h3 align="center">
  birta
</h3>

<p align="center">
  <em>from the Icelandic word for brighten and publish</em>
</p>

<p align="center">
  <sub>Live-reloading preview in your browser with GitHub-style rendering</sub>
</p>

<p align="center">
  <a href="https://crates.io/crates/birta">
    <img src="https://img.shields.io/crates/v/birta?style=for-the-badge&colorA=363a4f&colorB=a3d5d4" alt="crates.io"/>
  </a>
  &nbsp;
  <a href="https://github.com/hugvit/homebrew-tap">
    <img src="https://img.shields.io/badge/homebrew-tap-ffdd98?style=for-the-badge&colorA=363a4f" alt="Homebrew"/>
  </a>
  &nbsp;
  <a href="https://github.com/hugvit/birta/blob/main/LICENSE">
    <img src="https://img.shields.io/github/license/hugvit/birta?style=for-the-badge&colorA=363a4f&colorB=c4d9a7" alt="License"/>
  </a>
</p>

<!-- TODO: Add hero screenshot
<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/hugvit/birta/main/assets/readme/screenshot-dark.png"/>
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/hugvit/birta/main/assets/readme/screenshot-light.png"/>
    <img src="https://raw.githubusercontent.com/hugvit/birta/main/assets/readme/screenshot-light.png" width="700" alt="birta preview"/>
  </picture>
</p>
-->

&nbsp;

## Features

- **GitHub-style rendering** — full GFM compliance via comrak, including tables, task lists, footnotes, alerts, and math
- **Live reload** — file changes push to the browser instantly over WebSocket
- **Raw mode** — toggle between rendered preview and syntax-highlighted source with line numbers
- **11 bundled themes** — github, catppuccin, dracula, gruvbox, nord, rose-pine, tokyo-night, and more, with runtime hot-swap
- **Syntax highlighting** — server-side via syntect, with per-theme tmTheme support
- **Reading mode** — distraction-free viewing with scroll progress indicator
- **Single binary** — no runtime dependencies, no Node.js, no Python
- **Directory navigation** — relative markdown links are clickable, letting you browse across files in a project
- **Static export** — render a self-contained, portable HTML bundle of a file and everything it links to, with assets copied in — no server required
- **Interactive checkboxes** — click task list items in the browser to toggle them in the source file
- **Stdin support** — pipe markdown from any source: `cat notes.md | birta -`

&nbsp;

## Quick Start

```bash
cargo install birta
birta README.md
```

Your browser opens with a live preview. Edit the file — the browser updates automatically.

&nbsp;

## Installation

<details open>
<summary>Cargo</summary>

```bash
cargo install birta
```

</details>

<details>
<summary>Homebrew</summary>

```bash
brew install hugvit/tap/birta
```

</details>

<details>
<summary>From source</summary>

```bash
git clone https://github.com/hugvit/birta.git
cd birta
cargo install --path .
```

</details>

&nbsp;

## Usage

Preview a file with the default theme (github):

```bash
birta README.md
```

Use a specific theme in light mode:

```bash
birta --theme catppuccin --light README.md
```

View the raw markdown source with syntax highlighting:

```bash
birta --raw README.md
```

Distraction-free reading:

```bash
birta --reading-mode --no-header README.md
```

Preview from stdin:

```bash
cat notes.md | birta -
```

Export a self-contained static bundle (crawls relative `.md` links, copies assets):

```bash
birta --static README.md                 # writes a temp birta-README/ folder and opens it
birta --static --out ./site README.md    # writes the bundle to ./site
```

The bundle mirrors your source tree as `.html` files with relative links, so it works offline and can be zipped or moved.

List all available themes:

```bash
birta --list-themes
```

Run `birta --help` for the full flag reference.

&nbsp;

## Themes

<!-- TODO: Add theme screenshots in accordions
<details>
<summary>GitHub (default)</summary>
<img src="https://raw.githubusercontent.com/hugvit/birta/main/assets/readme/theme-github.png" alt="GitHub theme"/>
</details>

<details>
<summary>Catppuccin</summary>
<img src="https://raw.githubusercontent.com/hugvit/birta/main/assets/readme/theme-catppuccin.png" alt="Catppuccin theme"/>
</details>

<details>
<summary>Dracula</summary>
<img src="https://raw.githubusercontent.com/hugvit/birta/main/assets/readme/theme-dracula.png" alt="Dracula theme"/>
</details>
-->

Bundled: `github` `catppuccin` `dracula` `gruvbox` `monokai` `night-owl` `nord` `one-dark` `rose-pine` `synthwave-84` `tokyo-night`

Themes with both light and dark variants get a toggle in the header. Switch themes at runtime from the dropdown — no restart needed.

Custom themes go in `~/.config/birta/themes/` as TOML files. See the [bundled themes](https://github.com/hugvit/birta/tree/main/assets/themes) for the format.

&nbsp;

## Configuration

Persistent settings live in `~/.config/birta/config.toml`:

```toml
port = 3000

[theme]
name = "catppuccin"

[font]
body = "Georgia, serif"
mono = "JetBrains Mono, monospace"

[keybindings]
toggle_reading = "r"       # reading mode
toggle_dark = "d"          # light/dark toggle
toggle_raw = "u"           # preview/raw toggle
focus_theme = "t"          # open theme picker
```

All settings can be overridden with CLI flags. Keybindings support modifiers: `--bind toggle_raw=Alt+u`. Run `birta --help` for the complete list.

&nbsp;

## Neovim

The Neovim plugin lives in a separate repo: [birta.nvim](https://github.com/hugvit/birta.nvim)

```lua
-- lazy.nvim
{
  "hugvit/birta.nvim",
  cmd = { "Birta" },
  opts = {
    theme = "catppuccin",
  },
}
```

Most flags can be accessed through the plugin's config.
&nbsp;

## License

[MIT](LICENSE)