# James Ayres — Design Reference
> quiet gallery of glowing screens

**Source:** https://www.jamesayres.com  
**Theme:** light  
**Category:** Portfolio  
**Mood:** light, minimal, airy, photographic, calm  
**Captured:** 2026-10-25

## Overview

A near-silent portfolio that steps aside for the work. Above the fold there's just one sentence and one soft pill button, floating in a huge white field. Below that, the page becomes a long single-column gallery of big rounded image tiles: Apple retail photography, black title cards and product renders in electric violet and deep indigo. The restraint is the point. Typography is barely there, so all the colour and drama come from the case-study imagery.

Technically it's almost all system defaults. system-ui at 16px carries everything, at weight 400 for prose and 500 with -0.16px tracking for labels and the button. The surfaces are pure #ffffff, with tiles in #000000, #0a0a0c, #0a0835, #5743ff and #5f5bff that come from the project media, not the UI. The shape language is 32px radius on every media tile and a pill-shaped 48px-radius button. Spacing is generous and vertical: 96px gaps between project blocks, 48px within them and 192px of breathing room around the hero. There are no shadows, no borders and no nav bar.

## Tokens — Colors

| Name | Value | Token | Role |
|---|---|---|---|
| Gallery White | `#ffffff` | `--color-background` | Page ground and the dominant surface everywhere between the tiles |
| Ink | `#000000` | `--color-foreground` | All text (intro line, project labels, button label) and full-bleed black title-card tiles |
| Mist Pill | `#f4f4f4` | `--color-secondary` | Fill for the 'Get in touch' pill button and empty placeholder tiles (seen in screenshots) |
| Signal Violet | `#5743ff` | `--color-primary` | Brand-scale media tile fill from project imagery, the strongest chromatic note on the page |
| Soft Violet | `#5f5bff` | `--color-accent` | Secondary violet tile/media ground, a sibling of Signal Violet |
| Night Indigo | `#0a0835` | `--color-surface-deep` | Deep indigo media tile ground behind product renders |
| Obsidian | `#0a0a0c` | `--color-surface-dark` | Near-black device/watch showcase tile backgrounds |
| Placeholder Charcoal | `#161616` | `--color-surface-video` | Video-embed fallback tile seen on mobile |

### Semantic roles

| Role | Value |
|---|---|
| background | `#ffffff` |
| surface | `#f4f4f4` |
| surface raised | `#000000` |
| border | `#f4f4f4` |
| text | `#000000` |
| text muted | `#000000` |
| primary | `#f4f4f4` |
| primary text | `#000000` |
| accent | `#5743ff` |

## Tokens — Typography

- **Body:** system-ui (400, 500) — fallbacks: -apple-system, BlinkMacSystemFont, Inter, Helvetica Neue, Arial, sans-serif. No web fonts are loaded. The native OS sans (SF Pro on Apple) does every job at one size, 16px.

| Role | Size | Line height | Weight | Letter spacing | Family |
|---|---|---|---|---|---|
| Lead / intro | 16px | 1.5 | 400 | normal | body |
| Project label | 16px | 1 | 500 | -0.16px | body |
| Button | 16px | 1 | 500 | -0.16px | body |
| Body | 16px | 1.5 | 400 | normal | body |
| Footer / caption | 16px | 1.5 | 400 | -0.16px | body |

## Tokens — Spacing & Layout

- **Base unit:** 24px
- **Density:** spacious
- **Container max width:** 1216px
- **Section gap:** 96px
- **Card padding:** 0px
- **Scale:** 2px, 16px, 20px, 24px, 48px, 96px, 192px, 288px

## Tokens — Radius

| Element | Value |
|---|---|
| Media tiles / image cards | 32px |
| Pill button | 48px |

## Components

### Contact pill (primary) (button)

| Property | Value |
|---|---|
| background | `#f4f4f4` |
| color | `#000000` |
| border | `none` |
| radius | `48px` |
| padding | `12px 20px` |
| font size | `16px` |
| font weight | `500` |
| shadow | `none` |
| hover | `background darkens slightly to #ececec` |

This is the only interactive control on the page. It's a soft grey pill under the intro line, with letter-spacing -0.16px.

