Look and feel

The look and feel of NCode

Instrument

NCode's mark is a value held between the braces of code. Instrument builds every surface the same way: a neutral, precisely made case of engraved labels, keys and wells that holds live values, lit on screens and lamps, with the mark's own brace drawn around what one boundary holds.

Identity is infrastructure, so it should feel like well-made equipment: you can see what every part is, what state it is in, and which security boundary you are acting in, before you touch anything.

  1. 01

    The frame is fixed, the value is live

    Structure is stone and engraved type. Color belongs to values, to state and to the tenant, so the look survives any brand color.

  2. 02

    A brace marks a scope

    The mark's brace is drawn around what one boundary holds, and nowhere else. It is never decoration.

  3. 03

    Names are engraved, values are displayed

    A fixed part carries narrow capitals. Anything read off the system, an ID, a count, a date, code, is monospace.

  4. 04

    Depth means one thing

    A lip below: press it. A shade above: fill it. Flush: a plate. Hard edges only, no gradients, no glow.

  5. 05

    State is lit, and said

    A lamp or a lit plate always sits beside a word, and its shape changes with the state. Color never works alone.

  6. 06

    Hazards wear tape

    Test environments, cautions and the platform boundary carry amber and black stripes, in both themes.

  7. 07

    Keys travel, readouts tick

    A key moves two pixels in 70 milliseconds. A value changes in one step. Nothing else moves.

Color

One blue, bent through the logo kit's three exact colors. One neutral, Stone, with a trace of warm olive so it takes no side against a tenant's hue. Amber is the only other voice.

Ramps

In each cell: step, hex, contrast on white, contrast on black

BlueBrand

  1. 50#F2F5FF1.09 · 19.28
  2. 100#E4EBFF1.19 · 17.63
  3. 200#C3D2FF1.50 · 13.98
  4. 300NCode Blue Light#809FFF2.52 · 8.32
  5. 400#557EFA3.65 · 5.75
  6. 500#2757E85.81 · 3.61
  7. 600NCode Blue#0033CC8.95 · 2.35
  8. 700#032AA711.09 · 1.89
  9. 800#08257F13.28 · 1.58
  10. 900NCode Navy#0A1F5C15.40 · 1.36
  11. 950#07133918.08 · 1.16

StoneNeutral

  1. 0#FFFFFF1.00 · 21.00
  2. 50#F7F7F41.07 · 19.57
  3. 100#F0F0ED1.14 · 18.39
  4. 200#E9E9E41.22 · 17.24
  5. 300#D9D9D41.42 · 14.83
  6. 400#BEBEB81.87 · 11.25
  7. 450#93938C3.09 · 6.79
  8. 500#7979724.38 · 4.79
  9. 600#5E5E586.53 · 3.22
  10. 700#4B4B458.78 · 2.39
  11. 800#34343012.50 · 1.68
  12. 850#28282414.80 · 1.42
  13. 900#1E1E1B16.71 · 1.26
  14. 925#17171417.96 · 1.17
  15. 950#11110F18.90 · 1.11
  16. 975#0A0A0819.81 · 1.06

GreenSuccess

  1. 50#ECFAEF1.08 · 19.49
  2. 100#D3F5DB1.18 · 17.85
  3. 300#7ADE951.65 · 12.71
  4. 500#20A04E3.39 · 6.20
  5. 600#11813C4.97 · 4.23
  6. 700#1266307.07 · 2.97
  7. 800#0D4A2210.40 · 2.02
  8. 900#08351813.70 · 1.53
  9. 950#09221016.83 · 1.25

AmberWarning, hazard, hot

  1. 50#FFF6E11.08 · 19.52
  2. 100#FFECB81.17 · 17.94
  3. 300#FAC13B1.65 · 12.76
  4. 400#F4AD1D1.94 · 10.84
  5. 500#DC89002.76 · 7.62
  6. 600#B96A004.10 · 5.12
  7. 700#8F4D056.50 · 3.23
  8. 800#62360610.25 · 2.05
  9. 900#44250413.89 · 1.51
  10. 950#2A190716.93 · 1.24

