Troubleshooting

Start with the narrowest safe check:

1. Confirm the installed CLI and runtime with tman --version.
2. Identify whether the problem is generation, selecting an existing generated theme, or a target environment gate.
3. Read the reported adapter error before retrying a command that writes files.
4. Inspect the generated source for the affected target before changing a live destination.

• Installation problems cover Node, pnpm, global-bin, and Pastel setup.
• Generation problems cover source selection, missing state, and adapter failures.
• Applying themes covers generated sources, skips, partial results, and reload hooks.
• Platform notes covers Termux, desktop-only targets, MiXplorer, browser opening, and special adapters.

Caution

Generation and selection can change generated files, live configuration, and ~/.tg.json. The CLI has no global dry-run, backup, or rollback. Use tman serve to inspect a generated preview before writing when that distinction matters.