Visual System Guide

jonesand.ai brand standards

Color, typography, layout, components, motion, voice. Grounded modernist — confident palette, editorial type, calm motion.

01

Color

A neutral base — Ink, Paper, Soft Gray — carries the reading experience, with a full set of bright accents (near-black for branding, blue for links, Amber/Green/Coral/Mist for energy) layered on with intention. More agency-like than minimal: color is confident, not rationed.

Named colors

The literal palette. Engineers should reference semantic tokens below, not these names directly.

PRIMARY TEXT
Ink
#121212
Body and heading text. The anchor of the system.
PAGE
Paper
#FCFAF5
Page background. Lighter than before; still warm off-white, never stark.
BAND
Paper Warm
#F6F3EE
The original Paper value, kept as an available section-band background.
SURFACE
Surface
#FFFFFF
Cards, inputs, raised surfaces.
SUNKEN
Surface Sunken
#EDE9E2
Section backgrounds inside pages.
STRUCTURE
Soft Gray
#D8D3CC
Borders, dividers, chips. Structure without weight.
ACCENT
Accent — Graphite
#1E232B
Buttons and brand moments. Eyebrows use Amber instead (not clickable, so no reason to keep them on the link color) — see Highlight. Links are Ink now, not this color — see §6.3.
FOCUS
Link Blue
#1F54D6
Focus rings only, as of 2026-07-22. Links themselves are Ink, underlined — see §6.3. Same value as before, narrower role.
HIGHLIGHT
Amber
#FFBE3C
Occasional warmth — chips, highlight blocks. Never body text. Was Mustard (#D8A12D); same role, from creativeboom.com.
EDITORIAL
Green
#009B72
Article images and explanatory graphics only. Was Field Green (#3A8F6B); same role, from creativeboom.com.
SYSTEM
Coral
#FF614C
Errors, destructive actions only. Not for marketing. Was Warm Red (#E5483B) — see contrast note below: Coral is weaker as inline error text.

Cool alternates

Sourced from creativeboom.com's own stylesheet as a deliberate cool departure from this system's warm neutrals — used with intention, not as defaults.

FOG
Fog
#F1F6F6
Cool alt band background (--color-fog). Used on the homepage Projects section band.
MIST
Mist
#B4DCDC
Cool alt highlight (--color-highlight-alt), alongside Amber. Used for the Callout highlight variant and a bright Tag option. Background/fill only — fails contrast as text.

Semantic tokens

Reference these in code, not the named colors. Role tokens are what keep the brand from drifting when new pages get built.

TokenMaps toUse
--color-text-primaryInkBody and heading text
--color-text-mutedInk @ 65%Captions, metadata, secondary text
--color-text-subtleInk @ 45%Tertiary text, disabled labels
--color-text-inversePaperText on dark surfaces
--color-surfacePaperPage background
--color-paper-warm#F6F3EEOriginal Paper value, kept as an alternate band background
--color-surface-raised#FFFFFFCards, inputs, popovers
--color-surface-sunken#EDE9E2Section backgrounds within pages
--color-borderSoft GrayDefault borders, dividers
--color-accentGraphite (#1E232B)Primary CTAs, accent blocks, eyebrows — branding only, not links
--color-accent-strong#1F54D6Focus rings only, as of 2026-07-22 — links use Ink now (§6.3)
--color-highlightAmber (was Amber)Highlight blocks, secondary tags
--color-highlight-altMist (see below)Alt highlight alongside Amber — Callout highlight variant, bright Tag option
--color-dangerCoral (was Coral)Backgrounds, icons, borders for errors — not text, see below
--color-danger-text#B23A26 (new)Darkened Coral for actual error copy — Coral itself fails AA as text
--color-fogFog (see below)Cool band background — used on the homepage Projects section

Contrast & accessibility

WCAG AA (4.5:1) for body text; 3:1 for large or bold UI text.

PairingRatioUse
Ink on Paper18.0:1All body — AAA (up from 16.9:1 on the old, darker Paper)
Ink on Surface18.4:1Card body — AAA (Surface unchanged)
Ink @ 65% on Paper8.9:1Muted text — AA (figure not recomputed for the new Paper)
Accent — Graphite on Paper15.1:1AAA. Buttons, eyebrows, brand moments — no longer AA-Large-only like the old Signal Blue.
Paper on Accent (Graphite)15.1:1Inverse button fill — AAA.
Link Blue (#1F54D6) on Paper6.1:1Inline links, text actions — AA (up from 5.7:1)
Amber on Paper1.6:1Fails AA for text (was Amber, 2.2:1 — also failing, but worse now). Backgrounds and chips only.
Coral on Paper2.85:1Fails even AA-Large (was Coral, 3.8:1 — which passed AA-Large). Coral cannot be used as inline error text on Paper. Pair error states with a Coral icon/background and Ink text instead — see Do/Don't below.
Black text on Coral7.07:1AAA. Use for error banners/pills: Coral fill, black or Ink text — matches creativeboom's own pattern.

Color rules

Do

  • Use Ink for at least 80% of all text
  • Reserve the near-black Accent for buttons and brand moments; keep Link Blue for links, text actions, and focus rings, and Amber for eyebrow labels
  • Use Amber, Coral, Green, and Mist freely — chips, callouts, tags, decorative blocks. Bright color is part of the system now, not a rare exception
  • Use semantic tokens in code, not named colors

Don't

  • Mix the Accent and Amber inside the same component
  • Use Coral anywhere except errors and destructive confirms
  • Use pure black or pure white for backgrounds
  • Use Amber for body text — fails contrast

Night mode

Night mode is the same grounded modernist system in a quieter reading state. It should not become cyberpunk, neon, pure black, or high-saturation AI styling.

TokenValueRole
--color-background#101214Page background
--color-foreground / --color-ink#F3EEE6Primary text, key UI, and the dark-mode Accent (logo, buttons) — changed 2026-07-22, was Mustard/Amber, which read as too much yellow for this role
--color-surface#1D2127Raised surfaces, cards, inputs
--color-soft-gray#2B3139Borders and dividers
--color-signal-blue#78A6FFDark-mode focus rings only — changed 2026-07-22, no longer branding/CTAs
--color-warm-red#FF7A6BErrors and destructive actions only
--color-mustard#E0B85ADark-mode Highlight only (eyebrows, tags) — not the Accent
PairingRatioUse
Foreground on Background16.25:1Primary body and heading text — AAA
Muted on Background8.68:1Secondary text — AAA
Muted Soft on Background5.03:1Tertiary text — AA
Signal Blue on Background7.77:1Focus rings only — AAA
Signal Blue on Surface6.69:1Focus rings on cards/inputs — AA
Ink (Accent) on Background16.25:1Logo, brand moments — AAA (same as Foreground on Background above)
Background on Ink (Accent)16.25:1Filled accent buttons (Subscribe, etc.) — AAA
Mustard (Highlight) on Background9.99:1Highlight text, eyebrows, tags — AAA

Do

  • Keep dark surfaces close together and use borders, spacing, and type hierarchy for structure
  • Use #78A6FF for focus rings only in night mode
  • Use Ink as the dark-mode Accent — logo, buttons, brand moments (changed 2026-07-22, was Mustard/Amber, which read as too much yellow for this role)
  • Pair low-contrast surfaces with text or icons; don't rely on surface contrast alone for state

Don't

  • Add glow effects, saturated gradients, or high-contrast dark panels that feel like a different brand
  • Use Warm Red as a large marketing accent in night mode; its role stays constrained to errors
  • Use pure black as the page background
02

Typography

Inter Tight for display, Inter for body. Modular scale at 1.25 ratio. Tight tracking on headlines for presence.

Type scale

Display
Build with AI
72 / 1.05
Inter Tight 600
H1
Learning to build software
56 / 1.08
Inter Tight 600
H2
A product operator's journey
44 / 1.1
Inter Tight 600
H3
Practical experiments and workflows
28 / 1.2
Inter Tight 600
H4
Block heading or card title
22 / 1.3
Inter Tight 600
Eyebrow
Section label
13 / 1.2
Tracking 0.08em
Body L
The goal is clarity first. Every piece of content should help PMs understand what actually matters in the AI landscape.
18 / 1.65
Inter 400
Body
Default UI body. Used in cards, tables, and short-form content where reading rhythm matters less than density.
16 / 1.6
Inter 400
Small
Captions, metadata, helper text. Light and readable at smaller sizes.
14 / 1.5
Inter 400
Caption
Timestamps and labels. Reserved for the smallest functional copy.
12 / 1.4
Inter 500

Type rules

Do

  • Keep body line-length 60–75 characters (max-width: 65ch for long-form)
  • Use Eyebrow to label sections without consuming heading hierarchy
  • Use weight 600 for display — heavier weights are off-brand
  • Pair tight tracking (-0.02em) with display sizes only

Don't

  • Use sizes below 14px for body content
  • Use italic Inter — reads as a different typeface
  • Mix Display and Body inside a single line
  • Use 700+ weights — feels heavy and dated
03

Layout

12-column grid, 4-point spacing, asymmetric balance, generous whitespace.

The 12-column grid

Foundation for all layouts. Flexible enough for complex arrangements, simple enough to stay consistent.

Desktop · 12 columns · 24px gutters · 1200px max
1
2
3
4
5
6
7
8
9
10
11
12
Common spans
8 cols — Main content
4 cols — Sidebar
6 cols — Half
6 cols — Half
4 cols
4 cols
4 cols

Spacing scale

4-point grid. Consistent rhythm creates calm — every spacing decision should resolve to one of these values.

space-1
4px
Icon gap, button internal padding
space-2
8px
Inline element gap, tight stack
space-3
12px
Form-field padding
space-4
16px
Standard component padding
space-6
24px
Card gutter, default content gap
space-8
32px
Block padding, between heading and content
space-12
48px
Major content blocks, section internal padding
space-16
64px
Between major sections
space-20
80px
Hero top/bottom
space-24
96px
Page-level dividers

Layout patterns

Building with AI

A product operator's journey into AI-assisted development. Practical experiments, workflows, and lessons learned.

Hero — left aligned
Strong left alignment, generous whitespace above and below. No centered everything.

Asymmetric balance

Two-thirds content, one-third accent. Creates hierarchy without chaos. The grid keeps it grounded.

Accent block

For CTAs, highlights, or visual breaks.

Asymmetric two-column
2:1 ratio creates tension and hierarchy. Perfect for feature sections.
Card one

Architectural feel — clean edges, consistent padding, subtle shadow.

Card two

Equal height by default. Content determines internal spacing.

Card three

Three-column on desktop, single column on mobile.

Card grid — three column
For related items, features, or content cards. Consistent structure, varied content.

Design principles

01

Asymmetry with order

Break the grid intentionally, not randomly. The underlying grid keeps asymmetric layouts coherent.

02

Generous whitespace

Let content breathe. Wide margins signal quality. Dense layouts feel cheap.

03

Left alignment dominance

Anchor content to the left. Centered text is for special moments only.

04

Architectural cards

Cards should feel structural, not like dashboard widgets. Subtle shadows, clean edges.

05

Accent with purpose

Color isn't rationed to one moment per viewport anymore — use multiple accents across a section when they earn it. "With purpose" now means intentional, not scarce.

06

Responsive as refinement

Mobile isn't stacked desktop. It's a chance to simplify and let content breathe more.

04

Components

Specs every component must adhere to. New components inherit these defaults.

Button

One primary CTA per viewport. Secondary supports the primary action. Ghost is for low-noise tertiary actions. Danger is destructive only.

Variants
Sizes

Action affordances

Links, downloads, and copy actions share one system (design.md 6.9), implemented by ActionLink and CopyButton. The glyph is a promise about what happens on click, derived from the href, never chosen per call site. The visual tier (secondary button or text action link) says how important the action is; any glyph can appear at either tier.

Internal
Read article Same-site navigation. Renders as a Link, same tab.
External
View repo Off-site. New tab with rel="noopener noreferrer" and an sr-only "opens in new tab".
Download
Download Markdown Always an <a download>. Same-site hrefs under /downloads/ or ending in .md, .txt, .pdf, .zip infer this automatically.
Copy
Never navigates. Two sizes (36px icon-only, 40px labeled). Success swaps to ✓ for 2 seconds; failure shows Coral, never silent.
Button tier
Read article View package Download Markdown The featured action on a card. Same chrome for all glyph kinds.

Glyphs sit in an aria-hidden span after the label, never inside the accessible name. Quiet links (muted, hover to Ink, no glyph) stay reserved for nav, footer, and back links. Email stays a plain mailto link with no glyph.

Input

Always paired with a visible label. Focus state uses the Link Blue border plus a 3px outer ring — focus is an interactive-state signal, grouped with links rather than branding.

Default
Error
That email doesn't look right. Try again?

Tag

Default for stack labels and metadata; highlight for status; accent for featured items. Standardized 2026-07-09 on the Paper Deep fill (implemented by the Tag component); border-only variants converged. New: bright solid variants for category-style labeling, matching the energy of creativeboom.com's own label pills — not for status/metadata, but for content-category tags that want to pop.

Variants
React Claude API In Progress Featured
Bright
Working Note Monthly Wrap Toolkit Reader Favorite

Card

Subtle shadow, never lifted, and always a 1px Soft Gray border (standardized 2026-07-09, implemented by the Card component). Interactive cards strengthen the shadow on hover.

Default
Card title

Architectural — clean edges, consistent padding, subtle shadow. Not dashboard-y.

Callout

Eyebrow-label callout. No colored side borders; use labels, numbers, or hairlines for emphasis.

Default
Note

Lead with identity, then value, then newsletter capture. Treat the journal and projects as supporting proof.

Highlight
Highlight

Mist variant — a confident, cool pop for standout callouts. Part of the wider working palette now, not a rare exception.

Code

Inline

Reference tokens like --color-text-primary in your CSS.

Block
@theme {
  --color-text-primary: #121212;
  --color-accent: #1E232B;
  --color-accent-strong: #1F54D6; /* focus rings only — links are Ink now */
  --font-display: 'Inter Tight', sans-serif;
}
05

Motion

Calm, purposeful. Motion clarifies state changes — it doesn't perform.

TokenValueUse
--motion-fast120msIcon swaps, tooltips
--motion-base200msHover states, focus rings
--motion-slow320msPage transitions, modal in/out
--ease-outcubic-bezier(0.2, 0, 0, 1)Single curve for everything

Do

  • Honor prefers-reduced-motion — disable non-essential animation
  • Use one easing curve everywhere
  • Animate opacity and color over position
  • Keep transitions under 320ms

Don't

  • Auto-play hero animations — feels desperate
  • Slide-in elements on scroll for decorative effect
  • Mix easing curves between components
  • Animate typography size on hover
@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}
06

Imagery

Graphical editorial images for working notes, social cards, and thumbnails. One visual idea, strong hierarchy, restrained text, and color used at meaningful scale.

Editorial article images

Use editorial, graphical images when a working note needs a strong visual anchor. Communicate primarily through a visual metaphor, artifact, process, diagram, or technical illustration. Text should support the visual idea rather than automatically becoming the composition.

Illustrations are allowed when they behave like editorial or technical graphics. They should clarify a concept, process, or artifact. Avoid mascot art, cartoons, decorative scenes, and generic AI imagery.

CLAUDE.md
Critical Thinking > Agreement

CLAUDE.md instructions for better product work

# CLAUDE.md
## Purpose
Challenge assumptions.
Surface risks.

## Core Principles
- Seek truth over agreement.
- Make reasoning visible.
- Ask, don't invent.
Reference pattern
The Lessons Learned image pairs a left-aligned claim with a secondary Markdown artifact. It uses Paper, Ink, one Signal Blue rule, and one Amber technical label.
ElementGuideline
Canvas1200x626 for hero and social images. 1252x1252 for square thumbnails.
CompositionLeft-aligned headline block, optional right-side artifact, generous quiet space.
TypographyLarge Inter Tight style headline, mono labels for files, commands, prompts, and technical artifacts.
PaletteNeutral base of Paper, Ink, and Soft Gray. Layer in one or two accents from the full palette — Signal Blue, Amber, Green, Coral, or Mist — as bright, intentional pops. No accent is favored by default (Signal Blue included — it's phased out of general branding). Let color occupy roughly 20–45% of the composition.
TextureVery light paper grain or soft shadow only. No glossy surfaces.
ReadabilityThe square thumbnail headline must read at 156px wide on the blog index.

Supplementary icons

Lucide remains the default UI icon set. Custom jonesand.ai icons are additive, not replacements. Use them only when the concept is specific to the brand or working-note system and Lucide does not have a close match.

RuleGuideline
Use caseJournal, prompt, output, model, experiment, iterate, compare, document, toolkit, project, and insight.
Construction32px viewBox, 1.5px Ink stroke, simple detail that reads at 24px.
ColorInk for primary strokes. Soft Gray may support internal detail. No Signal Blue, Amber, Coral, or multicolor icon shapes.
FillsPrefer stroke-only. Tiny Ink fills are allowed for functional dots, terminals, nodes, or status points.
Sizing24px default with a text label. 16px minimum only with a label. 48px for hero or article moments.

Structural graphics

Structural graphics are the technical drawing layer. They add order, measurement, and process cues without making the site feel like a dashboard.

ElementUse
Bracket calloutsCorner-bracket framing on Surface Sunken for pull quotes, definitions, and short claims.
Corner art blocksRestrained registration marks around feature blocks, pull quotes, or article image details. Ink only and rare.
Technical notesThin border, small floated mono label, Surface background. No fill-heavy badges.
Crosshair and tick rulesQuiet section anchors, dividers, or annotation details.
Measurement bracketsDiagram annotations and article graphics, paired with mono labels.
Numbered station marksProcess steps, lessons, and analysis sequences.
Dot-grid textureContained diagrams, article graphics, or small structural blocks only. Never full-page wallpaper.

Flow diagrams

Use flow diagrams for process explanations, prompt loops, agent workflows, evaluation paths, and experiment results.

Do

  • Use numbered stations connected by orthogonal lines
  • Highlight one active, current, or critical node
  • Use loops when the workflow is genuinely cyclical
  • Use mono labels for station numbers, sample sizes, dates, and evaluation notes

Don't

  • Rely on a single color for every arrow, node, or bar — mix palette accents across nodes to distinguish categories or states
  • Use decorative arrows or dense node maps
  • Use full-page dot grids behind ordinary content
  • Use 3D diagrams, glowing nodes, or dashboard-like chart packs

Flow loops are allowed when they make the process clearer. Prefer orthogonal return paths. Curves are allowed only when a straight return path makes the diagram harder to read.

Reusable image prompt

Updated: no longer favors Signal Blue as the default accent — it's phased out of general branding, and the composition rule now draws from the whole palette instead of a fixed shortlist.

Create a jonesand.ai editorial article image in the grounded modernist style.

Canvas:
- Hero version: 1200x626.
- Square thumbnail version: 1252x1252.
- Warm off-white Paper background (#FCFAF5) with very subtle paper grain.

Composition:
- Build the composition around one clear visual metaphor, artifact, process, diagram, or technical illustration.
- Anchor the composition in the neutral tones: Ink, Paper, Soft Gray.
- Add one or two accent colors from the full palette — Signal Blue, Amber, Green, Coral, or Mist — as bright, intentional pops of color. No accent is favored by default; pick whichever fits the concept.
- Keep titles short and secondary to the graphical subject by default.
- Let color carry real energy and confidence — not just an accent, a presence.

Style:
- Credible, editorial, modernist — with room for bold, intentional color.
- Strong hierarchy through type and spacing.
- Minimal shadows, no glossy UI, no neon, no purple gradients, no stock imagery, no cartoon illustration.
- Use Ink, Paper, and Soft Gray as the neutral base, plus any one or two accents from Signal Blue, Amber, Green, Coral, and Mist.

Content:
- Eyebrow label: [SHORT TECHNICAL LABEL]
- Headline: [ONE STRONG CLAIM]
- Supporting line: [SHORT CONTEXT LINE]
- Artifact details: [OPTIONAL DOCUMENT OR UI TEXT]

Output:
- Produce a clean, high-resolution bitmap.
- Keep all text sharp and readable.
- Make the square thumbnail a designed square layout, not a crop of the hero image.

Example adaptation

Eyebrow label: CLAUDE.md
Headline: Critical Thinking > Agreement
Supporting line: CLAUDE.md instructions for better product work
Artifact details: A Markdown file panel with sections for Purpose, Core Principles, How to Respond, and Reminders, plus small labels for evidence, tradeoffs, and ask, don't invent.
07

Voice

Grounded, practical, optimistic. The voice of a senior PM who has shipped real things and is now learning a new craft in public.

Voice attributes

Grounded

Calm, credible. The voice of someone who has seen enough to know what matters. No panic, no breathless excitement.

Practical

Actionable and specific. "Here's what I tried" beats "here's what experts say." Real experiments, real workflows.

Optimistic

Excited about possibility, suspicious of snake oil. AI is a tool, not magic.

Direct

No throat-clearing. Get to the point. The audience is busy and smart — respect their time.

Curious

Learning in public. "I don't know yet" is a valid answer. The journey is the content.

Credible

14 years across product, delivery, and analysis shows up as confidence, not credentials. Trust through honesty.

Voice in micro-copy

Voice that doesn't show up in 4-word strings isn't actually specified. Defaults below.

SurfaceGoodBad
Hero CTASubscribeJoin the movement!
Newsletter promiseOne email a week. No hype.Don't miss out — sign up now!
Form errorThat email doesn't look right. Try again?Invalid input.
Empty stateNothing here yet. New notes ship most weeks.No content available.
404 pageThat page doesn't exist — but plenty of others do.Oops! Something went wrong.

Message hierarchy

Every jonesand.ai surface should let a visitor extract these three things, in order, in under five seconds. Show the hierarchy visually — same-size text breaks the hierarchy.

1 · Identity
Making sense of AI by building with it.
2 · Mission
A practical record of learning what AI is actually useful for, where it falls short, and how it changes the work.
3 · Journey
No hype cycle recap. Just useful experiments, working notes, and lessons from figuring this out in practice.

Application by touchpoint

Website

  • Left-aligned hero
  • Newsletter capture above the fold
  • Near-black CTAs; blue reserved for links
  • Generous whitespace
  • Project cards show process

Newsletter

  • Clean, readable layout
  • Confident use of accent color per issue — no longer capped at one
  • Strong hierarchy
  • Minimal header/footer
  • Focus on the writing

Social

  • Consistent visual templates
  • Process over product
  • Threads for complex ideas
  • Quotes in brand typography
  • Confident use of near-black, Amber, Coral, Green, or Mist accents

Presentations

  • Architectural slide layouts
  • One idea per slide
  • Large type, minimal text
  • Accent blocks for emphasis
  • Consistent grid system

Video / YouTube

  • Clean title cards
  • Lower thirds in brand type
  • Minimal motion graphics
  • Consistent outro
  • Workshop lighting aesthetic

Products / tools

  • Same color and type system
  • Functional over decorative
  • Clear hierarchy
  • Consistent components
  • Polished but not precious