RedDanger

  1. 50#FFF2F01.09 · 19.21
  2. 100#FFE2DF1.22 · 17.20
  3. 300#FF958D2.11 · 9.94
  4. 500#DE3C374.37 · 4.81
  5. 600#C01F1C6.08 · 3.45
  6. 700#9C1B188.13 · 2.58
  7. 800#71161211.50 · 1.83
  8. 900#4D161214.59 · 1.44
  9. 950#31100D17.35 · 1.21

Roles

The semantic tokens components read; these swatches follow the theme

Case and plates

  • page
  • page-sunken
  • surface
  • surface-raised
  • surface-sunken
  • well

Keys

  • control
  • control-hover
  • control-pressed
  • ghost-hover
  • ghost-pressed

Lines

  • border
  • border-strong
  • lamp-unlit

Type

  • text
  • text-secondary
  • text-muted
  • text-disabled
  • code-tint

Primary, from --nc-brand

  • primary
  • on-primary
  • primary-shade
  • primary-hover
  • primary-pressed
  • primary-edge
  • primary-lip
  • primary-text
  • primary-subtle
  • primary-subtle-border
  • focus

Screen, from --nc-brand-secondary

  • screen
  • screen-raised
  • screen-border
  • screen-lit
  • on-screen
  • on-screen-secondary
  • on-screen-muted
  • screen-hot

Scope braces

  • scope-tenant
  • scope-team
  • scope-platform

Depth

  • lip
  • shade
  • screen-shade
  • glint
  • shadow
  • scrim

Success

  • success
  • on-success
  • success-mark
  • success-text
  • success-subtle
  • success-border

Warning

  • warning
  • on-warning
  • warning-mark
  • warning-text
  • warning-subtle
  • warning-border

Danger

  • danger
  • on-danger
  • danger-mark
  • danger-text
  • danger-subtle
  • danger-border
  • danger-hover
  • danger-lip

Info

  • info
  • on-info
  • info-mark
  • info-text
  • info-subtle
  • info-border

Hazard tape

  • hazard
  • on-hazard

NCode's marks

  • logo

A tenant's two colors

The primary colors what you press. The secondary colors what you are shown: screens and the scope brace.

NCode#0033CC

Create client Cancel TenantcontosoClients scope web-portal 8 alex

Primary only#0F766E

Create client Cancel TenantcontosoClients scope web-portal 8 alex

Primary only#C2410C

Create client Cancel TenantcontosoClients scope web-portal 8 alex

Primary and secondary#0F766E#7C2D12

Create client Cancel TenantcontosoClients scope web-portal 8 alex

Primary and secondary#C2410C#1E3A5F

Create client Cancel TenantcontosoClients scope web-portal 8 alex

Computed contrast

WCAG 2.2, computed by build.mjs from the tokens: 1110 measurements of 136 pairings; 0 below the requirement. The lowest ratio of each use is shown.

