9. Josh Puckett (@joshpuckett): The Interface Craft Manifesto
Josh Puckett's interface craft manifesto: Why AI models struggle with human visual taste, optical compensation vs mathematical centering, and 1px tactile bevel highlights.

9. Josh Puckett (@joshpuckett): The Interface Craft Manifesto
"I gave frontier models the full launch context and prompts... everyone viewing this would agree that this is far from amazing design. They are certainly getting more capable, but they are a far cry from being at the level of human competence and taste."
โ Josh Puckett, Design Engineer & Interface Designer
๐ก The Core Thesis
Josh Puckett is one of the most vocal champions of tactile interface craft in the tech ecosystem. As AI code generators produce endless streams of homogenized, Tailwind-styled landing pages, Puckett provides the vital counterweight: pointing out the subtleties that separate generic web layouts from extraordinary digital products.
His thesis is that AI models do not possess physical eyes or human spatial instincts. They know that buttons usually have padding and borders, but they do not understand:
- The optical weight of negative space versus mathematical margin values.
- How subtle contrast steps guide user attention without visual cacophony.
- Why tactile micro-details (hairline 1px inner highlights, sub-pixel glyph alignment) communicate trustworthiness.
๐ ๏ธ Key Architectural Patterns
1. Optical Alignment vs. Mathematical Centering
Computers align elements mathematically based on bounding boxes. Human perception, however, evaluates visual center of mass:
Mathematical Centering (Looks off-center to human eye):
โโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โถ Play Icon โ <-- Arrow icon center is mathematically at 50%,
โโโโโโโโโโโโโโโโโโโโโโโโโโ but heavy left base makes it feel shifted left!
Optical Compensation (Felt Centering):
โโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โถ Play Icon โ <-- Shifted +1.5px to +2px right along X-axis
โโโโโโโโโโโโโโโโโโโโโโโโโโ// Example: Optically compensated play button icon wrapper
export function PlayButton() {
return (
<button className="relative flex h-12 w-12 items-center justify-center rounded-full bg-white text-black shadow-md hover:scale-105 transition-transform">
{/* translate-x-[1.5px] corrects optical left-weighting of triangular glyph */}
<svg className="h-5 w-5 translate-x-[1.5px]" fill="currentColor" viewBox="0 0 24 24">
<path d="M8 5v14l11-7z" />
</svg>
</button>
);
}2. The 1px Inner Bevel Highlight
To give flat dark mode cards tangible physical depth, Puckett applies an inner ambient highlight that mimics an overhead light source catching the edge of a bevel:
/* Premium dark-mode card with physical light bevel */
.tactile-card {
background: #121214;
border: 1px solid rgba(255, 255, 255, 0.08);
/* Top inner highlight mimics overhead ambient light refraction */
box-shadow:
inset 0 1px 0 0 rgba(255, 255, 255, 0.12),
0 10px 20px -5px rgba(0, 0, 0, 0.5);
}๐งต Ready-to-Post Tweet Thread
1/4 ๐ Why @joshpuckett's critique of AI design is so critical right now:
AI can generate 100 variations of a dashboard in 5 seconds. But almost all of them feel hollow, generic, and unrefined.
2/4 The missing ingredient? Optical human craft.
Mathematical centering isn't visual centering. A play button aligned to the exact center of a circle always looks shifted left because the visual mass is distributed unevenly.
3/4 Subtle depth cues matter:
A 1px inset border highlight catching light on the top edge of a dark card creates tactile presence that flat, uninspired templates miss completely.
4/4 Follow @joshpuckett for masterclasses on interface breakdowns, spatial nuance, and maintaining human craft in an automated world.๐ How to Follow & Stay Current
- X Handle: @joshpuckett
- Key Themes: Interface Design, Craft, Typography, Optical Alignment, Micro-details.
- Top Hashtags:
#DesignEngineering#UI#Craft#ProductDesign
Discussion (0)
Continue Reading
More production-grade engineering deep dives and architectural guides
Biggest Hack in the World: Binance Suffers Unprecedented $6.3 Billion Multi-Chain Cyberattack
A comprehensive technical autopsy of the $6.3B Binance hot-wallet breach attributed to TraderTraitor (Lazarus Group). How automated sweeping, compromised DevOps credentials, and cross-chain execution sparked the largest heist in financial history.

Mobile Push at 100M Devices: Benchmarking FCM, APNs, and Custom WebSockets
At 100M devices, push fails in the tail, not the median. We break down real delivery-latency percentiles for APNs, FCM, and owned WebSockets, plus a reproducible cost model and the reliability patterns behind 99.99%.

Landing Page Experimentation at 50M Sessions: Client-Side A/B Testing vs. Edge Decisioning vs. Server-Side Flags โ Flicker, INP, and Cost per Million Decisions Benchmarked
At 50 million monthly sessions, where your A/B test makes its decision stops being a tooling preference and becomes a Core Web Vitals and P&L decision. This is a head-to-head benchmark of client-side DOM mutation, edge middleware bucketing, and server-side feature flags โ measured on CLS flicker, INP, and true cost per million decisions.