Vignelli Canon Design System

The Vignelli Canon — a working design discipline

Massimo Vignelli (1931–2014), Italian designer mentored by the Castiglioni brothers and Mies van der Rohe ("God is in the details"). With his wife and partner Lella, he designed "from the spoon to the city": the 1972 New York City Subway diagram and signage standards, the American Airlines identity (used ~45 years), Knoll, Bloomingdale's, Heller dinnerware, the National Park Service Unigrid system, and the Grandi Stazioni Italian railway station signage. His book The Vignelli Canon is his own statement of method. This skill is that method, made applyable.

His thesis: Design is one discipline, above any style. Creativity needs the support of knowledge. The rules below are a bag of tools, not a cage.

---

PART ONE — THE INTANGIBLES (decide these before you draw anything)

1. Semantics — search for the meaning first. Research the subject, its history, market, sender and receiver; distill the essence. "Design without semantics is shallow."
2. Syntactics — control the relationships. The grid, typefaces, headline/text/image relationships, page to page. "God is in the details."
3. Pragmatics — it must be understood. It should stand by itself with no explanation. Clarity of intent → clarity of result. "We love complexity but hate complications."
4. Discipline. No sloppiness. "Quality is there or it is not." Self-imposed rules give continuity of intent.
5. Appropriateness. "Listen to what a thing wants to be." The search for the specific of the problem — the right media, material, scale, color.
6. Ambiguity (the good kind). A plurality of meanings, used as a spice.
7. Design Is One. Master one discipline and you can design anything; style is downstream of discipline.
8. Visual Power. Strength through contrast of scale (huge head vs. small body) and weight, never through loudness.
9. Intellectual Elegance. Elegance of the mind, not of manners — the opposite of vulgarity.
10. Timelessness. Prefer primary shapes and primary colors and typography beyond trends. "Clear, simple and enduring."
11. Responsibility. Three levels: to self, to client (economy of means), to the public.
12. Equity. A long-lived mark is collective culture — refine it; don't replace it for the sake of change.

---

PART TWO — THE TANGIBLES (the concrete rules)

The Grid — "organization of information"

• The basic structure: organizes content, gives consistency, projects intellectual elegance.
• "Infinite grids, but just one — the most appropriate — for any problem." Too fine = an empty page; too coarse = restrictive.
• Tight outside margins create tension; wider margins bring serenity. Tight gutters (~one line of type) so type and images snap to the same grid.
• The five grids he specimens: 2×4, 5×4, 3×6, 6×6, 4×8 (columns × modules).
• Paper: prefer the DIN A series (golden-rectangle proportions).

Typography

• The six basic typefaces for a whole career: Garamond (1532), Bodoni (1788), Century Expanded (1900), Futura (1930), Times (1931), Helvetica (1957). Plus Optima, Univers, Caslon, Baskerville. "It is not the type but what you do with it that counts." Helvetica is the house face.
• Type as objective organization, not self-expression. "I don't believe that when you write dog the type should bark." Differentiate with space, weight, alignment — not novelty faces.
• Alignment: flush left by default. Centered only for lapidary text/invitations/addresses. Justified is "fundamentally contrived" — avoid.
• Two type sizes per page, maximum; heading ≈ 2× body (e.g., 10/20). Bold/light/roman/italic sparingly and functionally.
• Size/leading by column width: 8/9, 9/10, 10/11 ≤70mm; 12/13, 14/16 ≤140mm; 16/18, 18/20 larger.
• Rulers: 2pt major, 0.5–1pt minor; type hangs from the ruler.

Scale, Texture, Color

• Scale: the most appropriate size in context — can be pushed deliberately for power. "It doesn't allow mistakes."
• Texture: "Light is the master of form and texture." Shiny reflects, matte absorbs.
• Color as Signifier / Identifier ("Chromotype"), not pictorial. Default to the primary palette: Red, Blue, Yellow. In identity, color IS part of the identity.

White Space — the protagonist

• "It is really the white that makes the black sing." "In a world where everybody screams, silence is noticeable." Don't fill the page.

Layout, Sequence, Identity/Diversity, Economy

• A publication is a cinematic object — design the sequence. "If you see the layout, it is probably a bad layout."
• Balance identity vs. diversity — strong system, room to play. Simple modular ratios (single→double→triple). Standardization is an ethic; "good design doesn't cost more than bad design."

---

TRANSIT & WAYFINDING (Subway + Grandi Stazioni)

