General guidance and recommended practices when using Spectre.Console, distilled from the library authors' experience. This explanation includes:
- Output best practices: Test in multiple terminal environments, avoid hard-coding unicode characters or emoji without fallbacks, and consider users' terminal background colors (don't assume a black background; use the default 16 colors when possible for theming). See the Color Reference for all available color options.
- Live rendering best practices: Use a single thread for rendering updates, do not run two live animations (e.g. Progress and Status) at once, and keep the UI responsive by doing heavy work on background threads but rendering on the main thread.
- Prompting and input: Suggest injecting an
IAnsiConsoleinto business logic so that it can be mocked for testing, and avoiding callingAnsiConsolestatically inside commands (as shown in the unit testing example). This section reads as a set of guidelines and rationales, helping developers avoid common pitfalls and write robust console apps.