All ArticlesUI Frameworksโ€ขOctober 28, 2026โ€ข5 min read

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.

Designer inspecting geometric curves and typography grid lines

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:

code
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
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
tsx
// 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:

css
/* 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

text
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
0 viewsโ€ข0 comments

Discussion (0)

Join the conversation

Loading comments...

Continue Reading

More production-grade engineering deep dives and architectural guides

Explore all articles