1440×900 · 390×844
https://www.joshwcomeau.com

Heading outline, share card & baseline checks

OUTLINE & PRIMARY CTAdense density
H1×1 · H2×6
H1
H2
H2
H2
H2
H2
H2
Primary CTAcourses
Next.jsTailwindlang=en

Words

1011

Action candidates

11

Links

59/9

HTML

116 KB

SHARE CARD & METAog:image ✓

joshwcomeau.com

Josh W. Comeau

Friendly articles and tutorials for front-end web developers. ❤️

Title chars14 ch · Ideal
Meta chars64 ch · Ideal
HEADERS & ASSETS3/6
HTTPS
HSTS
CSP
nosniff
Viewport
JSON-LD
Scripts15 ext · 16 inl
Image alt coverage0/4 (0%)
Third-party hosts1 hosts

What makes it work

Playful sky header gives way to crisp reading ground

Keeping #a0d4ee sky illustration in the masthead while switching the article body to clean dark-on-white preserves effortless reading.

Thoughtful sound and theme controls

Explicit controls to disable sound effects and toggle dark mode treat delight as opt-in rather than forced.

Where to focus next

  1. 01

    Highlight flagship courses alongside free articles

    Recent blog posts dominate the first scroll while flagship courses sit quietly as a small lowercase nav item.

    Add a restrained featured-course callout in the sidebar or below the masthead and verify its position on mobile.

Colors, type scale & CSS tokens

Light ground · Blue & CyanText contrast 12.3:1 AAA
Click any swatch to copy HEX
joshwcomeau.com

Wotfard

ABCDEFGHIJKLMNOPQRSTUVWXYZ · 0123456789

A sky-blue horizon, layered clouds and friendly Wotfard type make deep frontend tutorials feel welcoming and handcrafted.

TYPE SCALE

32px / 16px

2.00× display ratio

RHYTHM

LH 24px

Wt 700 · Track normal

CORNERS

0pxButton
0pxCard
/* Extracted design tokens from joshwcomeau.com via VibeCheck */
:root {
  --color-bg: #a0d4ee;
  --color-surface: #fcfcfc;
  --color-ink: #0a0c10;
  --color-accent: #3b5ccc;
  --color-muted: #243c84;
  --font-display: "Wotfard", system-ui, -apple-system, "PingFang SC", "Noto Sans SC", sans-serif;
  --font-body: "Wotfard", system-ui, -apple-system, "PingFang SC", "Noto Sans SC", sans-serif;
  --text-h1: 32px;
  --text-body: 16px;
  --leading-body: 24px;
  --tracking-display: normal;
  --radius-button: 0px;
  --radius-card: 0px;
  --space-section: 0px;
  --space-card: 0px;
  --shadow-surface: rgba(0, 0, 0, 0.02) 0px -5.9px 2.7px 0px, rgba(0, 0, 0, 0.024) 0px -1.2px 6.9px 0px, rgba(0, 0, 0, 0.03) 0px 8px 14.2px 0px, rgba(0, 0, 0, 0.04) 0px 21.9px 29.2px 0px, rgba(0, 0, 0, 0.07) 0px 49px 80px 0px;

  /* Source custom properties sample */
  --syntax-bg: rgb(232, 241, 252);
  --syntax-fn: rgb(62, 91, 254);
  --top-color: rgb(17, 27, 39);
  --color-info: rgb(68, 51, 255);
  --color-text: rgb(10, 12, 16);
  --dark-color: rgb(0, 43, 255);
  --sp-space-1: 4px;
  --sp-space-2: 8px;
}

Parameters are element samples. Empty values are unknown, and individual samples are not site-wide rules.

Audit findings

Highlight flagship courses alongside free articles

Conversion

Recent blog posts dominate the first scroll while flagship courses sit quietly as a small lowercase nav item.

→ Add a restrained featured-course callout in the sidebar or below the masthead and verify its position on mobile.

desktop.png: courses appears only as a small top nav item

No Content-Security-Policy

Launch

A CSP is the standard way to limit script sources. Vibe-coded pages often load anything, including injected scripts.

→ Start with a report-only CSP, then default-src 'self' and an explicit script-src.

content-security-policy missing

No X-Content-Type-Options

Launch

Without nosniff, browsers may interpret a file as a different type than you sent. It is a one-line header.

→ Set X-Content-Type-Options: nosniff.

x-content-type-options missing

No Referrer-Policy

Launch

The default referrer can leak internal paths and query strings to third parties.

→ Set Referrer-Policy: strict-origin-when-cross-origin.

referrer-policy missing

Copy prompts or rules to your AI Agent

Switch between page fixes, style recreation, DESIGN.md, or a reusable SKILL.md guardrail file.

Paste into Claude Code / Cursor / Codex chatFull Taste Skill guide →
Improve the current project using the 2026-11-11T06:46:41.168Z snapshot of https://www.joshwcomeau.com. First identify changes since capture; do not revert newer behavior to the old snapshot.

Design baseline
An illustrated #a0d4ee sky header with playful utility toggles transitions via layered clouds into a white two-column editorial layout: long-form article previews on the left, topic pills and popular guides on the right.
{
  "colors": [
    {
      "role": "bg",
      "hex": "#a0d4ee"
    },
    {
      "role": "surface",
      "hex": "#fcfcfc"
    },
    {
      "role": "ink",
      "hex": "#0a0c10"
    },
    {
      "role": "accent",
      "hex": "#3b5ccc"
    },
    {
      "role": "muted",
      "hex": "#243c84"
    }
  ],
  "fonts": {
    "body": "Wotfard",
    "display": "Wotfard",
    "stack": [
      "Wotfard"
    ]
  },
  "radius": {
    "button": "0px",
    "card": "0px",
    "field": ""
  },
  "space": {
    "section": "0px",
    "card": "0px"
  },
  "type": {
    "h1": "32px",
    "body": "16px",
    "weight": "700",
    "lineHeight": "24px",
    "letterSpacing": "normal"
  }
}
Values come from one capture. Fonts, radii and spacing are element samples, not a universal site-wide specification. Empty values are unknown. HTML bytes are source size, not compressed transfer size; script counts are DOM tags, not network requests.

Actions
1. Highlight flagship courses alongside free articles
Add a restrained featured-course callout in the sidebar or below the masthead and verify its position on mobile.
Evidence: desktop.png: courses appears only as a small top nav item

2. No Content-Security-Policy
Start with a report-only CSP, then default-src 'self' and an explicit script-src.
Evidence: content-security-policy missing

3. No X-Content-Type-Options
Set X-Content-Type-Options: nosniff.
Evidence: x-content-type-options missing

4. No Referrer-Policy
Set Referrer-Policy: strict-origin-when-cross-origin.
Evidence: referrer-policy missing

Acceptance
- Check text, layout and the main action “courses” at 1440×900 and 390×844.
- Preserve branding, authentication and business behavior. A screenshot does not prove broken interaction.
- Change only evidence-backed issues. Validate security headers against existing resources and authentication in report-only mode where supported.
- Compare before/after screenshots and run relevant functional tests. Do not claim untested behavior passed.
All token kits →