### Text link (ghost) (link)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#000000` |
| border | `none` |
| radius | `0` |
| padding | `0` |
| font size | `16px` |
| font weight | `500` |
| shadow | `none` |
| hover | `opacity 0.6` |

Project names like 'Apple' work as centred labels above each case study, with no underline.

### Full-width media tile (card)

| Property | Value |
|---|---|
| background | `#000000` |
| color | `#ffffff` |
| border | `none` |
| radius | `32px` |
| padding | `0` |
| font size | `16px` |
| font weight | `400` |
| shadow | `none` |
| hover | `none` |

Edge-to-edge image or video clipped by overflow:hidden at 32px. The background is black or brand indigo/violet when the media is a title card.

### Half-width tile pair (card)

| Property | Value |
|---|---|
| background | `#f4f4f4` |
| color | `#000000` |
| border | `none` |
| radius | `32px` |
| padding | `0` |
| font size | `16px` |
| font weight | `400` |
| shadow | `none` |
| hover | `none` |

Two tiles side by side with a 24px gap. Each holds supporting photography or a device trio.

### Hero intro block (other)

| Property | Value |
|---|---|
| background | `#ffffff` |
| color | `#000000` |
| border | `none` |
| radius | `0` |
| padding | `192px 24px` |
| font size | `16px` |
| font weight | `400` |
| shadow | `none` |
| hover | `none` |

A single centred sentence plus the pill, 24px apart, floating in a near-empty viewport.

### No nav bar (nav)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#000000` |
| border | `none` |
| radius | `0` |
| padding | `0` |
| font size | `16px` |
| font weight | `500` |
| shadow | `none` |
| hover | `none` |

There's no header or menu. The hero sentence and contact pill stand in for navigation, and the page is a single scroll.

## Layout

A single centred column, about 1216px wide with roughly 96px side margins at 1440px. The hero is a vertically centred sentence and pill with huge whitespace above and below. After that, each project is a centred 16px label, then a 48px gap, then a stack of tiles: one full-width 32px-radius tile followed by half-width pairs and more full-width tiles, with a 24px gutter. Projects are separated by 96–288px gaps, and the page ends with a small © 2026 line.

## Imagery

The imagery carries the whole page. There's architectural Apple Store photography, lifestyle shots of hands holding phones in saturated colour, iPhone and Apple Watch UI renders on black or deep indigo, and bold white type cards like 'Replay' on pure black. Every image is cropped to a rounded tile and nothing is illustrated or decorative. Colour comes from the work itself: violet #5743ff, indigo #0a0835 and black.

## Motion

Framer-native and minimal. Expect gentle fade-and-rise reveals as tiles scroll in, autoplaying muted video in some tiles, and a soft hover on the pill. Nothing loops in the chrome.

## Responsive

On phones the layout keeps one column with about 48px side margins. The intro sentence wraps to two centred lines at a slightly larger optical size, and the pill keeps its shape. There's no nav to collapse. The half-width tile pairs stack into full-width tiles, still with 32px radius. Vertical whitespace shrinks but stays generous, around 192px above the hero text. Video embeds fall back to a #161616 tile.

## Do

- Set all UI text in system-ui at 16px, using only weights 400 and 500.
- Round every image or video tile to exactly 32px and clip the media inside it.
- Use 96px between project blocks and 24px between sibling tiles.
- Keep the hero to one sentence plus a single #f4f4f4 pill button.
- Let project media supply all colour, with violet #5743ff and indigo #0a0835 tiles as brand moments.
- Centre-align labels and copy above each tile stack.

## Don't

- Don't add a navigation bar, logo or footer menu.
- Don't introduce display headlines or larger type sizes in the UI chrome.
- Don't use shadows, borders or card padding around media.
- Don't tint the page background. It stays pure #ffffff.
- Don't give the button a saturated fill. The CTA is a quiet grey pill, not a violet one.
- Don't crowd tiles. Never go below a 24px gutter.

## Agent prompt

> Build a minimal single-column portfolio on pure #ffffff with #000000 text, using only system-ui (fallback -apple-system, Inter) at 16px: weight 400 with line-height 1.5 for prose, weight 500 with -0.16px tracking for labels and the button. The hero is a near-empty viewport with one centred sentence ('X is a digital product designer.') and, 24px below, a #f4f4f4 pill button (radius 48px, padding 12px 20px, black 500 text, no shadow). Below that, each case study gets a centred 16px project label, then a 48px gap, then a stack of edge-to-edge media tiles with 32px radius and overflow hidden: full-width tiles alternating with half-width pairs on a 24px gutter, and 96px between projects. Use #000000, #0a0a0c, #0a0835, #5743ff and #5f5bff as tile grounds for title cards and device renders. No nav, no borders, no shadows, and gentle fade-up reveals only. The work provides all the colour.

