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.
Words
1011
Action candidates
11
Links
59/9
HTML
116 KB

joshwcomeau.com
Josh W. Comeau
Friendly articles and tutorials for front-end web developers. ❤️
Keeping #a0d4ee sky illustration in the masthead while switching the article body to clean dark-on-white preserves effortless reading.
Explicit controls to disable sound effects and toggle dark mode treat delight as opt-in rather than forced.
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.
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
/* 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.
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 itemA 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 missingWithout 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 missingThe default referrer can leak internal paths and query strings to third parties.
→ Set Referrer-Policy: strict-origin-when-cross-origin.
referrer-policy missingSwitch between page fixes, style recreation, DESIGN.md, or a reusable SKILL.md guardrail file.
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.A blue light field frames a dark composer, followed by output types and import sources in three clear levels.
A curved character raster and monospace text establish an experimental-lab identity, with sign-up, login and exploration grouped centrally.
A nocturnal game scene, colorful app icons and a casual voice foreground the personality of an independent creator.
It reads like a carefully written note, relying on language rather than decoration to establish a knowledge community.