Skip to content

Quick start

  1. Verify that the installed command resolves.

    Terminal window
    tman --version
  2. Generate the default material source from a seed and Material variant.

    Terminal window
    tman generate --color "#6750A4" --variant "Tonal spot"

    One run writes light and dark source files for every generation-capable adapter. See generated paths for the source/destination model.

  3. Select the active theme family and apply an initial mode.

    Terminal window
    tman select --theme material --dark

    Selection persists material as the single activeTheme only after at least one adapter succeeds.

  4. Switch modes without changing theme identity.

    Terminal window
    tman apply --light
    tman apply --dark

    This non-interactive command is the integration point for theme daemons and desktop appearance hooks. A target may skip itself when its environment is unavailable; later adapters still run.

  5. Preview generation through the web interface.

    Terminal window
    tman serve

    The web UI’s preview path avoids writes. There is no CLI-wide dry-run flag; actions in the web UI can still generate files, update favorites, or change configuration.

Continue with generation and selection to understand the files that each phase owns.