## CSS custom properties

```css
/* James Ayres — CSS custom properties. Generated from style.json */
:root {
  /* Palette */
  --color-background: #ffffff; /* Page ground and the dominant surface everywhere between the tiles */
  --color-foreground: #000000; /* All text (intro line, project labels, button label) and full-bleed black title-card tiles */
  --color-secondary: #f4f4f4; /* Fill for the 'Get in touch' pill button and empty placeholder tiles (seen in screenshots) */
  --color-primary: #5743ff; /* Brand-scale media tile fill from project imagery, the strongest chromatic note on the page */
  --color-accent: #5f5bff; /* Secondary violet tile/media ground, a sibling of Signal Violet */
  --color-surface-deep: #0a0835; /* Deep indigo media tile ground behind product renders */
  --color-surface-dark: #0a0a0c; /* Near-black device/watch showcase tile backgrounds */
  --color-surface-video: #161616; /* Video-embed fallback tile seen on mobile */

  /* Semantic roles */
  --background: #ffffff;
  --surface: #f4f4f4;
  --surface-raised: #000000;
  --border: #f4f4f4;
  --text: #000000;
  --text-muted: #000000;
  --primary: #f4f4f4;
  --primary-text: #000000;
  --accent: #5743ff;

  /* Typography */
  --font-body: system-ui, -apple-system, BlinkMacSystemFont, Inter, 'Helvetica Neue', Arial, sans-serif;
  --text-lead-intro: 16px;
  --text-lead-intro--line-height: 1.5;
  --text-lead-intro--letter-spacing: normal;
  --text-lead-intro--font-weight: 400;
  --text-project-label: 16px;
  --text-project-label--line-height: 1;
  --text-project-label--letter-spacing: -0.16px;
  --text-project-label--font-weight: 500;
  --text-button: 16px;
  --text-button--line-height: 1;
  --text-button--letter-spacing: -0.16px;
  --text-button--font-weight: 500;
  --text-body: 16px;
  --text-body--line-height: 1.5;
  --text-body--letter-spacing: normal;
  --text-body--font-weight: 400;
  --text-footer-caption: 16px;
  --text-footer-caption--line-height: 1.5;
  --text-footer-caption--letter-spacing: -0.16px;
  --text-footer-caption--font-weight: 400;

  /* Spacing */
  --space-1: 2px;
  --space-2: 16px;
  --space-3: 20px;
  --space-4: 24px;
  --space-5: 48px;
  --space-6: 96px;
  --space-7: 192px;
  --space-8: 288px;
  --container: 1216px;
  --section-gap: 96px;

  /* Radius */
  --radius-media-tiles-image-cards: 32px;
  --radius-pill-button: 48px;
}
```

## Tailwind v4 theme

```css
/* James Ayres — Tailwind CSS v4 theme. Import after tailwindcss: @import "tailwindcss"; then paste this block. */
@theme {
  --color-background: #ffffff;
  --color-foreground: #000000;
  --color-secondary: #f4f4f4;
  --color-primary: #5743ff;
  --color-accent: #5f5bff;
  --color-surface-deep: #0a0835;
  --color-surface-dark: #0a0a0c;
  --color-surface-video: #161616;
  --color-background: #ffffff;
  --color-surface: #f4f4f4;
  --color-surface-raised: #000000;
  --color-border: #f4f4f4;
  --color-text: #000000;
  --color-text-muted: #000000;
  --color-primary: #f4f4f4;
  --color-primary-text: #000000;
  --color-accent: #5743ff;
  --font-body: system-ui, -apple-system, BlinkMacSystemFont, Inter, 'Helvetica Neue', Arial, sans-serif;
  --text-lead-intro: 16px;
  --text-lead-intro--line-height: 1.5;
  --text-lead-intro--letter-spacing: normal;
  --text-lead-intro--font-weight: 400;
  --text-project-label: 16px;
  --text-project-label--line-height: 1;
  --text-project-label--letter-spacing: -0.16px;
  --text-project-label--font-weight: 500;
  --text-button: 16px;
  --text-button--line-height: 1;
  --text-button--letter-spacing: -0.16px;
  --text-button--font-weight: 500;
  --text-body: 16px;
  --text-body--line-height: 1.5;
  --text-body--letter-spacing: normal;
  --text-body--font-weight: 400;
  --text-footer-caption: 16px;
  --text-footer-caption--line-height: 1.5;
  --text-footer-caption--letter-spacing: -0.16px;
  --text-footer-caption--font-weight: 400;
  --radius-media-tiles-image-cards: 32px;
  --radius-pill-button: 48px;
  --container-site: 1216px;
}
```