NCode Blue: neutrals, brand and screens
UsePairsNeedsLightDark
Text94.512.6810.94
Text on a ghost key, touched34.512.219.39
Secondary text74.56.197.92
Engraved labels, setting keys, placeholders54.55.354.78
Inline code44.513.0610.31
Edge of a control633.093.37
NCode's mark437.355.86
Brand as text, lamp, focus ring64.57.355.68
Primary key: label14.58.957.16
Primary key, hover14.511.118.99
Primary key, pressed14.512.775.47
Primary key against its plate: its face337.355.86
Primary key against its plate: its edge or its face3310.485.86
Text on a selected option14.515.6912.56
Secondary text on a selected option14.57.677.68
Screen: values14.515.4015.40
Screen: code14.510.2310.23
Screen: comments, unlit steps14.56.636.63
Screen: keywords, lit labels, braces14.56.106.10
Screen: literals, hot bytes, a secret14.59.359.35
Lit row: values14.512.4212.42
Lit row: code14.58.258.25
Lit row: keywords14.54.924.92
Lit row and memory cells: literals14.57.547.54
Focus ring on a screen234.924.92
Material UI's secondary as text: the screen, lit in dark64.512.645.86
NCode Blue: boundaries and status
UsePairsNeedsLightDark
Boundary plate: tenant14.56.106.10
Boundary plate: team14.515.4015.40
Boundary plate: platform; hazard band14.59.279.27
Boundary plate against its plate: tenant (bezel or fill)3313.485.86
Boundary plate against its plate: team (bezel or fill)3313.4814.79
Boundary plate against its plate: platform (bezel or fill)3313.487.63
Scope brace: tenant237.357.11
Scope brace: team2314.7415.73
Scope brace: platform (the stronger stripe of the tape)2314.749.27
Success: text44.55.808.95
Success: lamp, icon, bar534.078.95
Success: label on fill14.54.9610.18
Success: alert text14.516.6614.73
Warning: text44.55.338.98
Warning: lamp, icon, bar533.368.98
Warning: label on fill14.59.279.27
Warning: alert text14.516.6914.82
Danger: text54.56.677.00
Danger: lamp, icon, bar534.997.00
Danger: label on fill14.56.078.20
Danger: alert text14.516.4315.19
Info: text44.59.105.86
Info: lamp, icon, bar537.355.86
Info: label on fill14.58.957.16
Info: alert text14.516.4915.83
Danger: key, hover14.58.129.73
Tenant teal: #0F766E, everything derived
UsePairsNeedsLightDark
Brand as text, lamp, focus ring64.55.105.94
Primary key: label14.55.477.46
Primary key, hover14.57.319.19
Primary key, pressed14.58.925.67
Primary key against its plate: its face334.496.20
Primary key against its plate: its edge or its face337.326.20
Text on a selected option14.516.1112.42
Secondary text on a selected option14.57.877.59
Screen: values14.514.7914.79
Screen: code14.59.999.99
Screen: comments, unlit steps14.56.466.46
Screen: keywords, lit labels, braces14.56.206.20
Screen: literals, hot bytes, a secret14.58.988.98
Lit row: values14.511.7511.75
Lit row: code14.57.937.93
Lit row: keywords14.54.924.92
Lit row and memory cells: literals14.57.137.13
Focus ring on a screen234.924.92
Material UI's secondary as text: the screen, lit in dark64.512.146.20
Boundary plate: tenant14.56.206.20
Boundary plate: team14.514.7914.79
Boundary plate against its plate: tenant (bezel or fill)3312.966.20
Boundary plate against its plate: team (bezel or fill)3312.9614.79
Boundary plate against its plate: platform (bezel or fill)3312.967.63
Scope brace: tenant235.107.52
Tenant orange: #C2410C, everything derived
UsePairsNeedsLightDark
Brand as text, lamp, focus ring64.55.795.52
Primary key: label14.55.176.97
Primary key, hover14.56.978.82
Primary key, pressed14.58.595.32
Primary key against its plate: its face334.255.68
Primary key against its plate: its edge or its face337.055.68
Text on a selected option14.516.0912.59
Secondary text on a selected option14.57.867.70
Screen: values14.515.5015.50
Screen: code14.510.2710.27
Screen: comments, unlit steps14.56.646.64
Screen: keywords, lit labels, braces14.55.955.95
Screen: literals, hot bytes, a secret14.59.429.42
Lit row: values14.512.5212.52
Lit row: code14.58.308.30
Lit row: keywords14.54.814.81
Lit row and memory cells: literals14.57.617.61
Focus ring on a screen234.814.81
Material UI's secondary as text: the screen, lit in dark64.512.735.68
Boundary plate: tenant14.55.955.95
Boundary plate: team14.515.5015.50
Boundary plate against its plate: tenant (bezel or fill)3313.585.68
Boundary plate against its plate: team (bezel or fill)3313.5814.79
Boundary plate against its plate: platform (bezel or fill)3313.587.63
Scope brace: tenant235.796.90
Tenant teal, secondary rust: #0F766E and #7C2D12, everything derived
UsePairsNeedsLightDark
Brand as text, lamp, focus ring64.55.105.94
Primary key: label14.55.477.46
Primary key, hover14.57.319.19
Primary key, pressed14.58.925.67
Primary key against its plate: its face334.496.20
Primary key against its plate: its edge or its face337.326.20
Text on a selected option14.516.1112.42
Secondary text on a selected option14.57.877.59
Screen: values14.515.3015.30
Screen: code14.510.1510.15
Screen: comments, unlit steps14.56.596.59
Screen: keywords, lit labels, braces14.55.965.96
Screen: literals, hot bytes, a secret14.59.299.29
Lit row: values14.512.3212.32
Lit row: code14.58.178.17
Lit row: keywords14.54.804.80
Lit row and memory cells: literals14.57.487.48
Focus ring on a screen234.804.80
Material UI's secondary as text: the screen, lit in dark64.512.565.76
Boundary plate: tenant14.55.965.96
Boundary plate: team14.515.3015.30
Boundary plate against its plate: tenant (bezel or fill)3313.405.76
Boundary plate against its plate: team (bezel or fill)3313.4014.79
Boundary plate against its plate: platform (bezel or fill)3313.407.63
Scope brace: tenant237.696.99
Tenant orange, secondary navy: #C2410C and #1E3A5F, everything derived
UsePairsNeedsLightDark
Brand as text, lamp, focus ring64.55.795.52
Primary key: label14.55.176.97
Primary key, hover14.56.978.82
Primary key, pressed14.58.595.32
Primary key against its plate: its face334.255.68
Primary key against its plate: its edge or its face337.055.68
Text on a selected option14.516.0912.59
Secondary text on a selected option14.57.867.70
Screen: values14.515.0815.08
Screen: code14.510.1210.12
Screen: comments, unlit steps14.56.526.52
Screen: keywords, lit labels, braces14.56.106.10
Screen: literals, hot bytes, a secret14.59.169.16
Lit row: values14.512.0412.04
Lit row: code14.58.088.08
Lit row: keywords14.54.874.87
Lit row and memory cells: literals14.57.317.31
Focus ring on a screen234.874.87
Material UI's secondary as text: the screen, lit in dark64.512.385.99
Boundary plate: tenant14.56.106.10
Boundary plate: team14.515.0815.08
Boundary plate against its plate: tenant (bezel or fill)3313.215.99
Boundary plate against its plate: team (bezel or fill)3313.2114.79
Boundary plate against its plate: platform (bezel or fill)3313.217.63
Scope brace: tenant239.447.27
Stress colors: the lowest of #FACC15, #38BDF8, #DC2626, #16A34A, #F1F5F9, #111827
UsePairsNeedsLightDark
Brand as text, lamp, focus ring64.54.845.50
Primary key: label14.54.826.91
Primary key, hover14.56.528.73
Primary key, pressed14.58.085.30
Primary key against its plate: its edge or its face333.905.61
Text on a selected option14.514.9212.40
Secondary text on a selected option14.57.297.58
Screen: values14.514.5214.52
Screen: code14.59.929.92
Screen: comments, unlit steps14.56.416.41
Screen: keywords, lit labels, braces14.55.955.95
Screen: literals, hot bytes, a secret14.58.828.82
Lit row: values14.511.2711.27
Lit row: code14.57.707.70
Lit row: keywords14.54.804.80
Lit row and memory cells: literals14.56.856.85
Focus ring on a screen234.804.80
Material UI's secondary as text: the screen, lit in dark64.511.925.61
Boundary plate: tenant14.55.955.95
Boundary plate: team14.514.5214.52
Boundary plate against its plate: tenant (bezel or fill)3312.715.61
Boundary plate against its plate: team (bezel or fill)3312.7114.79
Boundary plate against its plate: platform (bezel or fill)3312.717.63
Scope brace: tenant234.846.82

