jonesand.ai brand standards
Color, typography, layout, components, motion, voice. Grounded modernist — confident palette, editorial type, calm motion.
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.
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.
--color-fog). Used on the homepage Projects section band.--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.
| Token | Maps to | Use |
|---|---|---|
--color-text-primary | Ink | Body and heading text |
--color-text-muted | Ink @ 65% | Captions, metadata, secondary text |
--color-text-subtle | Ink @ 45% | Tertiary text, disabled labels |
--color-text-inverse | Paper | Text on dark surfaces |
--color-surface | Paper | Page background |
--color-paper-warm | #F6F3EE | Original Paper value, kept as an alternate band background |
--color-surface-raised | #FFFFFF | Cards, inputs, popovers |
--color-surface-sunken | #EDE9E2 | Section backgrounds within pages |
--color-border | Soft Gray | Default borders, dividers |
--color-accent | Graphite (#1E232B) | Primary CTAs, accent blocks, eyebrows — branding only, not links |
--color-accent-strong | #1F54D6 | Focus rings only, as of 2026-07-22 — links use Ink now (§6.3) |
--color-highlight | Amber (was Amber) | Highlight blocks, secondary tags |
--color-highlight-alt | Mist (see below) | Alt highlight alongside Amber — Callout highlight variant, bright Tag option |
--color-danger | Coral (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-fog | Fog (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.
| Pairing | Ratio | Use |
|---|---|---|
| Ink on Paper | 18.0:1 | All body — AAA (up from 16.9:1 on the old, darker Paper) |
| Ink on Surface | 18.4:1 | Card body — AAA (Surface unchanged) |
| Ink @ 65% on Paper | 8.9:1 | Muted text — AA (figure not recomputed for the new Paper) |
| Accent — Graphite on Paper | 15.1:1 | AAA. Buttons, eyebrows, brand moments — no longer AA-Large-only like the old Signal Blue. |
| Paper on Accent (Graphite) | 15.1:1 | Inverse button fill — AAA. |
| Link Blue (#1F54D6) on Paper | 6.1:1 | Inline links, text actions — AA (up from 5.7:1) |
| Amber on Paper | 1.6:1 | Fails AA for text (was Amber, 2.2:1 — also failing, but worse now). Backgrounds and chips only. |
| Coral on Paper | 2.85:1 | Fails 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 Coral | 7.07:1 | AAA. 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.
| Token | Value | Role |
|---|---|---|
--color-background | #101214 | Page background |
--color-foreground / --color-ink | #F3EEE6 | Primary 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 | #1D2127 | Raised surfaces, cards, inputs |
--color-soft-gray | #2B3139 | Borders and dividers |
--color-signal-blue | #78A6FF | Dark-mode focus rings only — changed 2026-07-22, no longer branding/CTAs |
--color-warm-red | #FF7A6B | Errors and destructive actions only |
--color-mustard | #E0B85A | Dark-mode Highlight only (eyebrows, tags) — not the Accent |
| Pairing | Ratio | Use |
|---|---|---|
| Foreground on Background | 16.25:1 | Primary body and heading text — AAA |
| Muted on Background | 8.68:1 | Secondary text — AAA |
| Muted Soft on Background | 5.03:1 | Tertiary text — AA |
| Signal Blue on Background | 7.77:1 | Focus rings only — AAA |
| Signal Blue on Surface | 6.69:1 | Focus rings on cards/inputs — AA |
| Ink (Accent) on Background | 16.25:1 | Logo, brand moments — AAA (same as Foreground on Background above) |
| Background on Ink (Accent) | 16.25:1 | Filled accent buttons (Subscribe, etc.) — AAA |
| Mustard (Highlight) on Background | 9.99:1 | Highlight 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
Typography
Inter Tight for display, Inter for body. Modular scale at 1.25 ratio. Tight tracking on headlines for presence.
Type scale
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
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.
Spacing scale
4-point grid. Consistent rhythm creates calm — every spacing decision should resolve to one of these values.
Layout patterns
A product operator's journey into AI-assisted development. Practical experiments, workflows, and lessons learned.
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.
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.
Design principles
Asymmetry with order
Break the grid intentionally, not randomly. The underlying grid keeps asymmetric layouts coherent.
Generous whitespace
Let content breathe. Wide margins signal quality. Dense layouts feel cheap.
Left alignment dominance
Anchor content to the left. Centered text is for special moments only.
Architectural cards
Cards should feel structural, not like dashboard widgets. Subtle shadows, clean edges.
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.
Responsive as refinement
Mobile isn't stacked desktop. It's a chance to simplify and let content breathe more.
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.
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.
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.
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.
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.
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.
Lead with identity, then value, then newsletter capture. Treat the journal and projects as supporting proof.
Mist variant — a confident, cool pop for standout callouts. Part of the wider working palette now, not a rare exception.
Code
Reference tokens like --color-text-primary in your CSS.
@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;
}
Motion
Calm, purposeful. Motion clarifies state changes — it doesn't perform.
| Token | Value | Use |
|---|---|---|
--motion-fast | 120ms | Icon swaps, tooltips |
--motion-base | 200ms | Hover states, focus rings |
--motion-slow | 320ms | Page transitions, modal in/out |
--ease-out | cubic-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;
}
}
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 instructions for better product work
Challenge assumptions.
Surface risks.
## Core Principles
- Seek truth over agreement.
- Make reasoning visible.
- Ask, don't invent.
| Element | Guideline |
|---|---|
| Canvas | 1200x626 for hero and social images. 1252x1252 for square thumbnails. |
| Composition | Left-aligned headline block, optional right-side artifact, generous quiet space. |
| Typography | Large Inter Tight style headline, mono labels for files, commands, prompts, and technical artifacts. |
| Palette | Neutral 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. |
| Texture | Very light paper grain or soft shadow only. No glossy surfaces. |
| Readability | The 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.
| Rule | Guideline |
|---|---|
| Use case | Journal, prompt, output, model, experiment, iterate, compare, document, toolkit, project, and insight. |
| Construction | 32px viewBox, 1.5px Ink stroke, simple detail that reads at 24px. |
| Color | Ink for primary strokes. Soft Gray may support internal detail. No Signal Blue, Amber, Coral, or multicolor icon shapes. |
| Fills | Prefer stroke-only. Tiny Ink fills are allowed for functional dots, terminals, nodes, or status points. |
| Sizing | 24px 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.
| Element | Use |
|---|---|
| Bracket callouts | Corner-bracket framing on Surface Sunken for pull quotes, definitions, and short claims. |
| Corner art blocks | Restrained registration marks around feature blocks, pull quotes, or article image details. Ink only and rare. |
| Technical notes | Thin border, small floated mono label, Surface background. No fill-heavy badges. |
| Crosshair and tick rules | Quiet section anchors, dividers, or annotation details. |
| Measurement brackets | Diagram annotations and article graphics, paired with mono labels. |
| Numbered station marks | Process steps, lessons, and analysis sequences. |
| Dot-grid texture | Contained 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.
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.
| Surface | Good | Bad |
|---|---|---|
| Hero CTA | Subscribe | Join the movement! |
| Newsletter promise | One email a week. No hype. | Don't miss out — sign up now! |
| Form error | That email doesn't look right. Try again? | Invalid input. |
| Empty state | Nothing here yet. New notes ship most weeks. | No content available. |
| 404 page | That 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.
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
See the system applied
The Builder's Journal — a complete homepage concept built from these tokens, principles, and components.