the brand guide

how kanso is drawn

kanso is a language about removing what does not carry meaning, so its pages carry no decoration. each page uses one accent color, gives each surface one idea, and leaves a lot of blank space. the palette is small enough to memorize, which lets a reader recognize a kanso page before reading any of it.

the palette

ten colors: five neutrals, three for code, and the orange accent with a darker shade of it for hover. the neutrals carry almost everything, and the accent is used for one thing per screen.

rice paper
#fcfbf7

the page background. it is warm enough to look chosen rather than a browser default, and close enough to white that it stays out of the way of the text.

sumi
#17161b

body text. it is not pure black: a little violet in it softens the contrast over long passages.

torii
#f03a00

the accent, named for the torii gate. it marks the one thing on a screen the reader should look at first, so it appears once per screen.

torii, pressed
#c93000

the accent under a cursor. hovering darkens the accent instead of brightening it.

slate tea
#6a6871

secondary text: captions, dates, notes like this one. readable when you look for it, and lighter than body text so it does not compete.

shoji
#e7e4dc

every rule and border. it is light enough to separate regions without boxing them in.

lacquer
#101014

the code panel background. it is darker than the body text, so a listing sits on the page as a distinct block.

matcha
#6ccfa3

strings in code. it is the only cool color in the set, and it appears only inside code.

persimmon
#f0c674

numbers in code. it is warm and close to the accent, but distinct enough not to be read as it.

indigo dusk
#7faff7

type names in code. it is the coolest color on the site.

the dark theme is the same palette with the paper and the ink exchanged, and the accent lifted to #ff5a2e so it survives a dark ground at the same apparent weight.

the type

three typefaces, one for headings, one for reading and one for code.

space grotesk · display · headings and the brand

simplicity through elimination

a grotesque sans with slightly irregular corners. the letterforms are plain but have some character, which shows at large sizes. it is used for headings and the wordmark.

64簡素
32guardrails, not lifetimes
18the founding principle
inter · text · everything you actually read

inter is set for everything you read at length. at body size it is easy to read without drawing attention to itself, and it stays comfortable through the long technical passages on the compiler page.

17a value is computed when it is demanded, or never.
14a value is computed when it is demanded, or never.
12a value is computed when it is demanded, or never.
jetbrains mono · code · listings, counters, and every number

fn greet name
  "hello, {name}"

chosen for its tall x-height and a zero that cannot be mistaken for the letter o. every measured number on this site is set in it, so a number in mono is one that came from a run.

the reasoning

space is the material

when a section looks thin, give it more space around it before adding anything to it.

one accent, spent deliberately

torii marks the single most important thing on a screen. with two accents on a screen, the reader has to work out which one matters more.

the machinery stays behind the panel

the compiler page is for readers who want the internals. every other page explains the language without them.

nothing decorative that cannot be run

the sample on the landing page runs in the browser. where a picture of code could be replaced by code that runs, it is.

the mark is an enso, the circle of zen calligraphy, drawn in one brush stroke and left open.