Type

Instrument Sans carries names and reading, and its width axis is part of the voice: 82% for engraved labels, 86% for headings, 100% for text. Martian Mono carries every value: 75% wide for code and values, 100% on a readout.

Headline
76 / 76 · 600 · 86% · -0.028em

Secrets that clean up

Title
44 / 48 · 600 · 86% · -0.022em

Clients

Title, long
44 / 48 · 600 · 86% · -0.022em

Quick start

Heading
28 / 33 · 600 · 86% · -0.012em

Verify a signature

Heading, long
28 / 33 · 600 · 86% · -0.012em

Choosing a buffer

Subheading
22 / 29 · 600 · 86% · -0.012em

New client

Minor
16 / 21 · 600 · 100%

Client authentication

Lead
22 / 33 · 400 · 100%

This page derives a key from a password, verifies an HMAC-SHA256 signature with it, and zeroes the derived key when the method returns.

Body
16 / 24 · 400 · 100%

Applications that can request tokens from this tenant.

Reading
17 / 29 · 400 · 100%

Disposing the owner zeroes the whole buffer, so the key never outlives the method. There is no finalizer: a buffer that is never disposed is never zeroed.

Ui
14 / 21 · 400 · 100%

Lowercase letters, digits and hyphens. It cannot be changed later.

