zeke/swiss-design-skillMIT5 files

Swiss Design

Apply a Swiss International Style design system using Tailwind CSS. Use when asked to style a webpage, clean up a UI, apply a design system, make something look great, or when the user references Swiss design, grotesque fonts, Helvetica, grid systems, modernist typography, or 1960s/1950s design aesthetics. Implements IBM Plex Sans typography, stone color palette, opacity-based hierarchy, generous whitespace, and structured grid layouts.

Specification
Skill ID
zeke/swiss-design-skill/swiss-design
Publisher
zeke
Repository
swiss-design-skill
Installs
0
Files
5
License
MIT
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

zeke/swiss-design-skill/swiss-designInstalls these files
  • SKILL.md
  • references/components.md
  • references/design-system.md
  • references/prompting.md
  • references/tailwind-config.md

What this skill tells the agent

Swiss Design System

A design system rooted in the Swiss International Style of the 1950s–60s: grotesque typography, rigorous grid, bold geometric forms, generous whitespace, and restrained color.

Six Principles

  1. Grid first. Every layout lives on a 12-column grid with an 8px base unit.
  2. Mobile first, always. Design for the smallest viewport first, then expand. Every layout must work at 320px and at 1440px. Use sm:, md:, lg: Tailwind prefixes systematically.
  3. Whitespace is structure. Generous padding and margins are not waste — they are the design.
  4. Opacity, not hue, creates hierarchy. Never introduce a second color to indicate text weight or importance. Use opacity.
  5. One accent. Each project gets exactly one accent color, used sparingly at multiple opacities.
  6. Narrow columns. Body text never exceeds max-w-[60ch]. Wider columns hurt legibility.

Typography

Primary font: IBM Plex Sans (Google Fonts)

<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:ital,wght@0,300;0,400;0,500;0,600;1,300;1,400&display=swap" rel="stylesheet">

Fallback chain (in order of preference):

FontSourceCharacter
IBM Plex SansGoogle FontsPrimary. Rational, slightly condensed, 1960s systems rationalism
Hanken GroteskGoogle FontsClosest to Neue Haas Grotesk lineage
BarlowGoogle FontsCondensed Swiss-grid proportions, strong vertical rhythm
Host GroteskGoogle FontsWarm grotesque, good at all sizes
DM SansGoogle FontsClean neo-grotesque fallback
system-uiBuilt-inLast resort
font-family: 'IBM Plex Sans', 'Hanken Grotesk', 'Barlow', 'Host Grotesk', 'DM Sans', system-ui, sans-serif;

Type scale:

RoleTailwindLine heightMax width
Displaytext-7xl font-light tracking-tightleading-noneunconstrained
H1text-5xl font-light tracking-tightleading-tightunconstrained
H2text-3xl font-light tracking-tightleading-snugunconstrained
H3text-xl font-normalleading-snugunconstrained
Bodytext-base font-normalleading-relaxedmax-w-[60ch]
Smalltext-sm font-normalleading-relaxedmax-w-[60ch]
Captiontext-xs font-normal tracking-wide uppercaseleading-normalunconstrained
Monofont-mono text-smleading-relaxedmax-w-[60ch]
  • Headings: font-light (300) or font-normal (400). Never bold for headings.
  • Emphasis within body: font-medium (500). Never font-bold (700).
  • Letter spacing on display/h1: tracking-tight (-0.02em).
  • Captions and labels: tracking-wide uppercase text-xs.

Typographic details

The Swiss style depends on typographic precision. These rules are non-negotiable:

  • Use the ellipsis character …, never three periods ....
  • Use curly quotes " " and ' ', never straight quotes " '.
  • Loading and progress states end with an ellipsis: Loading…, Saving….
  • Number columns and tables use font-variant-numeric: tabular-nums (Tailwind: tabular-nums) so digits align vertically.
  • Headings use text-wrap: balance (Tailwind: text-balance) to prevent widows. Body paragraphs use text-pretty where supported.
  • Non-breaking spaces between value and unit, and inside brand names: 10&nbsp;MB, ⌘&nbsp;K.

Color System

Stone palette (light mode → dark mode)

