UNPKG

@reason-native/console

Version:

No effort, universal logger

43 lines (31 loc) • 1.76 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
## Terminal Configuration Tips: This is a set of tips for configuring your terminal so that you take advantage of the full expresivity of the various stylings that modern terminals provide. If you build apps that use these features, keep in mind the kinds of configuration users will have enabled. These suggestions are not specific to `Pastel`, but will allow you to use all of `Pastel`'s features to the fullest. **Colors**: - Ensure you have configured your terminal color scheme so that "bright" colors are noticibly different than non-bright colors. - Background color isn't the same thing as "black". If using a dark color scheme, ensure that both "black" and "bright black" are different from "background", and different from each other. Similarly, "white" is not the same as foreground color. Configure both "white" and "bright white" so that they are different from "foreground", and different from each other. - Disable terminal features that try to render bold fonts as bright colors. There's no need to conflate the two - brightness and boldness are fully independent attributes which `Pastel` can manage. - Make sure your terminal is set to render bold text in a bold font. - Configure your terminal to allow italics. Specific Terminal Configuration: **Iterm**: - iTerm often won't render underlines unless you enable ligatures (your font might need to declare support of ligatures). The following shows the best way to configure iTerm: ![iTerm optimal configuration](./guide/itermConfig.png) A reference colorscheme for iTerm that works well is in [guide/taste.itermcolors](src/pastel/guide/taste.itermcolors) **Others**: (Please help populate this document with suggestions for other popular terminals: (Kitty, Mintty)