Field
13 / 17 · 600 · 100%

Access token lifetime

Label
11 / 13 · 600 · 82% · +0.08em

Client ID   Type   Status   Created   Rows per page

Value
13 / 18 · 500 · 75% · -0.01em

billing-service   2026-10-02   alex@contoso.example   0O 1lI

Code
13 / 22 · 400 · 75%

using var keyOwner = BufferFactory.Rent(32, isSensitive: true, out Span<byte> key);

Readout
12 / 12 · 500 · 100%

00:05:00   32 bytes   404

Shape, depth, space and motion

Radii grow with the size of the part, from a cell to a module. Depth is three hard-edged states and one soft shadow, kept for overlays. Space is a 4-pixel scale. Motion is short and mechanical.

Radii

Cell2px
Label plate4px
Key, well6px
Plate, screen10px
Module14px
Lampround

Lines

Hairline between parts1px border
Edge of a control, 3 to 11px border-strong
Focus ring2px, 2px clear
Hazard tape45°, 8px

Depth

A lip below means raised. A shade above means recessed. Blur appears only under overlays.

RecessedWells, screens, latched keys
FlushPlates
RaisedKeys, a card
FloatingMenus, tooltips
OverlayDialogs, sheets

Space

space-12

space-24

space-38

space-412

space-516

space-624

space-732

space-848

space-964

space-1096

Motion

TokenValueUsed for
dur-press70msA key going down
dur-quick120msHover, a change of color
dur-move200msA switch sliding
dur-enter280msA dialog arriving
ease-out.2, 0, 0, 1Everything that travels
ease-ticksteps(1)Readouts: values change in one step
reduced motionnoneNo transition and no animation at all

The brace

The one motif that comes straight from the mark. It is drawn from the mark's own geometry, never from a font, and it means one thing.

A brace marks a scope: it is drawn around what one named boundary holds, a security boundary or the lifetime of a secret, and nowhere else.

Construction

Straight stems, circular hooks, and a cusp whose tip is half the stroke high. build.mjs draws every brace.

The markA value between two braces. It is never redrawn, stretched or set in a font.
Its braceThe mark's own brace, from the mark's geometry. Stroke 4, hook radius 5, cusp radius 6, of 64 units.brace/brace-mark.svg
StretchedStrokes of 2, 3 and 4 pixels. The hooks and the cusp keep their size; only the stems take the height.brace-sm · brace-md · brace-lg
Three inksA tenant's brace takes the tenant's color, a team's is plain ink, the platform's is hazard tape.scope-tenant · scope-team · scope-platform

The boundary plate

The kind and the name of a boundary between the mark's own braces: on the display, and wherever a dialog restates it

Tenantcontoso TeamPlatform Engineering Platform Tenantcontoso
  1. Platform
  2. TeamPlatform Engineering
Tenants
  1. Platform
Teams
Do

Frame what a boundary holds

A console's workspace, a tenant's sign-in card: everything between the braces belongs to that boundary.

0000710B
Do

Frame a secret's lifetime

In memory and in a listing, the brace spans from where a secret is created to where it is zeroed.

Tenantcontoso
Do

Name the boundary on its plate

A dialog that acts inside a boundary restates it with the same plate the display shows.

Loading configuration

Do

Leave it out when no scope is known

A loading screen, a not-found page and a landing page for no product have no boundary, so they have no brace.

A note is not a scope.

Don't

Brace a callout, a quote or a list

A note already has its signal bar, and a caution its tape. A brace there would only decorate.

{ Clients }

Don't

Set a brace in a font

A font's braces and the mark's differ. Every brace comes from the mark's geometry, as a mask.

Don't

Stack braces in one view

