Liking cljdoc? Tell your friends :D

Colors

Table of Contents

The poly tool uses color to make its output easier to digest.

NameANSI ColorSample HexExample poly Usages

yellow

ESC[33m

yellow
#f8eeb6

interfaces, warning messages

green

ESC[32m

green
#bfefc5

components, success messages

blue

ESC[34m

blue
#77bcfc

bases

purple

ESC[35m
(magenta)

purple
#e2aeff

projects

red

ESC[31m

red
#ee9b9a

error messages

light grey

ESC[37m
(white)

grey light
#cccccc

tags and shas (dark mode)

dark grey

ESC[90m
(bright black)

-

tags and shas (light mode)

black (background)

ESC[40m

black
#24272b

Not used by poly, default shell background color

Your OS terminal shell and its color theme configuration can redefine these colors. If you want to match our dark scheme preference (inspired by the Cursive Borealis color scheme), configure your terminal to use the sample colors from the table above.

Config

When you create your first workspace, poly creates a user config file that specifies a color-mode:

~/.config/polylith/config.edn
{:color-mode "dark" (1)
 :thousand-separator ","
 :empty-character "·"}
1The poly tool sets the initial value to "dark" on macOS and Linux and to "none" on Windows.

Valid color-mode values are "none", "light", and "dark".

We don’t support colored text on Windows, so poly sets the initial :color-mode on Windows to "none".

If you use a light theme for your OS terminal shell, consider switching :color-mode to "light". The only difference between "light" and "dark" is very subtle; they use different shades of grey. The shade of grey in the "light" mode can show up better when using a light theme in your OS terminal shell.

Usage

Throughout our documentation, our screenshots show output from an OS terminal shell configured with a dark theme with :color-mode left at its default "dark":

poly info
info dark

When you can specify color-mode as an argument, it will override your poly config. Assuming you’ve configured your OS terminal shell to a light color scheme, you might want to tell poly to use color-mode:light:

poly info color-mode:light
info light

When you specify a color-mode of none:

poly info color-mode:none

The poly tool will emit uncolored plaintext:

  stable since: 65957ce | stable-lisa

  projects: 3   interfaces: 1
  bases:    2   components: 2

  active profiles: default

  project         alias   status   dev  remote
  ------------------------------   -----------
  command-line *  cl       -t-     -t-    --
  user-service *  user-s   ---     ---    --
  development *   dev      s--     s--    --

  interface  brick           cl   user-s   dev  remote
  ------------------------   -----------   -----------
  user       user *          ---   stx     st-    --
  user       user-remote *   stx   ---     ---    st
  -          cli *           stx   ---     st-    --
  -          user-api *      ---   stx     st-    --

Can you improve this documentation?Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close