• Route / line diagram: 45° and 90° only; evenly spaced station dots regardless of true geography; each line a single color; solid dot = always stops, hollow ring = sometimes/passes; trunk lines share a color; land/water as flat neutral fields; Helvetica throughout.
• Station signage (Grandi Stazioni): white Helvetica on a signal-blue panel, flush left; a hierarchy by cap height — station identification (largest, internally lit), directional (overhead, arrow sharing the cap box), information/regulatory (smaller, hanging from a 2pt rule); platform numbers in a square flag, double-sided. Arrows and pictograms share the type's cap box.
• Pictograms: geometric, primary-shape based, consistent stroke and cap box; meaning over illustration.

---

HOW TO APPLY (workflow)

1. Intangibles pass: one line each for semantics, appropriateness, and the timelessness/equity stance.
2. Pick the system: one grid, Helvetica, two sizes (body + ~2× heading), one primary identifier color.
3. Generate tokens with vignelli_system.py.
4. Compose flush-left on the grid; let white space carry hierarchy; rulers + weight for distinction; scale contrast for power.
5. Self-critique: more than two sizes? justified text? decorative color? visible/cluttered layout? novelty face? Cut it.

Helper script vignelli_system.py

Deterministic, no network/credentials. python3 vignelli_system.py → CSS tokens (palette, two-size scale, the five grids, ruler weights). --primary "#RRGGBB", --base 16, --format css|scss|json, --grid 4x8, --signage (railway panel/cap-height table). The CSS --v-face lists "Liberation Sans" before the generic fallback so headless renders keep a real grotesque (see Production notes).

Canon palette (color as identifier)

Vignelli vermilion #F04E23 · Signal blue #0039A6 · Signal yellow #FFCC00 · Ink #0A0A0A · Warm paper #F4F1EA · White #FFFFFF.

---

PRODUCTION — bringing the system into images & the real world

Hard-won from shipping the VECTOR Northeast-rail sizzle.

Type fidelity when rasterizing (the #1 trap)

Helvetica is not installed in most headless environments. Rasterizing SVG/HTML (cairosvg, headless-Chromium screenshots) with a Helvetica/Arial/sans-serif stack silently falls back to Noto Sans — a rounded humanist face that reads like Calibri and breaks the grotesque. The failure is invisible until someone asks "why does this look like Calibri?"

• Fix: render in a true Helvetica/Arial-metric grotesque — Liberation Sans (usually installed; verify fc-match "Liberation Sans:bold") or an embedded Helvetica/Arimo TTF in ~/.fonts + fc-cache.
• fc-match Helvetica reveals the fallback. Always eyeball one render before trusting it.

The code → image → (optional) reality pipeline

1. Draw the type/diagram in code first, in the correct grotesque — the source of truth.
2. Place it into the world with GPT Image 2 (best legible-text rendering). Pass the crisp artwork as an inputImages reference AND in the prompt name the face and forbid the drift: "Helvetica Bold, Swiss neo-grotesque (Arial Bold / Neue Haas Grotesk); reproduce the artwork letter-for-letter as an applied/printed graphic; NOT Calibri, NOT Noto Sans, NOT a rounded humanist sans."
3. If the reference font is wrong (step 1 trap), the model faithfully reproduces the wrong font — fix the reference before blaming the prompt.

Wayfinding-in-context shot vocabulary

Type on the train flank (wordmark + destination blind); the route diagram on the wall (backlit, traveler in silhouette, golden hour); the paper map in hand by a window; overhead platform directional (white Helvetica on signal blue, drawn arrows); station-ID + square platform flag; concourse pictogram totem. Pair each crisp coded design beside its render — "design in code → reality" is the proof.

Avoid video gen for type-critical heroes

Veo and most video models drift letterforms frame-to-frame — fatal for a sign you must read. When type is the hero, deliver stills (GPT Image 2) or screen-capture an interactive webpage, not generated video.

Packaging

• Build visual-first: cinematic in-situ heroes lead; the system reference (principles, palette, type scale, coded diagram) provides depth below.
• Embedding gotcha: a PublishWebpage artifact runs in a sandboxed iframe that can't authenticate thread-scoped /api/files/... URLs. Run every embedded image through PublishFilePublicly first and use the pub.hyperagent.com share URLs in the HTML.

One-line creed

"I love systems and despise happenstance."

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: maxsoweski
• Source: maxsoweski/claude-design-skills
• License: MIT

Install and usage instructions live in the source repository linked above.