RoleLightDarkTailwind
Page backgroundstone-50stone-950bg-stone-50 dark:bg-stone-950
Surface / cardstone-100stone-900bg-stone-100 dark:bg-stone-900
Subtle surfacestone-200stone-800bg-stone-200 dark:bg-stone-800
Borderstone-200stone-800border-stone-200 dark:border-stone-800
Subtle borderstone-100stone-900border-stone-100 dark:border-stone-900
Primary textstone-900stone-50text-stone-900 dark:text-stone-50
Secondary textstone-900/70stone-50/70text-stone-900/70 dark:text-stone-50/70
Tertiary textstone-900/40stone-50/40text-stone-900/40 dark:text-stone-50/40
Placeholderstone-900/30stone-50/30text-stone-900/30 dark:text-stone-50/30

Opacity hierarchy (the core rule)

To make text less dominant, reduce opacity — never change the hue.

Full presence:   text-stone-900          (primary)
Softer:          text-stone-900/70       (secondary, labels)
Quiet:           text-stone-900/40       (tertiary, captions)
Ghosted:         text-stone-900/20       (disabled, placeholder)

Dark mode: replace stone-900 with stone-50. The opacity values stay identical.

Accent color

Each project uses one accent color. Default is Swiss poster red.

NameHexTailwind arbitrary
Swiss Red (default)#C8102E[#C8102E]
Cobalt#003B8E[#003B8E]
Golden#F0B429[#F0B429]
Forest#2D6A4F[#2D6A4F]

Use accent at these opacities only:

Full:    bg-[#C8102E]          text-[#C8102E]
Muted:   bg-[#C8102E]/60       text-[#C8102E]/60
Subtle:  bg-[#C8102E]/20       (backgrounds, tints)
Ghost:   bg-[#C8102E]/10       (very light tints)

Spacing & Grid

Base unit: 8px. All spacing is a multiple of 8.

TokenValueUsage
gap-28pxTight inline gaps
gap-416pxComponent internal
gap-832pxBetween components
gap-1664pxBetween sections
py-1664pxSection padding (minimum)
py-2496pxSection padding (standard)
py-32128pxSection padding (generous)

Grid:

<!-- 12-column grid — always mobile-first, columns collapse to full-width on small screens -->
<div class="grid grid-cols-12 gap-4 md:gap-8">
  <div class="col-span-12 md:col-span-8">...</div>
  <div class="col-span-12 md:col-span-4">...</div>
</div>

Max content width: max-w-5xl or max-w-6xl with mx-auto px-4 md:px-8.


Responsive Design

The Swiss grid adapts fluidly across viewports. Every layout decision must be made at two scales: mobile (single column, generous vertical rhythm) and desktop (multi-column, horizontal tension).

Breakpoint strategy:

PrefixWidthUse for
(none)0px+Mobile — single column, full width
sm:640px+Large phones, small tablets
md:768px+Tablets, narrow desktop — introduce 2-col layouts
lg:1024px+Desktop — full 12-col grid, max content width

Mobile layout rules:

  • All grid columns collapse to col-span-12
  • Section padding reduces: py-16 md:py-24 lg:py-32
  • Horizontal padding tightens: px-4 md:px-8
  • Display type scales down: text-5xl md:text-7xl lg:text-8xl
  • Multi-column nav collapses to hamburger or hidden
  • Tables scroll horizontally: wrap in overflow-x-auto
  • Side-by-side cards stack vertically: grid-cols-1 md:grid-cols-2 lg:grid-cols-3

Fluid type pattern:

<!-- Scale display type fluidly across viewports -->
<h1 class="text-4xl sm:text-5xl md:text-6xl lg:text-7xl font-normal tracking-tight leading-none">
  Swiss International Style
</h1>

<!-- Or use clamp() for truly fluid scaling -->
<h1 class="text-[clamp(2rem,6vw,5rem)] font-normal tracking-tight leading-none">
  Swiss International Style
</h1>

Responsive section pattern:

<section class="py-16 md:py-24 lg:py-32 border-b border-stone-200 dark:border-stone-800">
  <div class="max-w-6xl mx-auto px-4 md:px-8">
    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-8">
      ...
    </div>
  </div>
</section>

Use this skill in a project

Open any RiverX project, search the Skills panel for zeke/swiss-design-skill/swiss-design, and install it in one click.

Use this skill