One pair frames a view. The boundary plate restates it; a second frame would blur which boundary is meant.

Beta
Don't

Put anything else on the plate

The plate names Platform, Team or Tenant. It is not a tag, a badge or a status.

Signature

Six more parts, used the same way on every surface. Cover the logo and they still say NCode; change the brand color and they still do.

  1. Platform
  2. Team
  3. Tenantcontoso

The display

State lives on one dark screen in the bar, never among the controls: the three boundaries in order with the one you act in lit, the page, and who is signed in.

New client Cancel Pressed LatchedUp A well

Keys and wells

A key stands two pixels proud on a hard lip and travels down when pressed; a chosen key stays down with its lamp lit. A well is cut in, with a shade under its top edge.

Active Disabled Expiring Revoked 8

Lamps

State is a lamp beside a word. Lit and filled is on, a hollow ring is off, a triangle warns, an octagon stops: the shape carries what the color says.

// zeroed when keyOwner is disposed
using var keyOwner = BufferFactory.Rent(32);

Screens

Values, code and memory are shown on a deep field of the secondary hue: for NCode, exactly Navy with Blue Light type. Amber marks a literal or a live secret.

Client ID
billing-service
Type
Machine
Created
2026-10-02
Signed in as
alex@contoso.example

Engraved names, displayed values

Narrow capitals for the fixed parts of the case, monospace for what the system reports. A field's own label is sentence case, because a form is read.

This is a test environment.

CautionThere is no finalizer, so always use using.

Hazard tape

The one pattern in the system, and it always means the same: this is not routine. It marks non-production tenants, cautions and the platform boundary.

Components

The compact set the scenes are built from. Each maps onto one Material UI component and a few lines of theme override.

Keys

Button, IconButton, ToggleButton

DefaultHoverFocus-visiblePressedDisabled
Primary
Secondary
Ghost
Danger
Sizes and icons Edit client Tabs

Wells

TextField, Select: the label above, in sentence case

Required
client_id
access_token_lifetime

Not a duration. Write it as hh:mm:ss.

Runs on a server and can keep a secret

Choices and status

Checkbox, Radio, Switch, Chip

Check
Radio
Switch
Chips Active Disabled Expiring Revoked Rotating
In a table Active Disabled Tags Open source v5 Ctrl [price]

Alerts

Alert: four severities, each with its own icon shape and signal word

NoteRent hands back a span sliced to exactly the length you asked for.

DoneThe client cli-tools was created.

CautionA buffer that is never disposed is never zeroed.

ErrorThe username or password is incorrect.

Card

8

Clients

Applications that can request tokens from this tenant.

6 active2 disabledOpen

Delete billing-service?

Tenantcontoso

This cannot be undone.

Icons

One line drawing on a 16-unit grid, 1.5 pixels at every size, with miter joins and no fill. NCode's own drawings end a line in a butt cap, and the icons taken from Lucide, restyled onto the same grid, in a square cap.

The set

Each icon at 16 and 20 pixels, with its name and who drew it

activityLucide
arrow-leftNCode
arrow-rightNCode
arrow-up-rightNCode
bellLucide
buildingNCode
calendarLucide
cautionNCode
checkNCode
chevron-downNCode
chevron-leftNCode
chevron-rightNCode
chipNCode
circle-question-markLucide
clientsNCode
clockLucide
closeNCode
cloudNCode
codeLucide
copyNCode
databaseLucide
deviceNCode
downloadLucide
editNCode
ellipsisLucide
ellipsis-verticalLucide
errorNCode
eyeNCode
fileNCode
fingerprint-patternLucide
funnelLucide
git-branchLucide
globeNCode
infoNCode
keyNCode
layersNCode
linkLucide
lockNCode
log-inLucide
mailLucide
menuNCode
minusLucide
moonNCode
packageLucide
peopleNCode
pinNCode
plusNCode
qr-codeLucide
recycleNCode
refresh-cwLucide
rotate-ccw-clockLucide
scopeNCode
searchNCode
serverNCode
settingsLucide
shieldNCode
sign-outNCode
slidersNCode
successNCode
sunNCode
terminalLucide
trashNCode
uploadLucide
userNCode
zeroNCode