A theme system that any host application can opt into.

Pote.Theme is the core contract: it defines a behaviour that host apps can adopt via use Pote.Theme, ... to get a fully functional theme system without writing any boilerplate.

Quick start for host apps

defmodule MyApp.Theme do
  use Pote.Theme,
    config_app: :my_app,
    storage_dir: "~/.config/my_app/themes",
    defaults: %{
      "primary" => {0, 120, 215},
      "accent" => {255, 90, 50},
      "background" => {24, 24, 28},
      "text" => {240, 240, 245}
    }
end

That's it — MyApp.Theme now exposes:

MyApp.Theme.list()           # => ["default", "dracula", "monokai", ...]
MyApp.Theme.active()         # => %Pote.Theme{...} (the active theme)
MyApp.Theme.activate("dracula")
MyApp.Theme.color("primary") # => {0, 120, 215}
MyApp.Theme.colors()         # => %{"primary" => {0, 120, 215}, ...}
MyApp.Theme.install!(MyApp.Theme.templates().dracula)

Integration with Pote's color parser

When a host app uses use Pote.Theme, the theme resolver is automatically registered with Pote.put_theme_resolver/1 so that Pote.parse("theme:primary") (and Pote.parse(:primary)) consult the active theme — no extra wiring needed.

This is the mechanism that makes alaja separator --color "theme:primary", Flotilla.Components.text("hi", color: "theme:primary") and any other Pote-aware UI all read from the same active theme.

On-disk format

Each theme is a JSON file under storage_dir:

{
  "name": "dracula",
  "description": "Dracula colour palette",
  "colors": {
    "primary": [189, 147, 249],
    "accent": [255, 121, 198],
    ...
  }
}

Built-in themes

The default install (use Pote.Theme) ships with a small palette (default, dracula, monokai, nord, light) so the system is useful out of the box. Use MyApp.Theme.templates/0 to inspect them and MyApp.Theme.install!/2 to write them to disk.

See Pote.Theme.Templates for the full list.