## Theme tokens — light + dark

The shadcn-named layer DevDojo Sites speaks (`bg-background`, `text-foreground`, `bg-primary`, `rounded-medium`…). Paste into site.css after `@import "tailwindcss"` to restyle any site in this look.

```css
/* James Ayres — DevDojo theme tokens (light + dark). Generated from style.json. */
/* Drop into site.css after @import "tailwindcss": bg-background, text-foreground, bg-primary, border-border, rounded-medium… all read these. Dark mode: estimated — the site has no dark scheme, so the .dark half is a plausible twin of its palette. */
@custom-variant dark (&:where(.dark, .dark *));

:root {
    color-scheme: light;

    --background: #ffffff;
    --foreground: #000000;
    --card: #f4f4f4;
    --card-foreground: #000000;
    --popover: #ffffff; /* estimated */
    --popover-foreground: #000000;
    --primary: #f4f4f4;
    --primary-foreground: #000000;
    --secondary: #f4f4f4;
    --secondary-foreground: #000000;
    --muted: #f4f4f4;
    --muted-foreground: #5c5c5c; /* estimated */
    --accent: #5743ff;
    --accent-foreground: #ffffff;
    --destructive: #e5484d; /* estimated */
    --destructive-foreground: #ffffff; /* estimated */
    --border: rgba(0,0,0,0.08); /* estimated */
    --input: rgba(0,0,0,0.08); /* estimated */
    --ring: #5743ff; /* estimated */

    --radius-small: 32px;
    --radius-medium: 32px;
    --radius-large: 48px;
    --radius: var(--radius-medium);

    --font-body: system-ui, -apple-system, BlinkMacSystemFont, Inter, 'Helvetica Neue', Arial, sans-serif;
}

.dark {
    color-scheme: dark;
    /* estimated from the light palette */

    --background: #0a0a0c;
    --foreground: #ffffff;
    --card: #161616;
    --card-foreground: #ffffff;
    --popover: #161616;
    --popover-foreground: #ffffff;
    --primary: #1f1f22;
    --primary-foreground: #ffffff;
    --secondary: #1f1f22;
    --secondary-foreground: #ffffff;
    --muted: #161616;
    --muted-foreground: #a1a1a6;
    --accent: #5f5bff;
    --accent-foreground: #ffffff;
    --destructive: #e5484d;
    --destructive-foreground: #ffffff;
    --border: rgba(255,255,255,0.08);
    --input: rgba(255,255,255,0.08);
    --ring: #5f5bff;
}

@theme inline {
    --color-background: var(--background);
    --color-foreground: var(--foreground);
    --color-card: var(--card);
    --color-card-foreground: var(--card-foreground);
    --color-popover: var(--popover);
    --color-popover-foreground: var(--popover-foreground);
    --color-primary: var(--primary);
    --color-primary-foreground: var(--primary-foreground);
    --color-secondary: var(--secondary);
    --color-secondary-foreground: var(--secondary-foreground);
    --color-muted: var(--muted);
    --color-muted-foreground: var(--muted-foreground);
    --color-accent: var(--accent);
    --color-accent-foreground: var(--accent-foreground);
    --color-destructive: var(--destructive);
    --color-destructive-foreground: var(--destructive-foreground);
    --color-border: var(--border);
    --color-input: var(--input);
    --color-ring: var(--ring);
    --radius-small: var(--radius-small);
    --radius-medium: var(--radius-medium);
    --radius-large: var(--radius-large);
    --font-body: var(--font-body);
}
```
