Original illustrative specimen, generated from this entry’s specification. Not a photograph and not a third-party asset.
Definition
Signals that a person made this — variable hand-drawn strokes, material texture, slight rotations, and unpolished imagery set against otherwise disciplined structure.
Classification
Tagshandmade · texture · imperfection
Aliaseshand-drawn, wabi-sabi, human touch, organic, craft
Specimen
OriginOriginal illustrative demonstration, rendered in HTML and CSS from this entry’s specification. Not a photograph and not a third-party asset.
Core principles
Imperfection is evidence, not error.
Irregularity signals that a person made specific decisions.
The hand must be real.
Variable stroke width, genuine texture, and true photographic grain cannot be simulated by uniform CSS shapes.
Restraint in the deviation.
Small rotations and offsets read as placement; large ones read as breakage.
Reference material
Agent prompt
Applying a Handcrafted visual direction
You are being asked to apply a Handcrafted visual direction to a web interface. This document gives you framing and recommendations for that direction. It does not tell you what page, product, or feature to build — apply the guidance below to whatever interface you are already working on, at whatever scope that work requires.
What “Handcrafted” means here
This direction adds evidence of a human hand to an otherwise ordinary interface. An underline that wobbles and changes thickness. An arrow drawn rather than drawn from an icon set. Paper or ink texture behind the content. A photograph that looks taken rather than art-directed. Something rotated by a degree or two, as though placed by hand rather than positioned by a layout engine.
The purpose is warmth and specificity — the sense that a particular person made this, in a landscape of interfaces that all look machine-assembled. The underlying philosophy is the one that treats imperfection as evidence of authorship rather than as a defect.
The distinction the whole style depends on is between human and careless, and they are easy to confuse. The rule that keeps them apart is simple: imperfection belongs to the surface, never to the mechanism. Textures, strokes, crops, and slight rotations are the surface. Buttons, form fields, focus indicators, and hit areas are the mechanism, and they stay exactly as regular and predictable as they would be in any other interface. A wobbly underline is charming; a button you cannot reliably hit is a defect wearing a charming coat.
Recommendations
- Introduce at least one genuinely hand-drawn stroke — an underline, a circle around a word, an arrow, a bracket. It must have variable thickness along its length. A one-pixel CSS border curved with a radius does not read as handmade.
- Put a material texture behind the content: paper grain, ink bleed, fabric weave. It should be visible at normal viewing size, not a texture that only exists at 400% zoom.
- Rotate one or two elements by a small amount — half a degree to three degrees — or offset them from the grid by a few pixels. Beyond that it stops reading as hand-placed and starts reading as broken.
- Let photography be unpolished: real grain, an imperfect crop, an off-center subject. Studio-corrected imagery contradicts everything else on the page.
- Add exactly one handwritten or irregular typeface, and use it only for accents — a callout, a signature, a label. Never for body copy, which it makes slower to read for everyone and much harder for some.
- Keep every interactive element rigorously regular: rectangular hit areas of at least forty-four by forty-four pixels, with a clearly visible focus indicator. This is not a compromise with the style; it is what makes the style trustworthy.
- Check text contrast against the texture, at its darkest point and its lightest. Texture is exactly the kind of variable background that quietly breaks legibility.
Avoid
- Rotations or offsets large enough to read as a layout bug.
- Handwritten typefaces used for body copy or for anything a reader must parse quickly.
- Irregular, rotated, or oddly shaped interactive controls and hit areas.
- Texture applied so heavily that text sits on unpredictable ground.
- Generic stock illustration standing in for hand-drawn marks; the wobble has to be real.
- Removing or weakening focus indicators because they look too mechanical against the rest.
How to check your own work
Before considering the result finished, look at it and ask:
- Does any hand-drawn element have genuinely variable stroke width? If every line is uniform, it is CSS pretending to be a hand.
- Are the interactive elements perfectly regular? Every rotation, irregular edge, or unpredictable hit area on a control is the style leaking into the mechanism, and it needs to be pulled back.
- Tab through the page. Is the focus indicator obvious at every stop, against the texture?
- Take the smallest text over the busiest part of the texture and measure its contrast at the worst pixel.
- Would a stranger describe this as “made by someone” or as “slightly broken”? If there is any doubt, reduce the rotations and keep the strokes.
Specification
Handcrafted — Specification
Definition
Handcrafted is a web-interface design style that adds visible evidence of human authorship to an otherwise disciplined interface: strokes of variable thickness, material texture, small deliberate rotations, and unpolished imagery. Its defining constraint is that imperfection is confined to the surface. Interactive mechanisms — controls, hit areas, focus indicators — remain fully regular, which is what separates the style from carelessness.
Core principles
- Imperfection is evidence, not error. Irregularity signals that a person made specific decisions.
- The hand must be real. Variable stroke width, genuine texture, and true photographic grain cannot be simulated by uniform CSS shapes.
- Restraint in the deviation. Small rotations and offsets read as placement; large ones read as breakage.
- The mechanism stays regular. Controls, targets, and focus indicators are unaffected by the style.
- Warmth never costs legibility. Text over texture is verified at the worst point, not the average.
Visual characteristics
- Hand-drawn underlines, arrows, circles, or brackets with varying stroke thickness.
- Paper, ink, or fabric texture visible behind the content at normal viewing size.
- One or two elements rotated slightly or offset from the grid.
- Photography with real grain and imperfect, off-center cropping.
- A single handwritten or irregular typeface used only for accents.
- Regular, rectangular interactive controls with clear focus states.
Rules
-
Genuine hand-drawn stroke. At least one mark shows a real hand. Acceptance criterion: At least one underline, arrow, or frame has measurably variable stroke width along its length; a uniform CSS border does not satisfy this.
-
Material texture. The ground is a material rather than a fill. Acceptance criterion: The primary background region carries a texture that is discernible at 100% zoom.
-
Restrained deviation. Placement reads as manual, not broken. Acceptance criterion: At least two elements have a rotation between 0.5° and 3°, or an offset from the grid between 2px and 8px.
-
Unpolished imagery. Photography is captured rather than corrected. Acceptance criterion: Content photographs retain visible grain or an irregular crop and are not fitted to a perfect geometric frame.
-
One handwritten counterpoint. Irregular type is an accent only. Acceptance criterion: Exactly one handwritten or irregular family is present, and it appears only in accent positions, never in body copy.
-
Imperfection never reaches the mechanism. Controls remain fully regular. Acceptance criterion: Every interactive target is a regular rectangle of at least 44 × 44px with a visible focus indicator, carrying no rotation or irregular edge.
-
Legibility over texture. Text is verified against the real background. Acceptance criterion: Every text element measures at least 4.5:1 against both the lightest and the darkest point of the texture beneath it.
Avoid
- Rotations or offsets large enough to read as a layout defect.
- Handwritten typefaces used for body copy or for anything requiring fast parsing.
- Rotated, irregular, or unpredictably shaped interactive controls.
- Texture heavy enough that text sits on unpredictable ground.
- Generic stock illustration substituting for genuine hand-drawn marks.
- Focus indicators removed or weakened because they look mechanical.
Acceptance criteria
- Rule 1: At least one mark has genuinely variable stroke width.
- Rule 2: A texture is discernible behind the content at 100% zoom.
- Rule 3: Two or more elements carry a 0.5–3° rotation or a 2–8px offset.
- Rule 4: Content photography retains grain or an irregular crop.
- Rule 5: Exactly one handwritten family is present, used only for accents.
- Rule 6: All interactive targets are regular rectangles of 44 × 44px or larger with visible focus.
- Rule 7: All text meets 4.5:1 against the texture’s lightest and darkest points.
Blocking failures
- An interactive control is rotated, irregularly shaped, or has an unpredictable hit area, so the style’s decorative logic has been applied to a mechanism that people must be able to operate reliably.
- A focus indicator has been removed, weakened, or rendered invisible against the texture, making the interface unusable by keyboard.
- Body copy is set in a handwritten or irregular face, which slows reading for everyone and prevents it for some readers.
These conditions make the work unacceptable to ship; they are not stylistic suggestions and are not subject to designer discretion.
Responsive adaptation guidance
- Texture (Rule 2) may reduce in scale or intensity at narrow viewports, but Rule 7 is re-measured afterward, since a compressed texture changes the pixels beneath any given text block.
- Rotations and offsets (Rule 3) reduce toward the lower bound at narrow widths, where a 3° rotation is far more likely to cause overlap or clipping than it is at desktop width.
- Hand-drawn marks are re-drawn or cropped rather than scaled non-uniformly, since stretching a stroke destroys the variable-width quality Rule 1 requires.
- Rule 6 strengthens rather than relaxes at narrow viewports: the 44 × 44px minimum is a floor for touch input, not a desktop convenience, and it applies at every breakpoint without exception.